সার্ভিসনাউ: XOps গল্পগুলির সাথে ইন্টিগ্রেশন কনফিগার করা হচ্ছে

সারসংক্ষেপ

XOps গল্প এবং একটি বাহ্যিক সার্ভিস ব্যবস্থাপনা প্ল্যাটফর্মের মধ্যে দ্বি-মুখী সিঙ্ক্রোনাইজেশন সমর্থন করে। এই ইন্টিগ্রেশন ক্রিয়াকলাপের তদন্তকে প্ল্যাটফর্মগুলির মধ্যে সমন্বিত রাখতে সাহায্য করে, যাতে এক প্ল্যাটফর্মে করা আপডেটগুলি অন্য প্ল্যাটফর্মে প্রতিফলিত হয়।

আরও তথ্যের জন্য, দেখুন সার্ভিস ব্যবস্থাপনা প্ল্যাটফর্মের সাথে দ্বি-মুখী ইন্টিগ্রেশন তৈরি করা

সার্ভিসনাউ ইন্টিগ্রেশন কনফিগার করা হচ্ছে

সার্ভিসনাউ ইন্টিগ্রেশন কনফিগার করতে, এই পাঁচটি ধাপ সম্পন্ন করুন।

ধাপ ১: কাস্টম ক্ষেত্র তৈরি করুন

Cato ম্যানেজমেন্ট অ্যাপ্লিকেশনে যখন একটি টিকেট তৈরি হবে তখন পূরণ হওয়ার জন্য ক্ষেত্রগুলি তৈরি করুন।

কাস্টম ক্ষেত্র তৈরি করতে:

  1. সার্ভিসনাউ প্ল্যাটফর্মে লগ ইন করুন।
  2. যেকোনো ইনসিডেন্ট খুলুন।
  3. উপরের ব্যানার থেকে, ডান ক্লিক করে কনফিগার > ফর্ম বিল্ডার এ যান।
  4. যদি প্রয়োজন হয়, ফর্ম বিল্ডার চেষ্টা করার জন্য সম্মতি দিন এবং ডিফল্ট দৃশ্য নির্বাচন করুন।
  5. ইনসিডেন্ট টেবিলে একটি নতুন ক্ষেত্র যোগ করুন এ ক্লিক করুন।
  6. এই ক্ষেত্রগুলি যোগ করুন:

    • CMA অ্যাকাউন্ট আইডি

      • টাইপ: পূর্ণসংখ্যা
      • বৈশিষ্ট্য: শুধুমাত্র পড়া, বাধ্যতামূলক, সক্রিয়
    • CMA গল্পের আইডি

      • টাইপ: স্ট্রিং
      • বৈশিষ্ট্য: শুধুমাত্র পড়া, বাধ্যতামূলক, সক্রিয়

ধাপ 2: CMA-তে একটি সার্ভিস API কী তৈরি করুন

সার্ভিস API কীগুলি বাহ্যিক সরঞ্জাম এবং সেবাসমূহের সাথে স্কেলেবল ইন্টিগ্রেশন সক্রিয় করে এবং এই ফর্ম্যাটে তৈরি করা হয়: R=<...>|K=<...>. আরও তথ্য এবং একটি সার্ভিস API কী তৈরি করার বিশদ তথ্যের জন্য, দেখুন Cato API-এর জন্য API কীগুলি তৈরি করা

আপনি যখন সার্ভিস API কী তৈরি করে ফেলবেন, তখন সেটিকে কপি এবং সংরক্ষণ করুন যেন সেটি সার্ভিসনাউ প্ল্যাটফর্মে প্রবেশ করা যায়।

ধাপ 3: API কী নিরাপদভাবে একটি নিরাপদ সিস্টেম প্রোপার্টিতে সংরক্ষণ করুন

সার্ভিসনাউ প্ল্যাটফর্মে, API কী সংরক্ষণের জন্য একটি নিরাপদ সিস্টেম প্রোপার্টি তৈরি করুন।

নিরাপদ সিস্টেম প্রোপার্টি তৈরি করতে:

  1. https://<your instance>.service-now.com/sys_properties_list.do এ যান
  2. নতুন এ ক্লিক করুন।
  3. সিস্টেম প্রোপার্টি নতুন রেকর্ড ফর্মে, এই বিস্তারিত যোগ করুন:

    SN5.png
    • নাম: cma_prod_api_key
    • টাইপ: পাসওয়ার্ড2
    • মান্যতা: সার্ভিস API কী আপনি ধাপ 2 এ তৈরি করেছেন
  4. জমা দিন এ ক্লিক করুন।

ধাপ 4: একটি REST মেসেজ তৈরি করুন

সার্ভিসনাউ ইনসিডেন্ট থেকে বিবরণ Cato-তে পাঠানোর জন্য একটি REST মেসেজ তৈরি করুন:

