أتمتة مهام سير العمل باستخدام ArcGIS Notebooks

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

ملاحظة:‏

لأتمتة دفتر ملاحظات باستخدام المهام المجدولة أو خطافات الويب أو تنفيذ واجهة برمجة التطبيقات (API) لدفتر الملاحظات، يجب أن يستخدم دفتر الملاحظات وقت تشغيل الإصدار 3.0 أو أحدث.

تحديد موعد مهام دفتر الملاحظات

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

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

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

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

ملاحظة:‏

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

يمكنك تكوين المهمة لحفظ حالة دفتر الملاحظات في عنصر دفتر الملاحظات الأصلي بعد الانتهاء.

سيتم حفظ عرض HTML ثابت لدفتر الملاحظات لكل مهمة مجدولة يتم تشغيلها. بشكل افتراضي، سيتم حفظ نتائج آخر 30 مرة فقط.

باستخدام صفحة المهام في ArcGIS Notebook Server Manager، يمكن للمسؤولين عرض التفاصيل والتحرير والإيقاف المؤقت والاستئناف أو حذف كل مهمة دفتر ملاحظات نشطة في الموقع. يمكن للمسؤولين ومؤلفي دفتر الملاحظات الذين يتمتعون بامتياز جدول دفتر الملاحظات عرض التفاصيل والتحرير والإيقاف المؤقت والاستئناف أو حذف مهمة دفتر الملاحظات في صفحة التفاصيل الخاصة بدفتر الملاحظات أو في جزء المهام بمحرر دفتر الملاحظات.

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

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

لمزيد من المعلومات حول مهام دفتر الملاحظات المجدولة، راجع موضوع التعليمات جدولة مهمة دفتر ملاحظات.

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

حدود المهام المجدولة

توجد حدود معينة لمستوى المستخدم والمؤسسة وموقع ArcGIS Notebook Server (الجهاز) تتعلق بمهام دفتر الملاحظات المجدولة.

الحد الأقصى لعدد مرات تشغيل دفتر الملاحظات الآلي المتزامن (maxExecuteNotebookContainersPerNode)

عند تشغيل دفتر ملاحظات عبر مهمة مجدولة أو خطاف ويب أو تنفيذ واجهة برمجة التطبيقات (API) لدفتر الملاحظات، يفتح ArcGIS Notebook Server تلقائيًا حاوية جديدة ويقوم بتشغيل دفتر الملاحظات دون تدخل من المستخدم. بشكل افتراضي، يتم تكوين ArcGIS Notebook Server لتشغيل ما لا يزيد عن 10 عمليات تشغيل متزامنة لدفتر الملاحظات لكل جهاز Notebook Server. بالنظر إلى الموارد (وحدة المعالجة المركزية وذاكرة الوصول العشوائي) المتوفرة على كل جهاز في موقع Notebook Server، يمكن للمسؤول ضبط هذا الحد عن طريق تعديل خاصية النظام maxExecuteNotebookContainersPerNode في Notebook Server. ستتم إضافة أي طلب دفتر ملاحظات تلقائي يتم إرساله بعد تجاوز هذا الحد إلى قائمة الانتظار وتشغيله بمجرد انخفاض عدد عمليات تشغيل المهام التلقائية عن هذا الحد. ستفشل المهام الموضوعة في قائمة الانتظار إذا تجاوز وقت الانتظار وقت المهلة.

ملاحظة:‏

وهذا لا يحد من عدد دفاتر الملاحظات التي يتم تشغيلها بشكل تفاعلي من محرر دفتر الملاحظات.

يمكنك تغيير حد maxExecuteNotebookContainersPerNode باتباع الخطوات التالية.

ملاحظة:‏

يمكن أن تؤدي زيادة الحد إلى استخدام موارد إضافية في Notebook Server.

1. سجّل الدخول إلى بوابة ArcGIS Enterprise الإلكترونية كمسؤول.
2. افتح مدير ArcGIS Notebook Server.
3. النقر فوق الإعدادات > الموقع
4. قم بتغيير قيمة خاصية maxExecuteNotebookContainersPerNode.
5. انقر حفظ.
6. راجع التحذير المتعلق بإعادة تشغيل Notebook Server وانقر فوق حفظ وإعادة التشغيل لحفظ التغييرات.

الحد الأقصى لمهام دفتر الملاحظات المجدولة النشطة لكل مستخدم

