سيساعدك هذا الدليل في إعداد تكامل webhook لإرسال تنبيهات من Dotcom-Monitor إلى تذاكر Jira الخاصة بك. تستفيد Dotcom-Monitor من طريقة تسليم تنبيه HTTP Webhook لتوصيل نظام تنبيه Dotcom-Monitor وتذاكر Jira عبر طلبات webhook. لإعداد التكامل ، تأكد من أن لديك الأذونات اللازمة لإنشاء مشكلات في مشروع Jira الخاص بك.

إعداد التكامل

إنشاء رمز Jira API:

  1. يرجى زيارة صفحة المصادقة الأساسية لواجهات برمجة تطبيقات REST في مدخل مطور Atlassian لمعرفة كيفية إنشاء رمز مميز لواجهة برمجة التطبيقات وإعداد المصادقة الأساسية باستخدام Jira.
  2. احفظ الرمز المميز لواجهة برمجة التطبيقات الذي تم إنشاؤه لاستخدامه في رأس التفويض في Dotcom-Monitor.

تكوين خطاف الويب في Dotcom-Monitor

عند استخدام طلبات واجهة برمجة التطبيقات، خاصة مع رؤوس المصادقة، تتطلب JIRA أحيانا رأسا إضافيا لتجاوز حماية CSRF. لمعالجة هذا الأمر ، قم بتضمين رأس X-Atlassian-Token مع القيمة no-check في طلب webhook الخاص بك.

  1. قم بتسجيل الدخول إلى حساب Dotcom-Monitor الخاص بك وانتقل إلى تكوين مجموعات عناوين التسليم (إدارة > مجموعة عناوين التسليم).
  2. إنشاء مجموعة جديدة أو فتح مجموعة موجودة للتحرير. أضف webhook كعنوان التسليم. يرجى زيارة مقالة تكامل HTTP Webhook لمعرفة كيفية إرسال رسائل تنبيه Dotcom-Monitor إلى عنوان URL مخصص لخطاف الويب.
  3. في الحقل عنوان URL لخطاف الويب، أدخل: https://your-domain.atlassian.net/rest/api/3/issue
  4. اضبط نوع الطلب على POST.
  5. اترك قسم المصادقة فارغا.
  6. في قسم الرؤوس ، أضف الرؤوس التالية. تأكد من ترميز BASE64 لسلسلة useremail: api_token :
    • التفويض: Basic [useremail:api_token]
    • نوع المحتوى: application/json
    • X-Atlassian-Token: no-check
  7. في حقل الحمولة ، أدخل بنية بيانات JSON التي سيتم إرسالها إلى Jira. فيما يلي مثال على الحمولة: 
    @{
string _text = "";
foreach (var sessionResponse in Model.SessionResponses)
{
    foreach (var response in sessionResponse.Children)
    {
        _text += "Task Type: " + response.Task.TaskType_Name + ", " +
                 "Details Url: " + Model.DMUserLink + "/client/response-details/hit?id=" + response.ID + "&rootId=" + Model.RootResponse.ID + "&cuid=" + Model.OnlineReportCUID + ", " +
                 "View Task Url: " + Model.DMUserLink + "/v2/EditLegacyTask/" + response.Device.ID + "/" + response.Task.ID + ", " +
                 "Task Name: " + response.Name + ", " +
                 "Target: " + response.Target + ", ";

        if (response.AllErrors != null)
        {
            foreach (var error in response.AllErrors)
            {
                _text += error.ErrorType + " (" + error.ErrorCode + ") " + error.Reason;
            }
        }
    }
}
}
{
  "fields": {
    "project": {
      "key": "JIRA_PROJECT_KEY"
    },
    "summary": "Alert from Dotcom-Monitor",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "text":"@_text",
              "type": "text"
            }
          ]
        }
      ]
    },
    "issuetype": {
      "name": "Task"
    },
    "components": [
      {
        "name": "Default Component"
      }
    ]
  }
}
  8. استبدل "PROJECT_KEY" بمفتاح مشروع Jira الخاص بك.

اختبار خطاف الويب

بمجرد تكوين تكامل webhook ، نوصي باختبار جهاز المراقبة الخاص بك عن طريق إرسال تنبيه اختبار:

  1. في قائمة الأجهزة، مرر مؤشر الماوس فوق جهاز المراقبة الذي تريد اختباره.
  2. انقر فوق القائمة خيارات (⋮) > إرسال تنبيه > الاختبار لأسفل.
  3. تحقق من مشروع Jira الخاص بك لمعرفة ما إذا كان التنبيه قد أنشأ تذكرة جديدة.

استخدام المتغيرات الديناميكية في قالب التنبيه

إذا كنت بحاجة إلى تضمين متغيرات Dotcom-Monitor الديناميكية في حمولة JSON الخاصة بك ، فيرجى مراجعة مقالة إضافة المتغيرات الديناميكية إلى قالب التنبيه . إذا واجهت أي مشاكل أو كانت لديك متطلبات محددة ، فيرجى التواصل مع دعم Dotcom-Monitor للحصول على مزيد من المساعدة.