كمسؤول مؤسسة يمكنك تكوين خطافات الويب ليتم الإعلام بنشر 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 الإلكترونية، اتبع الخطوات التالية:
- تحقق من تسجيل الدخول كمسؤول افتراضي أو كعضو في دور مخصص يتمتع بامتياز خطاف ويب المؤسسة.
- استعرض للوصول إلى المؤسسة > الإعدادات > خطافات الويب.
- ضمن خطافات الويب الخاصة بالمؤسسة، انقر فوق إنشاء خطاف ويب.
- في نافذة إنشاء خطاف ويب، قم بما يلي:
- أدخل اسمًا فريدًا لخطاف الويب في المربع النصي الاسم.
- حدد نوع خطاف الويب من القائمة المنسدلة النوع.
- يؤدي تحديد الكل إلى اشتراكك في جميع مشغلات الأحداث المدعومة. ستستلم إشعارات لكل حدث عندما تظهر.
- يتيح لك تحديد العناصر أو المستخدمين أو المجموعات أو الأدوار تحديد مشغلات الأحداث التي تريد الاشتراك فيها يدويًا.
- إذا حددت نوع خطاف ويب بخلاف الكل، فستظهر قائمة منسدلة إضافية تتعلق بنوع خطاف الويب الذي تم اختياره. على سبيل المثال، إذا حددت عناصر لنوع خطاف الويب، فستظهر القائمة المنسدلة العناصر، مما يتيح لك تحديد عنصر معين سيعمل خطاف الويب على مراقبته.
- حدد مشغلات الأحداث من قائمة الأحداث المنسدلة. على سبيل المثال، إذا كنت تريد استدعاء خطاف الويب عند نشر عنصر معين، فحدد /items/<item ID>/publish.
- حدد نوع جهاز مستقبل خطاف الويب.
- إذا حددت عنوان 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
- إذا حددت دفتر الملاحظات، فاختر دفتر الملاحظات الذي سيتم تشغيله عند تشغيل خطاف الويب.
ملاحظة:
إذا لم يكن خيار دفتر الملاحظات متاحًا، فهذا يعني أنه لم يتم تكوين خادم دفتر ملاحظات مع البوابة الإلكترونية. إذا كان الخيار متاحًا ولكن لا يمكن تحديده، فأنت لا تملك أي دفاتر ملاحظات مناسبة لتكوين خطافات الويب. يجب أن تمتلك عنصر دفتر الملاحظات الذي سيتم استخدامه لخطاف الويب.
- إذا حددت عنوان URL لخطاف الويب ، فأدخل عنوان URL الخاص بالحمولة لمستقبل خطاف الويب. يظهر مثال لعنوان URL الخاص بالحمولة أدناه:
- اختياريًا، قم بتعيين قيمة سرية لخطاف الويب في المربع النصي سري (اختياري). سيتم استخدام القيمة السرية لإنشاء توقيع مضمن في رؤوس حمولة خطاف الويب. يمكن لمستقبِل خطاف الويب استخدام هذا التوقيع لتحديد ما إذا كان يجب الوثوق بالرسالة أم لا.
- انقر فوق إنشاء خطاف ويب.
تكوين المعلمات المتقدمة لخطافات ويب المؤسسة
تتيح لك الإعدادات المتقدمة المطبقة على خطافات ويب المؤسسة تخصيص أداء خطافات الويب، مثل تحديد عدد محاولات التسليم ووقت الإخطار والوقت بين محاولات التسليم.
لتعيين الخصائص المتقدمة من خلال موقع بوابة ArcGIS Enterprise الإلكترونية ، قم بما يلي:
- قم بتسجيل الدخول إلى مؤسستك كمسؤول افتراضي أو كعضو له دور مخصص يتمتع بامتياز خطافات ويب المؤسسة.
- استعرض للوصول إلى المؤسسة > الإعدادات > خطافات الويب.
- ضمن خطافات الويب الخاصة بالمؤسسة، انقر فوق إعدادات خطاف الويب المتقدمة.
- في نافذة إعدادات خطاف الويب المتقدمة، قم بما يلي:
- قم بتعيين قيمة لعدد محاولات التسليم.
تحدد هذه القيمة عدد المحاولات التي سيتم القيام بها لتسليم حمولات خطاف الويب. افتراضيًا، ستحاول بوابة ArcGIS Enterprise الإلكترونية تسليم الحمولات 3 مرات. يجب أن تكون قيمة المحاولات عددًا صحيحًا بين 0 و5.
- قم بتعيين قيمة لمهلة الإخطار.
تحدد هذه القيمة المدة بالثواني، التي سينتظر خلالها بوابة ArcGIS Enterprise الإلكترونية لاستلام استجابة من مستلم. افتراضيًا، ستنتظر بوابة ArcGIS Enterprise الإلكترونية لمدة 10 ثوانٍ. يجب أن تكون قيمة الرقم بالثواني المحددة لانتظار بوابة ArcGIS Enterprise الإلكترونية عددًا صحيحًا بين 0 و60 ثانية.
- قم بتعيين قيمة لوقت الإخطار المنقضي.
تحدد هذه القيمة الوقت، بالثواني، بين كل محاولة تسليم حمولة. افتراضيًا، ستحاول بوابة ArcGIS Enterprise الإلكترونية تسليم حمولة أخرى بعد 5 ثوانٍ إذا فشلت المحاولة السابقة، حتى يتم الوصول إلى عدد المحاولات المحدد في عدد محاولات التسليم.
- قم بتعيين قيمة لعدد محاولات التسليم.
- بمجرد تكوين الإعدادات أعلاه، انقر فوق حفظ.
سيتم تطبيق الخصائص المحدثة على كل خطافات ويب المؤسسة التي تم تكوينها.
تكوين خطافات الويب الخاصة بالخدمة
تسمح لك خطافات الويب الخاصة بالخدمة بالاشتراك في مشغلات الأحداث المرتبطة بخدمات معالم مؤسستك أو عند اكتمال مهام خدمة المعالجة الجغرافية.
إنشاء خطاف ويب للخدمة
لإنشاء خطاف ويب لخدمة المعالجة الجغرافية أو خدمة المعالم، اتبع الخطوات التالية:
- قم بتسجيل الدخول إلى مؤسستك كمسؤول افتراضي أو عضو في دور مخصص يتمتع بامتيازات إدارية لإنشاء خطافات الويب الخاصة بالخدمة وإدارتها.
ملاحظة:
لن يتمكن الأعضاء الذين تم تعيينهم لدور الناشر من إنشاء أو إدارة خطافات الويب الخاصة بالخدمة من موقع البوابة الإلكترونية ArcGIS Enterprise وسيحتاجون إلى تنفيذ مهام سير العمل هذه باستخدام API. - استعرض للوصول إلى المؤسسة > الإعدادات > خطافات الويب.
- ضمن خطافات الويب الخاصة بالخدمة، انقر فوق إنشاء خطاف ويب.
- في نافذة إنشاء خطاف ويب، قم بما يلي:
- أدخل اسمًا فريدًا لخطاف الويب في المربع النصي الاسم.
- حدد خدمة من قائمة الخدمة المنسدلة.
ملاحظة:
سيؤدي تحديد خدمة المعالجة الجغرافية إلى تعيين الحدث عند انتهاء الخدمة. سيؤدي تحديد خدمة المعالم إلى تمكين قائمة الأحداث المنسدلة.
- إذا قمت بتحديد خطاف ويب لخدمة المعالم، فحدد مشغل حدث من قائمة الأحداث المنسدلة. على سبيل المثال، إذا كنت تريد استدعاء خطاف الويب عندما يتضمن التعديل مرفقًا جديدًا، فحدد تم إنشاء المرفقات.
- قم بتوفير عنوان 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
- اختياريًا، قم بتعيين قيمة سرية لخطاف الويب في المربع النصي سري (اختياري). سيتم استخدام القيمة السرية لإنشاء توقيع مضمن في رؤوس حمولة خطاف الويب. يمكن لمستقبِل خطاف الويب استخدام هذا التوقيع لتحديد ما إذا كان يجب الوثوق بالرسالة أم لا.
- انقر فوق إنشاء خطاف ويب.
قم بتكوين المعلمات المتقدمة لخطافات الويب الخاصة بالخدمة
تسمح لك الإعدادات المتقدمة المطبقة على خطافات الويب الخاصة بخدمتك بتخصيص أداء خطافات الويب بشكل أكبر، مثل تحديد عدد محاولات التسليم، ووقت الإشعار، والوقت بين محاولات التسليم.
لتعيين الخصائص المتقدمة من خلال موقع بوابة ArcGIS Enterprise الإلكترونية ، قم بما يلي:
- قم بتسجيل الدخول إلى مؤسستك كمسؤول افتراضي أو عضو في دور مخصص يتمتع بامتيازات إدارية لإنشاء خطافات الويب الخاصة بالخدمة وإدارتها.
ملاحظة:
لن يتمكن الأعضاء الذين تم تعيينهم لدور الناشر من إنشاء أو إدارة خطافات الويب الخاصة بالخدمة من موقع البوابة الإلكترونية ArcGIS Enterprise وسيحتاجون إلى تنفيذ مهام سير العمل هذه باستخدام API. - استعرض للوصول إلى المؤسسة > الإعدادات > خطافات الويب.
- ضمن خطافات الويب الخاصة بالخدمة، انقر فوق إعدادات خطاف الويب المتقدمة.
- في نافذة إعدادات خطاف الويب المتقدمة، قم بما يلي:
- قم بتعيين قيمة لعدد محاولات التسليم.
تحدد هذه القيمة عدد المحاولات التي سيتم القيام بها لتسليم حمولات خطاف الويب. افتراضيًا، سيحاول النظام تسليم الحمولات 3 مرات. يجب أن تكون قيمة المحاولات عددًا صحيحًا بين 0 و5.
- قم بتعيين قيمة لمهلة الإخطار.
تحدد هذه القيمة المدة بالثواني، التي سينتظر خلالها النظام لاستلام استجابة من مستلم. افتراضيًا، سينتظر النظام لمدة 10 ثوانٍ. يجب أن تكون القيمة عددًا صحيحًا بين 0 و60 ثانية.
- قم بتعيين قيمة لوقت الإخطار المنقضي.
تحدد هذه القيمة الوقت، بالثواني، بين كل محاولة تسليم حمولة. افتراضيًا، سيحاول النظام تسليم حمولة أخرى بعد 5 ثوانٍ إذا فشلت المحاولة السابقة، حتى يتم الوصول إلى عدد المحاولات المحدد في عدد محاولات التسليم.
- قم بتعيين قيمة لعدد الأيام الماضية.
تحدد هذه القيمة عدد الأيام التي يمكن أن يحدث فيها عدد محدد من حالات الفشل قبل إلغاء تنشيط خطاف الويب. افتراضيًا، سيقبل النظام عددًا محددًا من حالات الفشل (المحدد في الحد الأقصى لعدد حالات الفشل) على مدار 5 أيام. يجب أن تكون القيمة عددًا صحيحًا بين 1 و30.
- قم بتعيين قيمة للحد الأقصى لعدد حالات الفشل.
تحدد هذه القيمة عدد حالات الفشل التي يمكن أن تحدث خلال عدد محدد من الأيام قبل إلغاء تنشيط خطاف الويب. افتراضيًا، سيقبل النظام 5 حالات فشل على مدار عدد من الأيام (المحدد في عدد الأيام الماضية) قبل إلغاء تنشيط خطافات الويب. يجب أن تكون القيمة عددًا صحيحًا بين 1 و30.
- قم بتعيين قيمة لعدد محاولات التسليم.
- بمجرد تكوين الإعدادات أعلاه، انقر فوق حفظ.
سيتم تطبيق الخصائص المحدثة على كل خطاف ويب للخدمة التي تم تكوينها.