يمكن لكل مؤلف دفتر ملاحظات يتمتع بامتياز جدولة دفاتر الملاحظات إنشاء ما يصل إلى 20 مهمة نشطة في دفتر الملاحظات كحد أقصى. بمجرد الوصول إلى هذا الحد، لن يتمكن المستخدم من إنشاء مهام مجدولة جديدة. يمكن إنشاء مهمة جديدة بمجرد تغيير مهمة موجودة من نشطة إلى كاملة أو فاشلة أو غير نشطة. يمكن تغيير هذا الحد عن طريق تحديث خاصية ExecuteNotebooksUserLimit باستخدام عملية تحديث حدود النظام في ArcGIS Portal Administrator API.

الحد الأقصى لمهام دفتر الملاحظات المجدولة النشطة لكل مؤسسة

يقتصر الحد الأقصى لمهام دفتر الملاحظات المجدولة النشطة للمؤسسة على 200 مهمة. يمثل هذا الحد إجمالي عدد المهام النشطة التي يمكن أن يمتلكها كافة المستخدمين عبر مؤسسة البوابة الإلكترونية. بمجرد الوصول إلى هذا الحد، لن يتمكن المستخدم من إنشاء مهام مجدولة دفتر ملاحظات جديدة. يمكن تغيير هذا الحد عن طريق تحديث خاصية ExecuteNotebooksOrgLimit باستخدام عملية تحديث حدود النظام في ArcGIS Portal Administrator API.

عدد النتائج التي يتم الإبلاغ عنها لمهمة مجدولة

يتم الإبلاغ عن نتائج المهمة والاحتفاظ بها لمدة 30 مرة. يتم حذف أي مهمة يتم تشغيلها قبل آخر 30 عملية تشغيل للمهمة نهائيًا. يمكن تغيير هذا الحد عن طريق تحديث خاصية TaskRunHistoryCount باستخدام عملية تحديث حدود النظام في ArcGIS Portal Administrator API.

الفشل التلقائي للمهمة

سيتم تحويل أي مهمة تفشل 5 مرات متتالية تلقائيًا إلى حالة فشل ولن يتم تشغيلها بعد الآن. لضمان استمرار تشغيل المهام، يجب على مالك المهمة تحديد الفشل وتصحيحه وتغيير المهمة إلى الحالة النشطة. يمكن تغيير هذا الحد عن طريق تحديث خاصية FailedRunsDisableTask باستخدام عملية تحديث حدود النظام في ArcGIS Portal Administrator API.

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

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

ملاحظة:‏

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

قم بإنشاء خطاف ويب

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

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

   Name=mynotebook_webhook

5. حدد نوع الحدث الذي سيؤدي إلى تشغيل خطاف الويب.

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

6. استخدم مشغل لقبول القيمة الافتراضية (/) أو تحديد قيمة واحدة أو أكثر كأحداث تشغيل.

   الأحداث=/ العناصر، / العناصر/ <itemId>،/المستخدمين

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

   للحصول على أمثلة إضافية، راجع أحداث المشغل.

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

   ملاحظة:‏

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

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

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

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

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

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

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

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

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

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

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

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

حمولة خطاف الويب

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

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

{
  "properties": {
    "itemId": "<itemId of the current notebook>"
  },
  "events": [
    {
      "source": "items",
      "id": "<itemId of the item that resulted in webhook trigger>",
      "userId": "<webhook user>",
      "when": \<epoch time in ms when webhook was triggered\>,
      "operation": "<type of operation that resulted in webhook trigger>",
      "properties": {},
      "username": "<webhook username>"
    }
  ],
  "info": {
    "webhookId": "<webhookId>",
    "portalURL": "<public portal url>",
    "webhookName": "<webhook name>",
    "when": \<epoch time in ms when webhook was triggered\>,
  }
}

تنفيذ واجهة برمجة التطبيقات (API) لدفتر الملاحظات

يمكن للمسؤولين ومؤلفي دفتر الملاحظات أيضًا أتمتة دفتر ملاحظات ليتم تشغيله بدون تدخل المستخدم باستخدام عملية تنفيذ دفتر الملاحظات في دليل مسؤول ArcGIS Notebook Server. ستعمل هذه العملية تلقائيًا على تشغيل دفتر ملاحظات عند الاتصال به، ولكن باستخدام البرنامج النصي المخصص الخاص بك، يمكنك جدولته ليتم تشغيله تلقائيًا في وقت محدد أو وفقًا لجدول مواعيد منتظم. يمكن أيضًا استخدام وظيفة cron أو برنامج جدولة Windows لجدولة عملية تنفيذ دفتر الملاحظات للتشغيل في وقت محدد أو في فترة زمنية متكررة.

لمعرفة المزيد، راجع موضوع تنفيذ دفتر الملاحظات في كتيب دليل المسؤول المرجعي.