إنشاء خُطافات الويب

كمسؤول مؤسسة يمكنك تكوين خطافات الويب ليتم الإعلام بنشر ArcGIS Enterprise عند وقوع أحداث محددة. توضح الأقسام أدناه كيفية تكوين خُطافات الويب للمؤسسة والخدمة.

المتطلبات الأساسية لإنشاء خُطافات الويب

خذ في اعتبارك ما يلي قبل إنشاء خُطافات الويب:

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

  ملاحظة:‏

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

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

  ملاحظة:‏

  تمت إضافة دعم لخدمات المعالم التي لها إصدارات فرعية على ArcGIS Enterprise 11.3.

• لتكوين خُطافات الويب لخدمة معالجة البيانات الجغرافية، يجب أن تكون الخدمة غير متزامنة.

إنشاء خطاف ويب خاص بالمؤسسة

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

ملاحظة:‏

يمكن إنشاء خطافات ويب المؤسسة من خلال موقع بوابة ArcGIS Enterprise الإلكترونية أو ArcGIS Portal Directory. للاطلاع على مثال لطلب POST الذي يشكل خطاف ويب حول الأحداث المرتبطة بالمستخدم والمجموعة والعنصر، راجع مستندات REST API لإنشاء خطاف الويب.

إنشاء خطاف ,df المؤسسة في ArcGIS Portal Directory

لإنشاء خطاف ويب مؤسسة من خلال ArcGIS Portal Directory، اتبع الخطوات التالية:

1. استعرض وصولاً إلى ArcGIS Portal Directory وقم بتسجيل الدخول كعضو بدور مسؤول.

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

   https://machine.domain.com/webadaptor/sharing/rest

   بمجرد تسجيل الدخول، تظهر صفحة مورد المستخدم لحسابك.

2. انقر فوق الارتباط التشعبي معرف المؤسسة أو قدم طلبًا بالنموذج التالي للوصول إلى صفحة الموارد الذاتية بالبوابة الإلكترونية:
   https://machine.domain.com/webadaptor/sharing/rest/portals/self

3. مرر لأسفل صفحة المورد الذاتي وانقر فوق خطاف الويب > إنشاء خطاف الويب للوصول إلى عملية إنشاء خطاف الويب.
4. بمجرد التواجد على نقطة نهاية إنشاء خطاف الويب، قم بتقديم المعلومات التالية:
   1. أدخل اسمًا فريدًا لخطاف الويب في المربع النصي الاسم.
   2. قم بتوفير عنوان URL لمستلم خطاف الويب في المربع النصي عنوان URL للحمولة، والذي سيتم وضعه في قائمة الانتظار حتى يتم إنشاء خطاف الويب للتأكد من إمكانية إجراء اتصال ناجح بين المستلم وبوابة ArcGIS Enterprise الإلكترونية.

      يظهر مثال لعنوان URL الخاص بالحمولة أدناه:

      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   3. بشكل اختياري، ضع كلمة سر لخطاف الويب يمكن استخدامها لمصادقة رسائل خطاف الويب مع المستلم. أدخل سلسلة أبجدية رقمية محددة من قبل المستخدم في المربع النصي كلمة السر (اختيارية)
   4. بشكل اختياري، حدد معلومات إلغاء التنشيط لخطاف الويب في المربع النصي خصائص التكوين.

      بشكل افتراضي، يتم إلغاء تنشيط خطاف الويب في حال حدوث خمسة إخفاقات خلال خمسة أيام.

   5. أسفل أي الأحداث تود أن تشغل خطاف الويب هذا، حدد دعني أقوم بتحديدها يدويًا أو أرسل لي كل شيء.
      • إذا اخترت دعني أقوم بتحديدها يدويًا فأدخل أحداث المشغل التي سيتم استخدامها لخطاف الويب هذا في المربع النصي إرسال التغييرات للأحداث المفصولة بفاصلة. على سبيل المثال، إذا أردت الاشتراك في جميع الأحداث المتعلقة بمجموعة محددة في مؤسستك، فأدخل مشغل حدث مماثلاً للمشغل الظاهر أدناه، حيث يمثل [groupID] المعرف الفريد المرتبط بمجموعة محددة:
        /groups/[groupID]/update

        للاطلاع على قائمة بجميع مشغلات الأحداث المدعومة لخطافات ويب المؤسسة، راجع مشغلات الأحداث.
      • إذا اخترت أرسل لي كل شيء، فسوف تشترك في جميع مشغلات الأحداث المدعومة. ستستلم إشعارات لكل حدث عندما تظهر.
