خطاف الويب "Webhook" هو آلية تتيح لتطبيق أو خدمة ويب إرسال معلومات شبه فورية إلى خدمة ويب أخرى. يتم تشغيل عملية الإرسال بواسطة حدث أو عدة أحداث تقوم بتحديدها. وبدلاً من التحقق المستمر من وجود تحديثات، يرسل النظام إشعارًا فور وقوع الحدث المُحدد.
في ArcGIS Online، يمكن إنشاء خطافات ويب Webhooks للطبقات المستضافة، وعروض الطبقات المستضافة، والجداول المستضافة. تقوم خطافات الويب الحالية بإرسال الحِزم إلى مستقبل Webhook بناءً على مشغلات أحداث محددة. ويتم تكوين جهاز الاستقبال لتنفيذ إجراءات آلية مثل: إشعار قائمة محددة مسبقًا من المستلمين بالتعديلات، أو تصدير بيانات التعديلات إلى تطبيق خارجي لإنشاء تقرير بالتغييرات، أو تشغيل برامج نصية للتحكم في جودة البيانات المُعدلة.
مكونات قناة الاتصال هذه هي كما يلي:
- مشغل الحدث (Event trigger): يحدد كل مشغل حدث عمليات الـ API التي يتم تنفيذها على خدمة المعالم المصدر الخاصة بالعنصر والتي تستدعي الـ Webhook. عند تنفيذ المستخدم عملية تم تحديدها كمشغل حدث، يقوم الـ Webhook بإرسال تلك المعلومات (على هيئة Payload) إلى مستقبل Webhook. يتم تحديد المشغلات أثناء إنشاء الـ Webhook. يرجى الاطلاع على مشغلات أحداث طبقة المعالم للاطلاع على الأحداث التي يمكن تعيينها.
- الحِزمة (Payload): تحتوي الحِزمة على المعلومات ذات الصلة بالحدث المُشغِّل. يرجى الاطلاع على حِزم Webhook الخاصة بطبقة المعالم لمعرفة تفاصيل ما تتضمنه الحِزمة.
- مستقبل الـ Webhook: يستقبل خطاف الويب الحِزمة ويقوم بإرسال المعلومات إلى قائمة محددة مسبقًا من المستلمين (مستخدمين أو تطبيقات). على سبيل المثال: يمكنه إرسال بريد إلكتروني أو رسالة نصية لإشعار المستخدم بوقوع الحدث المُشغِّل، أو إرسال معلومات الحدث إلى قاعدة بيانات خارجية للأرشفة، أو تشغيل برنامج نصي لمعالجة البيانات بناءً على الحدث الذي وقع.
يمكنك استخدام مستقبلات لخدمات ويب تابعة لجهات خارجية أو خدمات ويب مخصصة كمستقبلات Webhook. يجب تكوين المستقبلات بحيث تتواصل عبر اتصال HTTPS لاستقبال الحِزم، ويجب أن تكون مؤسسة ArcGIS Online قادرة على الوصول إلى هذه المستقبلات قبل إضافة Webhook إلى عنصر. يتم الوصول إلى مستقبل الـ Webhook من خلال عنوان URL الخاص بالحِزمة الذي تحدده عند إنشاء Webhook.
يتم تكوين مستقبل الـ Webhook خارج ArcGIS Online. وبعد إتمام تكوين جهاز الاستقبال، يمكنك إنشاء الـ Webhook.
المتطلبات
قبل أن تتمكن من إنشاء Webhook لطبقة معالم مستضافة أو عرض أو جدول، يجب أن يستوفي العنصر المتطلبات التالية:
- يجب تفعيل إعداد تتبع التغييرات في البيانات (إضافة، تحديث، حذف المعالم).
- لا يمكن أن يكون العنصر في سلة المحذوفات.
يمكن أن يحتوي كل عنصر على ما يصل إلى 10 خطافات ويب.
إنشاء خطاف ويب "Webhook"
أنواع أعضاء المؤسسة الذين يمكنهم إنشاء وإدارة Webhooks للطبقات المستضافة، وعروض الطبقات المستضافة، والجداول المستضافة مذكورة في الجدول التالي، مع معلومات عن أماكن إدارتها.
| نوع عضو المؤسسة | أماكن إدارة الـ Webhooks |
|---|---|
يتمتع أعضاء دور المسؤول الافتراضي أو أعضاء دور مخصص بمجموعة من الامتيازات الإدارية لإنشاء وإدارة خطافات الويب. |
|
مالكو العنصر |
|
أعضاء مجموعة التحديث المشتركة التي تمت مشاركة العنصر معها | علامة تبويب الإعدادات في صفحة عنصر الطبقة المستضافة أو العرض أو الجدول — يمكن لعضو المجموعة إنشاء وإدارة الـ Webhooks للعنصر المحدد من هذا الموقع. |
اتبع التعليمات المناسبة لدورك في المؤسسة لإنشاء Webhook:
- مسؤول المؤسسة
- مالك العنصر أو عضو في مجموعة التحديث المشتركة التي تمت مشاركة العنصر معها