تتيح لك خدمات ArcGIS Notebook Server تنفيذ طرق متعددة لأتمتة سير العمل، بما في ذلك الأتمتة من خلال Notebook المجدولة، وخطافات الويب، والبرامج النصية المخصصة باستخدام واجهة برمجة التطبيقات الإدارية Execute Notebook.
ملاحظة:
لأتمتة دفتر ملاحظات Notebook باستخدام المهام المجدولة أو خطافات الويب أو تنفيذ واجهة برمجة التطبيقات (API) لدفتر الملاحظات Notebook، يجب أن يستخدم دفتر الملاحظات Notebook الإصدار 3.0 أو إصدار أحدث من وقت التشغيل.
تحديد موعد مهام دفتر الملاحظات
يمكن لمؤلفي Notebook جدولة ArcGIS Notebooks للتشغيل التلقائي في وقت ثابت في المستقبل، إما مرة واحدة أو على أساس متكرر. يسمح لك إنشاء المهام لجدولة دفاتر الملاحظات بأتمتة مهام سير العمل الروتينية، وتشغيل العمليات كثيفة البيانات أثناء ساعات الاستخدام خارج أوقات الذروة، وتحديث مجموعات البيانات بانتظام. على سبيل المثال، يمكنك جدولة دفتر ملاحظات للقيام بما يلي:
- استورد البيانات من مصدر عبر الإنترنت يتم تحديثه شهريًا، ونظّف البيانات تلقائيًا وطبّق التحويلات اللازمة وانقل البيانات إلى مساحة العمل الخاصة بك.
- قم بتشغيل سير عمل تحليل البيانات الضخمة والذي يتطلب قوة معالجة كبيرة طوال الليل، عندما تكون موارد جهازك غير مستخدمة
- إدارة المستخدمين الذين قاموا بإنشاء حسابات في المؤسسة الخاصة بك خلال الأسبوع الماضي وإرسال القائمة إليك عبر البريد الإلكتروني
يمكنك إنشاء مهمة واحدة أو أكثر لدفتر ملاحظات. بشكل افتراضي، يستطيع مؤلف دفتر الملاحظات أو المسؤول إنشاء 20 مهمة كحد أقصى. إذا تغييرت ملكية دفتر الملاحظات، فسيتم إلغاء تنشيط أي مهام مرتبطة بدفتر الملاحظات هذا وتعيينها إلى المالك الجديد.
تتيح لك المهام المجدولة تحديد معلمات دفاتر الملاحظات. عند تحديد معلمات دفتر ملاحظات، فإنه يسمح لك بكتابة رمز عام يمكن تكييفه مع المدخلات المختلفة دون تفاعلك. يتم إدخال المعلمات المختارة في دفتر الملاحظات عند تشغيل مهمة ويمكن حفظها اختياريًا في دفتر الملاحظات. على سبيل المثال، يمكن استخدام دفتر الملاحظات المحدد له معلمات لإنشاء تقارير تلوث الهواء على نطاق المنطقة بشكل متكرر. يمكن أن يحتوي دفتر الملاحظات على مهام مجدولة متعددة، واحدة لكل منطقة يتم دراستها، ولكل مهمة، ويمكن إدخال مدخلات ذات معلمات مثل اسم المدينة ونوع التلوث في دفتر الملاحظات.
ملاحظة:
يتم تقييد عدد مهام دفتر الملاحظات التي يتم تشغيلها بشكل متزامن بواسطة خاصية النظام maxExecuteNotebookContainersPerNode في Notebook Server.
يمكنك تكوين المهمة لحفظ حالة دفتر الملاحظات في عنصر دفتر الملاحظات الأصلي بعد الانتهاء.
سيتم حفظ عرض HTML ثابت لدفتر الملاحظات لكل مهمة مجدولة يتم تشغيلها.
باستخدام نافذة إدارة المهام من الصفحة الرئيسية ArcGIS Notebook Server أو صفحة المهام في مدير ArcGIS Notebook Server ، يمكن للمسؤولين عرض التفاصيل وتحرير مهام Notebook النشطة وإيقافها مؤقتًا واستئنافها وحذفها في الموقع. يمكن للمسؤولين ومؤلفي دفتر الملاحظات الذين يتمتعون بامتياز جدول دفتر الملاحظات عرض التفاصيل والتحرير والإيقاف المؤقت والاستئناف أو حذف مهمة دفتر الملاحظات في صفحة التفاصيل الخاصة بدفتر الملاحظات أو في جزء المهام بمحرر دفتر الملاحظات.
إذا كان لا يزال تشغيل مهمة سابقة قيد التشغيل، فسيتم تخطي مهمة مجدولة جديدة. على سبيل المثال، إذا تمت جدولة مهمة للتشغيل كل 15 دقيقة، ولكن تم تشغيل مثيل لهذه المهمة لمدة 20 دقيقة، فسيتم تخطي التشغيل المجدول التالي. في حالة حدوث ذلك بانتظام، يجب على مالك المهمة ضبط الفاصل الزمني المجدول بحيث لا يكون هناك تداخل بين عمليات التشغيل.
لمزيد من المعلومات حول مهام دفتر الملاحظات المجدولة، راجع موضوع التعليمات جدولة مهمة دفتر ملاحظات.
حدود المهام المجدولة
توجد حدود معينة لمستوى المستخدم والمؤسسة وموقع ArcGIS Notebook Server (الجهاز) تتعلق بمهام دفتر الملاحظات المجدولة.
تغيير الحد الأقصى لعمليات تشغيل Notebook التلقائية المتزامنة (maxExecuteNotebookContainersPerNode)
عند تشغيل Notebook بواسطة مهمة مجدولة أو خطاف ويب أو واجهة برمجة تطبيقات Execute Notebook، تفتح ArcGIS Notebook Server تلقائيًا نشر حاويةجديدًا وتشغل Notebook دون تفاعل المستخدم. بشكل افتراضي، يتم تكوين ArcGIS Notebook Server لتشغيل 10 عمليات تشغيل متزامنة بحد أقصى لـ Notebook لكل جهاز Notebook Server . بالنظر إلى الموارد (وحدة المعالجة المركزية والذاكرة العشوائية) المتوفرة على كل جهاز في الموقع Notebook Server، يمكن للمسؤول ضبط هذا الحد عن طريق تعديل خاصية النظام maxExecuteNotebookContainersPerNode في Notebook Server. ستتم إضافة أي طلب دفتر ملاحظات تلقائي يتم إرساله بعد تجاوز هذا الحد إلى قائمة الانتظار وتشغيله بمجرد انخفاض عدد عمليات تشغيل المهام التلقائية عن هذا الحد. ستفشل المهام الموضوعة في قائمة الانتظار إذا تجاوز وقت الانتظار وقت المهلة.
ملاحظة:
وهذا لا يحد من عدد دفاتر الملاحظات التي يتم تشغيلها بشكل تفاعلي من محرر دفتر الملاحظات.
يمكنك تغيير حد maxExecuteNotebookContainersPerNode باتباع الخطوات التالية.
ملاحظة:
يمكن أن تؤدي زيادة الحد إلى استخدام موارد إضافية على Notebook Server في الجهاز.
- سجّل الدخول إلى بوابة ArcGIS Enterprise الإلكترونية كمسؤول.
- افتح مدير ArcGIS Notebook Server.
- النقر فوق الإعدادات > الموقع.
- قم بتغيير قيمة خاصية maxExecuteNotebookContainersPerNode.
- انقر فوق حفظ.
- راجع التحذير المتعلق بإعادة تشغيل Notebook Server وانقر فوق حفظ وإعادة التشغيل لحفظ التغييرات.
الحد الأقصى لمهام دفتر الملاحظات المجدولة النشطة لكل مستخدم
يمكن لكل مؤلف دفتر ملاحظات يتمتع بامتياز جدولة دفاتر الملاحظات إنشاء ما يصل إلى 20 مهمة نشطة في دفتر الملاحظات كحد أقصى. بمجرد الوصول إلى هذا الحد، يتعذر على المستخدم إنشاء مهام مجدولة جديدة. يمكن إنشاء مهمة جديدة بمجرد تغيير مهمة موجودة من نشطة إلى كاملة أو فاشلة أو غير نشطة. يمكن تغيير هذا الحد عن طريق تحديث الخاصية ExecuteNotebooksUserLimit باستخدام عملية تحديث حدود النظام في واجهة برمجة تطبيقات ArcGIS Portal Administrator.
الحد الأقصى لمهام دفتر الملاحظات المجدولة النشطة لكل مؤسسة
يقتصر الحد الأقصى لمهام دفتر الملاحظات المجدولة النشطة للمؤسسة على 200 مهمة. يمثل هذا الحد العدد الإجمالي للمهام النشطة التي يمكن أن يمتلكها جميع المستخدمين عبر المؤسسة. بمجرد الوصول إلى هذا الحد، يتعذر على المستخدمون إنشاء مهام Notebook مجدولة جديدة. يمكن تغيير هذا الحد من خلال تحديث ExecuteNotebooksOrgLimitعملية تحديث حدود النظامفي واجهة برمجة تطبيقات ArcGIS Portal Administrator.
عدد النتائج التي يتم الإبلاغ عنها لمهمة مجدولة
يتم الإبلاغ عن نتائج المهمة والاحتفاظ بها لمدة 30 مرة. يتم حذف أي مهمة يتم تشغيلها قبل آخر 30 عملية تشغيل للمهمة نهائيًا. يمكن تغيير هذا الحد عن طريق تحديث الخاصية TaskRunHistoryCount باستخدام عملية تحديث حدود النظام في واجهة برمجة تطبيقات ArcGIS Portal Administrator.
الفشل التلقائي للمهمة
سيتم تحويل أي مهمة تفشل خمس مرات متتالية تلقائيًا إلى حالة فشل ولن يتم تشغيلها بعد الآن. يجب أن يتأكد مالك المهمة من إمكانية تشغيل دفتر الملاحظات بنجاح دون أي تدخل من المستخدم قبل إعادة تنشيط المهمة. لضمان استمرار تشغيل المهام، يجب على مالك المهمة تحديد الفشل وتصحيحه وتغيير المهمة إلى الحالة النشطة. يمكن تغيير هذا الحد عن طريق تحديث الخاصية FailedRunsDisableTask باستخدام عملية تحديث حدود النظام في واجهة برمجة تطبيقات ArcGIS Portal Administrator.
قم بتشغيل واجهة برمجة تطبيقات Notebook API
يمكن للمسؤولين ومؤلفي دفتر الملاحظات أيضًا أتمتة دفتر ملاحظات ليتم تشغيله بدون تدخل المستخدم باستخدام عملية تنفيذ دفتر الملاحظات في ArcGIS Notebook Server دليل المسؤول. ستعمل هذه العملية تلقائيًا على تشغيل دفتر ملاحظات عند الاتصال به، ولكن باستخدام البرنامج النصي المخصص، يمكنك جدولته ليتم تشغيله تلقائيًا في وقت محدد أو وفقًا لجدول مواعيد منتظم. يمكن أيضًا استخدام وظيفة cron أو برنامج جدولة Windows لجدولة عملية تنفيذ دفتر الملاحظات للتشغيل في وقت محدد أو في فترة زمنية متكررة.
لمعرفة المزيد، يُرجى الاطلاع على موضوع تنفيذ Notebook في دليل مرجع دليل المسؤول.