Skip To Content

خُطافات الويب (Webhooks) في ArcGIS Enterprise

خطافات الويب هي إمكانية ArcGIS Enterprise توفر معلومات تستند إلى الحدث بشكل تلقائي إلى أجهزة استقبال خطاف الويب أو غيرها من التطبيقات. ويدعم ArcGIS Enterprise نوعين من خطافات الويب:

  • خطافات الويب الخاصة بالمؤسسة - يستطيع المسئولون الاشتراك في مشغلات الأحداث المرتبطة بالمستخدمين والمجموعات والعناصر التابعة للمؤسسة.
  • خطافات الويب الخاصة بالخدمة - يمكن للمسئولين الاشتراك في خطافات الويب لخدمات المعالم ومعالجة البيانات الجغرافية.
    • خطافات الويب الخاصة بمعالجة البيانات الجغرافية - يستطيع المسئولون إعداد خطافات الويب لخدمة معالجة البيانات الجغرافية للاستناد إليها حين تكتمل مهمة معالجة البيانات الجغرافية.
    • خطافات الويب الخاصة بخدمة المعالم - يمكن للمسئولين الاشتراك في مشغلات الأحداث المرتبطة بخدمات المعالم التابعة للمؤسسة.

تتبع كل خطافات الويب ArcGIS Enterprise نفس النهج. فبمجرد تشغيل خطاف الويب، تصل المعلومات المستندة إلى حدث في مخطط JSON الذي يحتوي على معلومات ذات صلة، تخص كل نوع من أنواع خطاف الويب. ويضم كل نوع من أنواع خطافات الويب أحداث محددة يمكنهم الاشتراك بها. فعلى سبيل المثال، يمكن الاحتجاج بخطافات الويب المستندة إلى المؤسسة حين يتم نشر أحد العناصر أو عند إنشاء حساب مستخدم جديد. ومن الممكن تشغيل خطافات الويب لخدمة المعالم بعد تعديل مخطط طبقة المعلم. لا تُقدم خطافات الويب لخدمة معالجة البيانات الجغرافية إلا معلومات الحدث عند اكتمال مهمة خدمة معالجة البيانات الجغرافية.

وبوصول معلومات الحدث، تُنفذ منصات أجهزة الاستقبال إجراءً محددًا من شأنه إخطار أعضاء المؤسسة والمسئولين بالحدث. ووفقًا لاحتياجات المؤسسة، فمن الممكن إرسال رسائل عبر البريد الإلكتروني إلى أعضاء بعينهم أو مراسلة المسئولين في Slack.

قد تصبح خطافات الويب أكثر فاعلية من التعهيد نظرًا لأنها ترسل إشعارات بمجرد وقوع الحدث. وعلى عكس التعهيد، لا تحتاج خطافات الويب إلى تطبيقات تهدف إلى متابعة التحقق من النظام لمعرفة ما إذا كان حدث ما قد وقع.

السيناريو: خطافات الويب الخاصة بالمؤسسة

ضع باعتبارك سيناريو تكون فيه مؤسسة ArcGIS Enterprise قد وضعت معاييرًا محددة بحيث يجب على كل عنصر الوفاء بها قبل مشاركته علنًا. يرغب المسئولون في هذه المؤسسة في إنشاء سير عمل يتيح لهم تحقيق الاستجابة في الوقت الفعلي حين تتم مشاركة عنصر لا يستوفي المعايير المنصوص عليها. ويريدون أيضًا تحقيق الاستفادة من خطافات الويب لإخطارهم حين يقوم أحد أصحاب العناصر بمشاركة عناصرهم علنًا، واستخدام معلومات الحدث في الحمولة باعتبارها جزءًا من أحد النصوص التي سيتم إرسالها إلى المسئولين على وجه الخصوص في حالة عدم استيفاء ذلك العنصر لمعاييرها، مع إعطاء المسئولين فرصة تحديث العنصر أو عدم مشاركته مع الجمهور.

تبين القائمة أدناه كيف يمكن لمسؤولي المؤسسات تحقيق استفادة من خطافات الويب لإنشاء سير العمل هذا:

  • يتولى مسئولو المؤسسة إعداد أجهزة استقبال خطاف الويب لكتابة الحمولة الواردة في صورة ملفات نصية محلية.
  • يُنشئ المسئولون نصًا Python يوزع حمولة الملف النصي لاستخلاص المعلومات ذات الصلة بالعنصر والعملية التي أجريت. ويتيح البرنامج النصي ذاته للمسئولين الاستجابة لهذه المعلومات من خلال إرسال إخطار إلى قناة Slack مخصصة. في حالة مشاركة أحد العناصر علنًا دون استيفائه للمعايير العامة، يستخدم البرنامج النصي واجهة برمجة التطبيقات (API) Slackلإرسال رسالة تبين المعلومات المفقودة أو غير الصحيحة إلى مسئولي المؤسسة.
  • وبمجرد إنشاء البرنامج النصي، يُنشئ المسئولون خطاف ويب يصدر تنبيهًا حين يشارك أحد أصحاب العناصر عناصرهم.
  • وفي حالة مشاركة أحد العناصر، سيوزع البرنامج النصي حمولة الملف النصي ويحدد ما إذا تمت مشاركة العنصر علنًا أم في إطار المؤسسة. وفي حالة مشاركته داخل المؤسسة، فلا يلزم اتخاذ أي إجراءات. في حال مشاركة العنصر علنًا، سيصنف البرنامج النصي العنصر استنادًا إلى المعايير التي وضعتها المؤسسة. إن كان التصنيف ذا مرتبة منخفضة (بمعنى أنه لم تُستوفى المعايير العامة)، سيتم إخطار المسئولين في قناتهم Slack حول العنصر الذي تمت مشاركته وعن بيانات التعريف التي لا تستوفي المعايير في الوضع الراهن.
  • ومن ثم، يستطيع أحد مسئولي المؤسسة الاستجابة إما من خلال تحديث بيانات التعريف لكي تلبي المعايير أو باختيار عدم مشاركة العنصر أو مراسلة صاحب العنصر لكي يقوم بما يلزم من تحديثات بشكل مباشر من Slack.