أتمتة مهام سير عمل دفتر الملاحظات باستخدام أحداث خطاف الويب

خطاف الويب هو آلية تسمح للتطبيق بتقديم تطبيقات أخرى بمعلومات مستندة إلى الحدث. يمكن تكوين خطافات الويب على مستوى المؤسسة والخدمة لتشغيل دفتر ملاحظات تلقائيًا عند عقد أحداث مرتبطة بمؤسستك أو خدماتك.

أتمتة Notebook باستخدام خطافات الويب الخاصة بالمؤسسة

بصفتك مسؤول ArcGIS Enterprise أو مستخدمًا يمتلك امتياز خطافات الويب للمؤسسة، يمكنك إنشاء خطافات الويب وإدارتها وتكوينها. يمكنك تكوين خطافات الويب لتشغيل دفتر ملاحظات تملكه تلقائيًا عند وقوع أحداث مرتبطة بالعناصر الخاصة بك أو المجموعات أو المستخدمين. تعمل ArcGIS Notebook Server كمستقبل لحمولة خطاف الويب. بمجرد تشغيل خطاف الويب، يتم إرسال طلب HTTP إلى ArcGIS Notebook Server لتشغيل Notebook محدد دون أي تفاعل من المستخدم.

ملاحظة:‏

عدد دفاتر الملاحظات Notebooks التي يتم تشغيلها بشكل متزامن من خطافات الويب محدودة بخاصية النظام maxExecuteNotebookContainersPerNode في ArcGIS Notebook Server.

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

يمكن إدارة خطافات الويب من صفحة إعدادات المؤسسة. استخدم الخطوات التالية لإنشاء خطاف ويب:

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

   بشكل افتراضي، يتم أخذ جميع أنواع الأحداث (العناصر والمستخدمون والمجموعات والأدوار) في الاعتبار.

   راجع أحداث المشغل المدعومة لمزيد من المعلومات.

6. حدد دفتر ملاحظات كنوع الحمولة.

   ملاحظة:‏

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

7. حدد دفتر الملاحظات الذي سيتم تشغيله عند تشغيل خطاف الويب.
8. اختياريًا، أدخل المفتاح السري الذي سيتم تضمينه في حمولة خطاف الويب.

   يمكنك أيضًا اختيار استخدام قيم عشوائية مُنشأة مسبقًا للمفتاح السري.

9. انقر فوق إنشاء خطاف ويب لحفظ إعدادات خطاف الويب وإنشاء خطاف ويب.

إدارة خطافات ويب المؤسسة

يمكن إدارة خطافات الويب من صفحة إعدادات المؤسسة. استخدم الخطوات التالية لإدارة خطافات الويب الموجودة:

1. سجّل الدخول كمسؤول افتراضي أو كدور مخصص باستخدام امتياز خطافات الويب للمؤسسة.
2. انقر فوق المؤسسة > إعدادات > خطافات الويب لرؤية قائمة بخطافات الويب الخاصة بالمؤسسة التي أنشأتها أنت ومسؤولو خطافات الويب الآخرون.

يمكنك إدارة خطافات الويب الموجودة لديك من خلال العمليات التالية.

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

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

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

1. سجّل الدخول كمسؤول افتراضي أو كدور مخصص باستخدام امتياز خطافات الويب للمؤسسة.
2. انقر فوق إعدادات > المؤسسة > خطافات الويب.
3. في قسم خطافات الويب الخاصة بالمؤسسة، انقر فوق الإعدادات المتقدمة لتعديل القيم الافتراضية لخصائص خطاف الويب المتقدمة.

حمولة خطافات الويب (Webhooks) الخاصة بالمؤسسة

عند تشغيل Notebook من خطاف ويب، يتم إدراج معلومات حمولة خطاف الويب تلقائيًا في Notebook في خلية أولية. بمجرد إدراجها، يمكن استخدام المعلومات الواردة في حمولة خطاف الويب في دفتر الملاحظات لمزيد من دورات سير عمل التشغيل التلقائي.

معلومات حمولة خطاف الويب المضمنة في دفتر ملاحظات:

webhookPayload = {
    "properties": {
        "itemId": "<notebook_item_id>"
    },
    "events": [
        {
            "source": "<items | user | group | role>",
            "id": "<source_id>",
            "userId": "<user_id_of_member_triggered_webhook>",
            "when": 1742596800000,
            "operation": "<operation_triggered_webhook>",
            "properties": {"<operation_details>"},
            "username": "<username_of_member_triggered_webhook>"
        }
    ],
    "info": {
        "webhookId": "<webhook_id>",
        "portalURL": "<portal_url>",
        "webhookName": "<webhook_name>",
        "when": 1742596805000
    }
}

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

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