একটি REST মেসেজ তৈরি করতে:

  1. আপনার সার্ভিসনাউ প্ল্যাটফর্মে সব > সিস্টেম ওয়েব সেবাসমূহ > বহির্গামী > REST মেসেজ এ যান।
  2. নতুন এ ক্লিক করুন।
  3. REST মেসেজ ফর্মে, এই বিস্তারিত যোগ করুন:

    • নাম: REST মেসেজের জন্য একটি নাম যোগ করুন
    • এন্ডপয়েন্ট: https://<your Cato account name>.cc.catonetworks.com/api/v1/graphql2
    • প্রমাণীকরণ ধরনের: কোনো প্রমাণীকরণ নয়
    • HTTP পদ্ধতি: নতুন এ ক্লিক করুন এবং এই বিস্তারিত যোগ করুন:

      • নাম: একটি নাম যোগ করুন
      • HTTP পদ্ধতি: POST
      • এন্ডপয়েন্ট: https://<your Cato account name>.cc.catonetworks.com/api/v1/graphql2
  4. জমা দিন এ ক্লিক করুন।

ধাপ 5: একটি ব্যবসায়িক নিয়ম তৈরি করুন

REST মেসেজ ট্রিগার করতে একটি ব্যবসায়িক নিয়ম তৈরি করুন।

একটি ব্যবসায়িক নিয়ম তৈরি করার জন্য:

  1. আপনার সার্ভিসনাউ প্ল্যাটফর্মে সব > সিস্টেম সংজ্ঞা > ব্যবসায়িক নিয়ম এ যান।
  2. নতুন এ ক্লিক করুন।
  3. ব্যবসায়িক নিয়ম নতুন রেকর্ড ফর্মে, এই বিস্তারিত যোগ করুন:

    SN6.png
    • নাম: ব্যবসায়িক নিয়মের জন্য একটি নাম যোগ করুন
    • টেবিল: ইনসিডেন্ট
    • যখন: পরে
    • আপডেট: সত্য (চেকবক্সটি চেক করুন)
    • ফিল্টার শর্ত: মন্তব্য পরিবর্তন
  4. উন্নত ট্যাবে এই স্ক্রিপ্ট যোগ করুন:

    (current, previous) রুল কার্যকর করবেন (function {
      try {
        var lastComment = current.comments.getJournalEntry(1) || '';
        lastComment = stripJournalHeader(lastComment);
        if (!lastComment) {
          gs.info("GraphQL webhook: Empty comment, skipping " + current.number);
          return;
        }
        var accountId = current.u_cma_account_id;
        var storyId = current.u_cma_story_id;
            gs.info("GraphQL webhook: accountId " + accountId + " story " + storyId);
        if (!accountId || !storyId) {
          gs.error("GraphQL webhook: Missing accountId/storyId for " + current.number);
          return;
        }
        var gqlQuery =
          "mutation CreateStoryComment($accountId: ID!, $input: AddStoryCommentInput!) {" +
          "  xdr(accountId: $accountId) {" +
          "    addStoryComment(input: $input) {" +
          "      comment { id type __typename }" +
          "      __typename" +
          "    }" +
          "    __typename" +
          "  }" +
          "}";
        var body = {
          query: gqlQuery,
          variables: {
            accountId: accountId.toString(),
            input: {
              type: "USER",
              storyId: storyId.toString(),
              text: lastComment
            }
          }
        };
            var apiKey = gs.getProperty('cma_prod_api_key');
        var r = new sn_ws.RESTMessageV2('Update XDR story comments CMA Prod', 'post');
        r.setRequestHeader('Content-Type', 'application/json');
        r.setRequestHeader('Accept', 'application/json');
            r.setRequestHeader('x-api-key', apiKey);
        r.setRequestBody(JSON.stringify(body));
        //var response = r.execute(); // can be changed to Async - only for debug purposes
            var eccSysId = r.executeAsync();
        gs.info("GraphQL webhook queued, ECC sys_id=" + eccSysId);
        var status = response.getStatusCode();
        var responseBody = response.getBody();
      // Safe logging (see next section for masking)
         gs.info("GraphQL webhook: status=" + status);
         gs.info("GraphQL webhook: responseBody=" + responseBody);
      } catch (ex) {
        gs.info("GraphQL webhook: Failed: " + ex.message);
      }
      function stripJournalHeader(text) {
        text = text || '';
        if (text.indexOf('\n') > -1) {
          return text.split('\n').slice(1).join('\n').trim();
        }
        return text.trim();
      }
    })(current, previous);
  5. জমা দিন এ ক্লিক করুন।

সমস্যা সমাধান

আপনি বা: এ ত্রুটি এবং সমস্যাগুলি সনাক্ত করতে পারেন।

  • সিস্টেম লগ: সিস্টেম লগ > সব এ যান এবং GraphQL webhook ধারণকারী মেসেজের জন্য অনুসন্ধান করুন।
  • ECC রেকর্ড: https://<instance>.service-now.com/sys_ecc_queue_list.do এ যান এবং লগ করা ECC sys_id এর সাথে ECC রেকর্ড খুঁজে বের করুন।

প্রচারিত সমস্যা

এগুলি সাধারণ সমস্যার তালিকা এবং তাদের কারণ:

সমস্যা কারণ
মন্তব্য পাঠানো হয়নি মন্তব্যের পাঠ্য খালি
অ্যাকাউন্ট/গল্প আইডি অনুপস্থিত কাস্টম ক্ষেত্রগুলি পূরণ হয়নি
API 400 ফেরায় অসঠিক অনুরোধ ফর্ম্যাট
API 401 ফেরায় অবৈধ API কী

এই নিবন্ধটি কি সহায়ক ছিল?

0 জনের মধ্যে 0 জন এটিকে সহায়ক বলে মনে করেছেন

0 মন্তব্য