نشر دفتر ملاحظات كأداة ويب

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

يتم دعم نشر دفتر ملاحظات كأداة ويب لدفاتر الملاحظات ذات إصدار وقت التشغيل 6.0 أو أحدث. للتحقق من معلومات وقت تشغيل دفتر الملاحظات، انقر فوق زر المعلومات في الشريط العلوي لمحرر دفتر الملاحظات أو في علامة تبويب الإعدادات في صفحة عنصر دفتر الملاحظات. راجع عرض مكتبات Python المتوفرة لمعرفة المزيد حول أوقات تشغيل دفتر الملاحظات.

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

ملاحظة:‏

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

ملاحظة:‏

تُدعم أنواع البيانات التالية كمعلمات إدخال أو إخراج: سلسلة وطويلة ومزدوجة ومنطقية ومجموعة معالم ومجموعة سجلات وتاريخ ووحدة خطية وطبقة بيانات نقطية وملف. لمزيد من المعلومات، راجع أنواع بيانات خدمات المعالجة الجغرافية في وثائق ArcGIS REST API.

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

ملاحظة:‏

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

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

ملاحظة:‏

إذا كنت لا ترى خيارات المعلمات أو النشر في محرر دفتر الملاحظات، فإما أنك لا تملك امتياز نشر أدوات الويب أو أنك لست مالك دفتر الملاحظات. إذا كنت في دفتر ملاحظات تم إنشاؤه حديثًا، فلن يتم عرض خيارات المعلمات والنشر حتى يتم حفظ دفتر الملاحظات.

تكوين معلمات الإدخال

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

1. في محرر دفتر الملاحظات، انقر فوق المعلمات.
2. انقر على إضافة.
3. تحديد إدخال للإتجاه.
4. أدخل اسمًا لاسم المتغير.

   ملاحظة:‏

   يجب أن يتطابق هذا مع اسم متغير موجود في رمز دفتر الملاحظات أو تم تكوينه بالفعل في دفتر الملاحظات.

5. أدخل اسمًا لاسم العرض لمعلمة أداة الويب.
6. من القائمة المنسدلة نوع البيانات، حدد نوع البيانات لمعلمة الإدخال.
7. أدخل قيمة للقيمة الافتراضية لمعلمة الإدخال. ارجع إلى أنواع بيانات خدمات المعالجة الجغرافية لبناء جملة القيم الافتراضية لأنواع البيانات المدعومة.
8. بالنسبة إلى الوصف، أدخل وصفًا لمعلمة الإدخال.
9. انقر على حفظ لحفظ معلمة الإدخال.
10. لإضافة المزيد من معلمات الإدخال، كرر الخطوات من 1 إلى 9.
11. بعد إضافة جميع معلمات الإدخال، حدد خلية في دفتر ملاحظاتك لإدراج المعلمات فيها وانقر فوق إدراج كمتغيرات.
12. انقر على حفظ لحفظ دفتر الملاحظات.

تكوين معلمات الإخراج

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

1. في محرر دفتر الملاحظات، انقر فوق المعلمات.
2. انقر على إضافة.
3. حدد الإخراج لمعلمة الاتجاه.
4. أدخل اسمًا لاسم المتغير.

   ملاحظة:‏

   يجب أن يتطابق هذا مع اسم متغير موجود في رمز دفتر الملاحظات أو تم تكوينه بالفعل في دفتر الملاحظات.

5. أدخل اسمًا لاسم العرض لمعلمة أداة الويب.
6. من القائمة المنسدلة نوع البيانات، حدد نوع البيانات لمعلمة الإخراج.
7. أدخل قيمة للقيمة الافتراضية لمعلمة الإخراج. ارجع إلى أنواع بيانات خدمات المعالجة الجغرافية لبناء جملة القيم الافتراضية لأنواع البيانات المدعومة.
8. بالنسبة إلى الوصف، اكتب وصفًا لمعلمة الإخراج.
9. انقر على حفظ لحفظ معلمة الإخراج.
10. حدد خلية في دفتر الملاحظات. انقر فوق الزر إضافة لإضافة قصاصة Python البرمجية لكتابة مخرجات أداة الويب.

    يوصى بتحديد خلية بالقرب من الجزء السفلي من دفتر الملاحظات، أسفل الخلايا التي تم فيها إنشاء المخرجات.

11. افحص القصاصة البرمجية المضافة للتأكد من تطابق أسماء متغيرات الإخراج مع الإخراج المحدد في دفتر الملاحظات، وقم بإجراء أي تعديلات إضافية على القصاصة البرمجية.
12. كرر الخطوات من 1 إلى 11 لأي معلمات إخراج إضافية.
13. انقر على حفظ لحفظ دفتر الملاحظات.