5. بعد تكوين المعلمات السابقة، انقر فوق إنشاء خطاف ويب لإرسال طلب.

   بعد اكتمال التشغيل، ستتم إضافة خطاف ويب جديد إلى مؤسستك.

إنشاء خطاف ويب مؤسسة في موقع بوابة ArcGIS Enterprise الإلكترونية

لإنشاء خطاف ويب مؤسسة من خلال موقع بوابة ArcGIS Enterprise الإلكترونية، اتبع الخطوات التالية:

1. تحقق من تسجيل الدخول كمسؤول افتراضي أو كعضو في دور مخصص يتمتع بامتياز خطاف ويب المؤسسة.
2. استعرض للوصول إلى المؤسسة > الإعدادات > خطافات الويب.
3. انقر فوق إنشاء خطاف ويب.
4. في نافذة إنشاء خطاف ويب، قم بما يلي:
   1. أدخل اسمًا فريدًا لخطاف الويب في المربع النصي الاسم.
   2. حدد نوع خطاف الويب من القائمة المنسدلة النوع.
      • يؤدي تحديد الكل إلى اشتراكك في جميع مشغلات الأحداث المدعومة. ستستلم إشعارات لكل حدث عندما تظهر.
      • يتيح لك تحديد العناصر أو المستخدمين أو المجموعات أو الأدوار تحديد أحداث التشغيل التي تريد الاشتراك فيها يدويًا.
   3. إذا حددت نوع خطاف ويب بخلاف الكل، فستظهر قائمة منسدلة إضافية تتعلق بنوع خطاف الويب الذي تم اختياره. على سبيل المثال، إذا حددت عناصر لنوع خطاف الويب، فستظهر القائمة المنسدلة العناصر، مما يتيح لك تحديد عنصر معين سيعمل خطاف الويب على مراقبته.
   4. حدد حدث تشغيل من القائمة المنسدلة الأحداث. على سبيل المثال، إذا كنت تريد استدعاء خطاف الويب عند نشر عنصر معين، فحدد /items/<item ID>/publish.
   5. حدد نوع جهاز مستقبل خطاف الويب.
      • إذا حددت عنوان URL لخطاف الويب ، فأدخل عنوان URL الخاص بالحمولة لمستقبل خطاف الويب. يظهر مثال لعنوان URL الخاص بالحمولة أدناه:
        https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

      • إذا حددت دفتر الملاحظات، فاختر دفتر الملاحظات الذي سيتم تشغيله عند تشغيل خطاف الويب.

        ملاحظة:‏

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

   6. اختياريًا، قم بتعيين قيمة سرية لخطاف الويب في المربع النصي سري (اختياري). سيتم تضمين القيمة السرية في حمولة خطاف الويب وستُستخدم لمصادقة رسائل خطاف الويب مع المستقبل.
5. انقر فوق إنشاء خطاف ويب.

تكوين المعلمات المتقدمة لخطافات ويب المؤسسة

تتيح لك الإعدادات المتقدمة المطبقة على خطافات ويب المؤسسة تخصيص أداء خطافات الويب، مثل تحديد عدد محاولات التسليم ووقت الإخطار والوقت بين محاولات التسليم.

ملاحظة:‏

يمكن أن يتم تعديل الخصائص المتقدمة لخطافات ويب المؤسسة من خلال موقع بوابة ArcGIS Enterprise الإلكترونية أو ملف ArcGIS Portal Directory. للاطلاع على مثال لطلب POST الذي يكون هذه الخصائص المتقدمة، راجع مستندات REST API لتحديث إعدادات خطاف الويب.

تكوين المعلمات المتقدمة في ArcGIS Portal Directory

لتعيين الخصائص المتقدمة من خلال ArcGIS Portal Directory، قم بما يلي:

1. استعرض وصولاً إلى ArcGIS Portal Directory وقم بتسجيل الدخول كعضو بدور مسؤول.

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

   https://machine.domain.com/webadaptor/sharing/rest

   بمجرد تسجيل الدخول، تظهر صفحة مورد المستخدم لحسابك.

2. انقر فوق الارتباط التشعبي معرف المؤسسة أو قدم طلبًا بالنموذج التالي للوصول إلى صفحة الموارد الذاتية بالبوابة الإلكترونية:
   https://machine.domain.com/webadaptor/sharing/rest/portals/self

3. مرر لأسفل صفحة المورد الذاتي وانقر فوق خطاف الويب > الإعدادات > تحديث للوصول إلى عملية تحديث إعدادات خطاف الويب.
4. بمجرد التواجد على نقطة نهاية تحديث إعدادات خطاف الويب، قم بتقديم المعلومات التالية:
   1. قم بتعيين قيمة لعدد محاولات الإخطار.

      تحدد هذه القيمة عدد المحاولات التي سيتم القيام بها لتسليم حمولات خطاف الويب. افتراضيًا، ستحاول بوابة ArcGIS Enterprise الإلكترونية تسليم الحمولات 3 مرات. يجب أن تكون قيمة المحاولات عددًا صحيحًا بين 0 و5.

   2. قم بتعيين قيمة لمهلة الإخطار بالثواني.

      تحدد هذه القيمة المدة بالثواني، التي سينتظر خلالها بوابة ArcGIS Enterprise الإلكترونية لاستلام استجابة من مستلم. افتراضيًا، سينتظر مدخل ArcGIS Enterprise 10 ثوانٍ. يجب أن تكون قيمة الرقم بالثواني المحددة لانتظار بوابة ArcGIS Enterprise الإلكترونية عددًا صحيحًا بين 0 و60 ثانية.

   3. قم بتعيين قيمة لوقت الإخطار المنقضي بالثواني.

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

5. بعد تكوين المعلمات السابقة، انقر فوق تحديث إعدادات خطاف الويب لإرسال الطلب.

   بعد اكتمال العملية، سيتم تطبيق الخصائص المحدثة على كل خطاف ويب مؤسسة تم تكوينه.

تكوين المعلمات المتقدمة في موقع بوابة ArcGIS Enterprise الإلكترونية

لتعيين الخصائص المتقدمة من خلال موقع بوابة ArcGIS Enterprise الإلكترونية ، قم بما يلي:

1. قم بتسجيل الدخول إلى مؤسستك كمسؤول افتراضي أو كعضو له دور مخصص يتمتع بامتياز خطافات ويب المؤسسة.
2. في أعلى الموقع، انقر على المؤسسة وانقر على علامة تبويب الإعدادات .
3. انقر فوق خطافات الويب في الجانب الأيسر من الصفحة.
4. انقر فوق إعدادات خطاف الويب المتقدمة.
5. في نافذة إعدادات خطاف الويب المتقدمة، قم بما يلي:
   1. قم بتعيين قيمة لعدد محاولات التسليم.

      تحدد هذه القيمة عدد المحاولات التي سيتم القيام بها لتسليم حمولات خطاف الويب. افتراضيًا، ستحاول بوابة ArcGIS Enterprise الإلكترونية تسليم الحمولات 3 مرات. يجب أن تكون قيمة المحاولات عددًا صحيحًا بين 0 و5.

   2. قم بتعيين قيمة لمهلة الإخطار.

      تحدد هذه القيمة المدة بالثواني، التي سينتظر خلالها بوابة ArcGIS Enterprise الإلكترونية لاستلام استجابة من مستلم. افتراضيًا، ستنتظر بوابة ArcGIS Enterprise الإلكترونية لمدة 10 ثوانٍ. يجب أن تكون قيمة الرقم بالثواني المحددة لانتظار بوابة ArcGIS Enterprise الإلكترونية عددًا صحيحًا بين 0 و60 ثانية.

   3. قم بتعيين قيمة لوقت الإخطار المنقضي.

      تحدد هذه القيمة الوقت، بالثواني، بين كل محاولة تسليم حمولة. افتراضيًا، ستحاول بوابة ArcGIS Enterprise الإلكترونية تسليم حمولة أخرى بعد 5 ثوانٍ إذا فشلت المحاولة السابقة، حتى يتم الوصول إلى عدد المحاولات المحدد في عدد محاولات التسليم.

