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

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

ملاحظة:‏

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

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

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

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

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

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

ملاحظة:‏

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

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

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

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

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

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

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

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

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

ملاحظة:‏

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

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

يمكن إدارة خطافات الويب فقط عبر دليل بوابة ArcGIS (مشاركة API). استخدم الخطوات التالية لإنشاء خطاف ويب:

1. استعرض دليل بوابة ArcGIS.
   https://machine.domain.com/webadaptor/sharing/rest
2. قم بتسجيل الدخول بصفتك مسؤولًا.

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

   تظهر صفحة المستخدم المسؤول.

3. انقر على الارتباط التشعبي معرف المؤسسة أو قدم طلبا للنموذج أدناه، للذهاب إلى صفحة الموارد الذاتية بالبوابة.
   https://machine.domain.com/webadaptor/sharing/rest/portals/<orgID>
4. مرر لأسفل الصفحة، إلى Webhooks، أسفل موارد الطفل.
   https://machine.domain/com/webadaptor/sharing/rest/portals/<orgID>/webhooks
5. أسفل العملية المدعومة، حدد إنشاء خطاف ويب.
6. حدد معلمات خطاف الويب الخاص بك. لإنشاء خطاف ويب لأتمتة دفتر ملاحظات، قم بتوفير المعلومات التالية:

   المعلمة	التفاصيل
   name (مطلوب)	يحدد اسم خطاف الويب. مثال: name=mynotebook_webhook
   url (اختياري)	عنوان URL للحمولة غير مطلوب عند تكوين خطاف ويب لدفاتر الملاحظات، حيث سيقوم النظام باشتقاقه تلقائيًا. ليس عليك تقديم هذه المعلومات.
   config (مطلوب)	يعيّن خصائص التكوين للخطاف التلقائي لخطاب الويب. ملاحظة:‏ يجب أن تكون مسؤولاً وأن تمتلك عنصر دفتر الملاحظات ليتم تنفيذه عبر خطاف الويب. مثال: { "deactivationPolicy": { "numberOfFailures": 5, "daysInPast": 5 }, "properties": { "federatedServer": { "itemId": "<Notebook item id to be executed>", "tokenTypeToSend": "owner", "tokenExpirationTimeMinutes": 10 } } }
   events (اختياري)	تمثيل عنوان URI للحدث الذي سيؤدي إلى تشغيل خطاف الويب. هذه المعلمة مطلوبة إذا تم تحديد changes على أنها manual. لمزيد من المعلومات، راجع قسم أحداث التشغيل المدعومة. للحصول على أمثلة إضافية لأحداث التشغيل، راجع قسم أحداث التشغيل في إنشاء خطافات الويب في وثائق REST API. مثال: events=/items,/users

   انظر وثائق خطاف الويب REST API للحصول على تفاصيل عن تلك المعلمات.

   خطاف الويب الخاص بك مدرج الآن أسفل خطافات الويب: https://machine.domain.com/webadaptor/sharing/rest/portals/<orgID>/webhooks.

لمزيد من المعلومات حول الأتمتة باستخدام خطافات الويب، راجع موضوع التعليمات إنشاء خطافات الويب وإدارتها.

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

يمكنك إدارة خطافات الويب الخاصة بك عبر دليل بوابة ArcGIS عبر التقدم بطلب للنموذج التالي:

العمليات المدعومة لإدارة خطافات الويب الخاصة بك هي كما يلي:

• Update Webhook—تحديث معلمات خطاف الويب الخاصة بك. يمكنك تحديث الاسم أو عنوان URL الحمولة أو أحداث المشغل لخطاف الويب المحدد.
• Delete Webhook—إزالة خطاف الويب من بوابتك الإلكترونية.
• Deactivate Webhook و Activate Webhook—إلغاء تنشيط خطاف الويب الخاص بك، الذي يوقف توصيل الحمولات عند تشغيل خطاف الويب. عند إلغاء تنشيط خطاف الويب، تصبح عملية تنشيط خطاف الويب متاحة لاستئناف توصيل الحمولات.

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

انظر Webhooks API لتجد أمثلة على تلك العمليات.

لمزيد من المعلومات حول الأتمتة باستخدام خطافات الويب، راجع موضوع التعليمات إنشاء خطافات الويب وإدارتها.

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

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

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

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

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