توضح الأقسام التالية كيفية إعداد جهاز استقبال خطاف الويب لـ Notebook في ArcGIS Notebook Server.

إنشاء مفتاح واجهة برمجة التطبيقات ونسخه

مفتاح API هو رمز طويل الأمد يتيح لخطاف ويب الخدمة تشغيل Notebook مرتبط والوصول بأمان إلى إمكانات ووظائف ArcGIS Enterprise اللازمة لتشغيله.

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

لإنشاء مفتاح واجهة برمجة التطبيقات ونسخه، أكمل الخطوات التالية:

1. سجّل الدخول إلى بوابتك الإلكترونية كمستخدم إداري.
2. انقر فوق صفحة تفاصيل العنصر الخاصة بعنصر مفتاح API.
3. اتبع الخطوات في البرنامج التعليمي إنشاء مفتاح واجهة برمجة التطبيقات (API) لمعرفة خطوات كيفية إنشاء مفتاح API ونسخه. امنح صلاحيات "إنشاء وتحرير دفاتر الملاحظات (Notebooks)"، و"إنشاء وتحديث وحذف العناصر"، وبشكل اختياري، امنح صلاحية "دفتر الملاحظات المتقدم (Advanced notebook)" لاستخدام ArcPy.

   قد تكون هناك حاجة إلى صلاحيات إضافية حسب سير العمل الذي يتم تنفيذه داخل دفتر الملاحظات.

تسجيل جهاز استقبال خطافات الويب لـ Notebook

لتسجيل جهاز استقبال خطافات الويب لـ Notebook، أكمل الخطوات التالية:

1. سجّل الدخول إلى البوابة الإلكترونية كمسئول.
2. انقر فوق المؤسسة > إعدادات > خطافات الويب > إنشاء جهاز استقبال خطاف الويب.
3. اكتب اسمًا لجهاز استقبال خطاف الويب.
4. حدد دفتر الملاحظات الذي سيقوم جهاز استقبال خطاف الويب بتشغيله.
5. أدخل مفتاح السر المكون من 32 رمزًا الذي سيُستخدم لضمان أصل خطاف الويب.
6. أدخل قائمة مفصولة بفواصل من رؤوس التوقيع التي سيتم التحقق منها لاكتشاف الحمولة المشفّرة.
7. أدخل الرمز المميز لواجهة برمجة التطبيقات الذي يمتلك امتيازات الوصول إلى عنصر دفتر الملاحظات، وامتيازات إنشاء دفتر ملاحظات/إنشاء دفتر ملاحظات متقدم، وأي إمكانات أخرى خاصة بنظام المعلومات الجغرافية داخل الدفتر.
8. اختياريًا، أدخل معلمات تنسيق JSON.
9. انقر فوق إنشاء جهاز الاستقبال.

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

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

1. استخدم عنوان URL لمستقبل خطاف الويب والعناوين السرية وعناوين التوقيع لإنشاء خطاف ويب لخدمة.
2. تحقق من تشغيل Notebook المرتبط بمستقبل خطاف الويب لـ Notebook في كل مرة يتم فيها تشغيل حدث خطاف ويب لخدمة معينة.

حمولة خطافات الويب (Webhooks) الخاصة بالخدمات

عند تشغيل Notebook من خطاف ويب، يتم إدراج معلومات حمولة خطاف الويب تلقائيًا في Notebook في خلية أولية. بمجرد إدراجها، يمكن استخدام المعلومات الواردة في حمولة خطاف الويب في دفتر الملاحظات لمزيد من دورات سير عمل التشغيل التلقائي.

خطافات ويب خدمة المعلم

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

webhookPayload = {
    "serviceType": "FeatureServer",
    "changesUrl": "<change_url>",
    "name": "<webhook_name>",
    "id": "<webhook_id>",
    "folderName": "<folder_name>",
    "serviceName": "<service_name>",
    "events": [
        {
            "eventType": "FeaturesCreated",
            "when": 1740436800000
        },
        {
            "eventType": "FeaturesDeleted",
            "when": 1740436810000
        },
        {
            "eventType": "FeaturesUpdated",
            "when": 1740436820000
        }
    ]
}

خطافات الويب الخاصة بخدمة المعالجة الجغرافية

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

webhookPayload = {
    "serviceType": "GPServer",
    "jobId": "<job_id>",
    "statusURL": "<status_url>",
    "name": "<webhook_name>",
    "taskName": "<task_name>",
    "folderName": "<folder_name>",
    "serviceName": "<service_name>",
    "events": [
        {
            "eventType": "esriJobSucceeded",
            "when": 1742337000000
        }
    ]
}