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

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

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

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

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

ملاحظة:‏

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

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

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

ملاحظة:‏

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

لإنشاء خطاف ويب لمؤسستك، اتبع هذه الخطوات:

1. استعرض دليل بوابة ArcGIS الإلكترونية وقم بتسجيل الدخول كعضو بدور مسؤول.

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

   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. بعد تكوين المعلمات السابقة، انقر فوق إنشاء خطاف ويب لإرسال طلب.

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

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

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

ملاحظة:‏

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

لتعيين هذه الخصائص المتقدمة، افعل ما يلي:

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة:‏

للاطلاع على مثال على طلب POST الخاص بإنشاء خطاف ويب لخدمات معالجة البيانات الجغرافية، راجع وثائق الإصدار التجريبي REST API لخطاف الويب في دليل واجهة برمجة التطبيقات (API) الخاص بمسؤول خطافات ويب الخدمة PDF.

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

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

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

   تنبيه:

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

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

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

ملاحظة:‏

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

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

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

ملاحظة:‏

للاطلاع على مثال على طلب POST الخاص بإنشاء خطاف ويب لخدمات المعالم، راجع وثائق الإصدار التجريبي REST API لخطاف الويب في دليل واجهة برمجة التطبيقات (API) الخاص بمسؤول خطافات ويب الخدمة PDF.

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

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

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

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

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

   تنبيه:

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

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

      مثال

      FeaturesCreated

      لرؤية قائمة بجميع مشغلات الحدث المدعومة لخطافات ويب خدمة المعلم، راجع موضوع مشغلات الحدث.
   3. بشكل اختياري، ضع كلمة سر لخطاف الويب يمكن استخدامها لمصادقة رسائل خطاف الويب مع المستلم. أدخل سلسلة أبجدية رقمية محددة من قبل المستخدم في المربع النصي مفتاح التوقيع.
   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. بعد تكوين المعلمات السابقة، انقر فوق إنشاء لإرسال طلب.

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