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

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

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

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

ملاحظة:‏

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

ملاحظة:‏

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

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

ملاحظة:‏

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

ملاحظة:‏

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

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

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

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

   ملاحظة:‏

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

5. أدخل اسمًا لاسم العرض لمعلمة أداة الويب.
6. من القائمة المنسدلة نوع البيانات، حدد نوع البيانات لمعلمة الإدخال.
7. حدد مطلوب أو اختياري لنوع المعلمة.
8. بشكل اختياري، إذا كان نوع بيانات معلمات الإدخال عبارة عن سلسلة أو طويلة أو مزدوجة، فقم بتكوين قائمة الاختيار عن طريق إدخال القيم ضمن قائمة الاختيار (اختياري).

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

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

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

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

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

   ملاحظة:‏

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

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

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

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

نشر أداة ويب

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

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

ملاحظة:‏

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

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

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

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

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

ملاحظة:‏

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

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

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

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

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

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

   ملاحظة:‏

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

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

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

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

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

ملاحظة:‏

إذا تم حذف عنصر دفتر الملاحظات 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.