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

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

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

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

ملاحظة:‏

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

ملاحظة:‏

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

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

ملاحظة:‏

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

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

ملاحظة:‏

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

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

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

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

   ملاحظة:‏

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

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

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

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

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

   ملاحظة:‏

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

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

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

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

نشر أداة ويب

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

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

ملاحظة:‏

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

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

يمكنك حذف خدمة معالجة جغرافية منشورة من دفتر ملاحظات بحذف عنصر أداة الويب.

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

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

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

ملاحظة:‏

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

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

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

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

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

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

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

context = {
    "extent": {
        "ymin": -25203428.462408017,
        "xmin": -46101923.491795965,
        "ymax": 25203428.462407943,
        "xmax": 46101923.491795965,
        "spatialReference": {
            "wkt": "PROJCS[\"WGS_1984_Web_Mercator_Auxiliary_Sphere\",GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Mercator_Auxiliary_Sphere\"],PARAMETER[\"False_Easting\",0.0],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",0],PARAMETER[\"Standard_Parallel_1\",0.0],PARAMETER[\"Auxiliary_Sphere_Type\",0.0],UNIT[\"Meter\",1.0]]"
        },
    }
}

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

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

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

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

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

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

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