6. بمجرد تكوين الإعدادات أعلاه، انقر فوق حفظ.

   سيتم تطبيق الخصائص المحدثة على كل خطافات ويب المؤسسة التي تم تكوينها.

إنشاء خطاف ويب خدمة معالجة البيانات الجغرافية

تتيح لك خطافات ويب خدمة معالجة البيانات الجغرافية الاشتراك في مشغلات أحداث محددة مرتبطة بخدمات معالجة البيانات الجغرافية.

ملاحظة:‏

لا يمكن إنشاء خطافات ويب خدمة معالجة البيانات الجغرافية إلا من خلال دليل مسؤول ArcGIS Server. لرؤية مثال على طلب POST الذي ينشئ خطاف ويب خدمة معالجة البيانات الجغرافية، راجع وثائق إنشاء خطاف الويب REST API.

لإنشاء خطاف ويب لخدمة معالجة البيانات الجغرافية، اتبع هذه الخطوات:

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

   ملاحظة:‏

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

   https://machine.domain.com/webadaptor/admin

2. بعد تسجيل الدخول، استعرض مورد خطافات الويب لخدمة معالجة البيانات الجغرافية بالنقر فوق الخدمات > [اسم الخدمة] > خطافات الويب > إنشاء، حيث تمثل [ServiceName] الخدمة التي سيتم إنشاء خطاف ويب لها. بالنسبة للخدمات الموجودة في مجلدات محددة، انقر فوق الخدمات > [اسم المجلد] > [اسم الخدمة] > خطافات الويب > إنشاء، حيث يمثل [FolderName] المجلد الموجود به الخدمة.

   تنبيه:

   لتكوين خُطافات الويب لخدمة معالجة البيانات الجغرافية، يجب أن تكون خدمة معالجة البيانات الجغرافية غير متزامنة.

3. بمجرد التواجد على نقطة نهاية إنشاء خطاف الويب، قم بتقديم المعلومات التالية:
   1. أدخل اسمًا فريدًا لخطاف الويب في المربع النصي الاسم. يمكن أن يحتوي الاسم المقدم على قيم أبجدية رقمية فقط، إذ قد يؤدي استخدام الأحرف الخاصة إلى ظهور رسالة خطأ.
   2. بشكل اختياري، ضع كلمة سر لخطاف الويب يمكن استخدامها لمصادقة رسائل خطاف الويب مع المستلم. أدخل سلسلة أبجدية رقمية محددة من قبل المستخدم في المربع النصي مفتاح التوقيع.

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

   3. قم بتوفير عنوان URL لمستلم خطاف الويب في المربع النصي عنوان URL للخطاف، والذي سيتم وضعه في قائمة الانتظار حتى يتم إنشاء خطاف الويب للتأكد من إمكانية إجراء اتصال ناجح بين المستلم وArcGIS Server للنشر. يوجد مثال على الحمولة أدناه:
      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   4. اختياريًا، حدد نوع الوسائط.‎ في القائمة المنسدلة نوع المحتوى، اختر أيًا مما يلي:
      • application/json (افتراضي)
      • application/x-www-form-urlencoded
   5. اختياريًا، حدد تنسيق الحمولات. في القائمة المنسدلة تنسيق الحمولة، اختر أي مما يلي:
      • JSON (افتراضي)
      • PJSON
   6. اختياريًا، استخدم معلمة نشط لتعطيل رد الاتصالات عند تشغيل خطاف الويب. للتمكين، حدد صحيح. للتعطيل، حدد خاطئ.

      الوضع الافتراضي لرد الاتصالات هو تمكين.

4. بعد تكوين المعلمات السابقة، انقر فوق إنشاء لإرسال طلب.

   بعد اكتمال التشغيل، يتم تطبيق خطاف الويب الجديد على خدمة معالجة البيانات الجغرافية المحددة.

ملاحظة:‏