نشر أداة ويب

يمكنك نشر دفتر ملاحظات كأداة ويب من جزء النشر في محرر دفتر الملاحظات.

1. احفظ دفتر ملاحظاتك للتأكد من نشر أحدث نسخة من دفتر الملاحظات.
2. شغّل يدويًا خلايا دفتر الملاحظات بشكل تفاعلي لضمان عدم وجود أخطاء.

ملاحظة:‏

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

مشاركة أداة الويب

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

ملاحظة:‏

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

ملاحظة:‏

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

1. تحقق مما إذا كنت قد قمت بتسجيل الدخول إلى Portal for ArcGIS ولديك الامتيازات الكافية لمشاركة المحتوى مع مؤسستك.
2. انقر على المحتوى.
3. حدد المربع بجوار عنوان أداة الويب التي تريد مشاركتها.
4. انقر على مشاركة.
   1. حدد المؤسسة لمشاركة أداة الويب مع جميع المستخدمين في مؤسستك.
   2. انقر فوق تحرير مشاركة المجموعة لمشاركة أداة الويب مع مجموعات محددة.
   3. حدد المجموعات التي تريد المشاركة معها.
   4. انقر على موافق.
   5. انقر حفظ.

استبدال أداة ويب

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

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

   ملاحظة:‏

   لا تقم بتشغيل الخلايا التي تحتوي على قصاصات برمجية لمعلمات الإخراج، إذ إنها لن تعمل في الوضع التفاعلي.

5. انقر فوق نشر.
6. انقر فوق استبدال لاستبدال أداة الويب.

حذف أداة الويب

يمكنك حذف أداة ويب تم نشرها من دفتر ملاحظات Notebook عن طريق حذف عنصر أداة الويب.

1. في الشريط العلوي لمحرر دفتر الملاحظات، انقر فوق نشر.
2. انقر على عرض التفاصيل لعرض صفحة تفاصيل العنصر لأداة الويب.
3. انقر فوق إعدادات.
4. انقر فوق حذف العنصر وتأكيد رغبتك في إزالة عنصر أداة الويب وخدمة المعالجة الجغرافية التي تم نشرها على ArcGIS Notebook Server.

ملاحظة:‏

إذا تم حذف عنصر دفتر الملاحظات Notebook الذي يتم منه نشر أداة الويب، فسيتم حذف عنصر أداة الويب أيضًا.

تحرير معلمة إدخال أو إخراج موجودة

يمكنك إجراء تغييرات على معلمة إدخال أو إخراج موجودة من جزء المعلمات في محرر دفتر الملاحظات.

ملاحظة:‏

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

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

حذف معلمة إدخال أو إخراج موجودة

يمكنك حذف معلمات الإدخال أو الإخراج الموجودة من جزء المعلمات.

1. في الشريط العلوي لمحرر دفتر الملاحظات، انقر فوق المعلمات.
2. انقر فوق زر الخيارات بجوار المعلمة وانقر فوق حذف.
3. انقر فوق حذف لإزالة المعلمة بشكل دائم.
4. امسح أو أزل متغير الإدخال أو القصاصة البرمجية للإخراج في دفتر الملاحظات يدويًا.
5. انقر على حفظ لحفظ دفتر الملاحظات.

استخدام نطاق الخريطة

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

context = {
    "extent": {
        "ymin": 1759249.9654418486,
        "xmin": 6481923.176042713,
        "ymax": 1795442.256243616,
        "xmax": 6531137.243576055,
        "spatialReference": {"latestWkid": 2229, "wkid": 102645},
    },
    "outSR": {"latestWkid": 4269},
}

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

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

استكشاف أخطاء تشغيل أداة الويب وإصلاحها

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

1. في متصفح الويب، افتح ArcGIS Notebook Server دليل الخدمات https://notebookserver.domain.com/webadaptorcontext/rest/services.
2. سجّل الدخول بصفتك مالك أداة الويب.
3. حدد الخدمة وانتقل إلى صفحة المهام.
4. انقر على وظيفة الإرسال.
5. أدخل أي معلمات إدخال وانقر على وظيفة الإرسال.
6. اختياريًا، انقر فوق الرابط التحقق من تفاصيل الوظيفة مرة أخرى للتحقق من حالة الوظيفة.

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

7. قم بتنزيل HTML وعرض معاينته لدفتر الملاحظات للتحقق مما إذا كانت هناك أي مشكلات في تشغيل أداة الويب.
8. إذا فشلت أداة الويب، فتأكد من تشغيل دفتر الملاحظات بنجاح في محرر دفتر الملاحظات.