يسمح لك 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 Enterprise Portal، يمكنك إنشاء خطافات ويب وإدارتها وتهيئتها. يمكنك تكوين خطافات الويب لتشغيل دفتر ملاحظات تملكه تلقائيًا عند وقوع أحداث مرتبطة بعناصر البوابة الإلكترونية أو المجموعات أو المستخدمين. بمجرد تشغيل خطاف ويب، يتم تقديم طلب HTTP إلى Notebook Server لتشغيل دفتر ملاحظات مختار دون أي تدخل من المستخدم.
ملاحظة:
عدد دفاتر الملاحظات التي يتم تشغيلها بشكل متزامن عبر خطافات الويب محدودة بخاصية النظام maxExecuteNotebookContainersPerNode في Notebook Server.
قم بإنشاء خطاف ويب
يمكن إدارة خطافات الويب فقط عبر دليل بوابة ArcGIS (مشاركة API). استخدم الخطوات التالية لإنشاء خطاف ويب:
- استعرض دليل بوابة ArcGIS.https://machine.domain.com/webadaptor/sharing/rest
- قم بتسجيل الدخول بصفتك مسؤولًا.
يمكن إنشاء خطافات الويب فقط وإدارتها بواسطة مسؤول.
تظهر صفحة المستخدم المسؤول.
- انقر على الارتباط التشعبي معرف المؤسسة أو قدم طلبا للنموذج أدناه، للذهاب إلى صفحة الموارد الذاتية بالبوابة.https://machine.domain.com/webadaptor/sharing/rest/portals/<orgID>
- مرر لأسفل الصفحة، إلى Webhooks، أسفل موارد الطفل.https://machine.domain/com/webadaptor/sharing/rest/portals/<orgID>/webhooks
- أسفل العملية المدعومة، حدد إنشاء خطاف ويب.
- حدد معلمات خطاف الويب الخاص بك. لإنشاء خطاف ويب لأتمتة دفتر ملاحظات، قم بتوفير المعلومات التالية:
المعلمة التفاصيل 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 Enterprise.
إدارة خطافات الويب
يمكنك إدارة خطافات الويب الخاصة بك عبر دليل بوابة ArcGIS عبر التقدم بطلب للنموذج التالي:
العمليات المدعومة لإدارة خطافات الويب الخاصة بك هي كما يلي:
- Update Webhook—تحديث معلمات خطاف الويب الخاصة بك. يمكنك تحديث الاسم أو عنوان URL الحمولة أو أحداث المشغل لخطاف الويب المحدد.
- Delete Webhook—إزالة خطاف الويب من بوابتك الإلكترونية.
- Deactivate Webhook و Activate Webhook—إلغاء تنشيط خطاف الويب الخاص بك، الذي يوقف توصيل الحمولات عند تشغيل خطاف الويب. عند إلغاء تنشيط خطاف الويب، تصبح عملية تنشيط خطاف الويب متاحة لاستئناف توصيل الحمولات.
تعرض الصفحة Notification Status معلومات متصلة بأحداث المشغل المرتبطة بخطاف الويب المخصوص. يمكنك استخدام هذا الجدول لمراقبة خطاف الويب وكذلك تفاصيل الحمولات التي تم توصيلها، مثل الوقت الذي تم فيه تشغيل خطاف الويب والاستجابات المستلمة من عنوان URL الحمولة والحمولة التي تم توصيلها. تتم يوما بعد يوم إزالة السجلات التي تشير إلى تسليم ناجح للحمولة. يتم تخزين السجلات التي تشير إلى فشل محاولة التسليم لمدة سبعة أيام.
انظر Webhooks API لتجد أمثلة على تلك العمليات.
لمزيد من المعلومات عن التشغيل التلقائي باستخدام خطافات الويب، راجع خطافات الويب في موضوع تعليمات ArcGIS Enterprise.
حمولة خطاف الويب
عند تشغيل دفتر ملاحظات عبر خطاف ويب، يتم إدراج معلومات حمولة خطاف الويب تلقائيًا في دفتر الملاحظات في خلية أولية. بمجرد إدراجها، يمكن استخدام المعلومات الواردة في حمولة خطاف الويب في دفتر الملاحظات لمزيد من دورات سير عمل التشغيل التلقائي.
معلومات حمولة خطاف الويب المضمنة في دفتر ملاحظات:{
"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 لجدولة عملية تنفيذ دفتر الملاحظات للتشغيل في وقت محدد أو في فترة زمنية متكررة.
لمعرفة المزيد، راجع موضوع تنفيذ دفتر الملاحظات في الدليل المرجعي لدليل المسؤول.
الحد الأقصى لتشغيل دفتر الملاحظات الآلي المتزامن
عند تشغيل دفتر ملاحظات عبر مهمة مجدولة أو خطاف ويب أو تنفيذ واجهة برمجة التطبيقات (API) لدفتر الملاحظات، سيفتح ArcGIS Notebook Server تلقائيًا حاوية جديدة ويقوم بتشغيل دفتر الملاحظات هذا تلقائيًا دون أي تدخل من المستخدم. بشكل افتراضي، يتم تكوين ArcGIS Notebook Server لتشغيل ما لا يزيد عن 10 عمليات تشغيل متزامنة لدفتر الملاحظات لكل جهاز Notebook Server. بالنظر إلى الموارد (وحدة المعالجة المركزية وذاكرة الوصول العشوائي) المتوفرة على كل جهاز في موقع Notebook Server، يمكن للمسؤول ضبط هذا الحد عن طريق تعديل خاصية النظام maxExecuteNotebookContainersPerNode في Notebook Server.