لا تمتلك خطافات الويب الخاصة بخدمة معالجة البيانات مشغلات الحدث المحددة من قبل المستخدم، على خلاف خطافات الويب الخاصة بخدمة المؤسسة والمعلم. تسلم خطافات الويب الخاصة بخدمة معالجة البيانات الجغرافية الحمولات بمجرد اكتمال وظيفة معالجة البيانات الجغرافية. لمزيد من المعلومات حول الحمولات المستلمة لخدمات معالجة البيانات الجغرافية، راجع الحمولات.

إنشاء خطاف ويب خدمة المعالم

تتيح لك خطافات ويب خدمة المعالم الاشتراك في مشغلات أحداث محددة مرتبطة بخدمات المعالم.

ملاحظة:‏

لا يمكن إنشاء خطافات ويب خدمة المعالم إلا من خلال دليل مسؤول ArcGIS Server. لرؤية مثال على طلب POST الذي ينشئ خطاف ويب خدمة المعالم، راجع وثائق إنشاء خطاف الويب REST API.

لإنشاء خطاف ويب لخدمة المعالم، اتبع هذه الخطوات:

1. استعرض إلى دليل مسؤول ArcGIS Server وقم بتسجيل الدخول كعضو يمتلك امتيازات مناسبة مخصصة له.
   لا يمكن إنشاء خطافات الويب وإدارتها إلا من قبل الأعضاء الذين تم تعيين امتياز طبقة المعالم أو دور المسؤول الافتراضي لهم.
   https://machine.domain.com/webadaptor/admin

2. بمجرد تسجيل الدخول، استعرض إلى مورد خطافات الويب لخدمة المعالم من خلال النقر فوق الخدمات > [اسم الخدمة] > خطافات الويب > إنشاء، حيث يمثل [ServiceName] الخدمة التي سيتم إنشاء خطاف الويب من أجلها. بالنسبة للخدمات الموجودة في مجلدات محددة، انقر فوق الخدمات > [اسم المجلد] > [اسم الخدمة] > خطافات الويب > إنشاء، حيث يمثل [FolderName] المجلد الموجود به الخدمة.
3. بمجرد التواجد على نقطة نهاية إنشاء خطاف الويب، قم بتقديم المعلومات التالية:
   1. أدخل اسمًا فريدًا لخطاف الويب في المربع النصي الاسم. يمكن أن يحتوي الاسم المقدم على قيم أبجدية رقمية فقط، إذ قد يؤدي استخدام الأحرف الخاصة إلى ظهور رسالة خطأ.
   2. ضع قائمة بمشغلات الأحداث التي سيتم استخدامها لخطاف الويب هذا في المربع النصي نوع التغيير. على سبيل المثال، لاستدعاء خطاف الويب عند إنشاء أي خدمة معالم، استخدم مشغل الحدث التالي:

      مثال

      FeaturesCreated

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

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

   4. قم بتوفير عنوان URL لمستلم خطاف الويب في المربع النصي عنوان URL للخطاف، والذي سيتم وضعه في قائمة الانتظار حتى يتم إنشاء خطاف الويب للتأكد من إمكانية إجراء اتصال ناجح بين المستلم وArcGIS Server للنشر. يوجد مثال على الحمولة أدناه:
      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   5. اختياريًا، حدد نوع الوسائط.‎ في القائمة المنسدلة نوع المحتوى، اختر أيًا مما يلي:
      • application/json (افتراضي)
      • application/x-www-form-urlencoded
   6. اختياريًا، حدد تنسيق الحمولات. في القائمة المنسدلة تنسيق الحمولة، اختر أي مما يلي:
      • JSON (افتراضي)
      • PJSON
   7. اختياريًا، استخدم معلمة نشط لتعطيل رد الاتصالات عند تشغيل خطاف الويب. للتمكين، حدد صحيح. للتعطيل، حدد خاطئ.

      الوضع الافتراضي لرد الاتصالات هو تمكين.

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

      القيمة الأدنى والافتراضية للجدولة هي 20 ثانية.

4. بعد تكوين المعلمات السابقة، انقر فوق إنشاء لإرسال طلب.

   بعد اكتمال التشغيل، يتم تطبيق خطاف الويب الجديد على خدمة المعالم المحددة.