Skip To Content

المفاهيم الأساسية لخطافات الويب

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

مُشغل الحدث

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

الحمولة

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

عنوان URL الخاص بالحمولة

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

المستقبلات

تُسلم الحمولات إلى مستقبلات، والتي تسترد الحمولة وتبلغ أن الحدث قد حدث مرة أخرى للمسؤولين أو أعضاء المؤسسة. يجب تكوين مستلمي خُطافات الويب للتواصل عبر اتصال HTTPS لاستلام الحمولات والتي يمكن الوصول بها من خلال ArcGIS Enterprise. توجد خيارات قليلة مدعومة للمستلمين، مثل مستلمي خدمة الويب من جهة أخرى (Microsoft Power Automate وZapier وIFFT)، وخدمات الويب المخصصة و ArcGIS Notebook Server وArcGIS Workflow Manager. للحصول على أمثلة حول كيفية إنشاء خدمات ويب مخصصة أو البدء باستخدام المستلمين من جهات أخرى، راجع مستودع خُطافات الويب. لمعرفة المزيد عن إنشاء Notebook Server وخُطافات الويب Workflow Manager، راجع تشغيل عمليات سير العمل تلقائيًا باستخدام ArcGIS Notebooks وإنشاء المهام باستخدام خُطافات الويب، على التوالي.