يتيح لك ArcGIS Notebook Server، المقدم في ArcGIS Enterprise 11.0 تصفح الأجزاء المكتوبة مسبقًا من التعليمات البرمجية القابلة لإعادة الاستخدام والمعروفة باسم أجزاء التعليمات البرمجية وإدراجها في دفتر الملاحظات.

إنشاء أجزاء التعليمات البرمجية

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

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

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

لإنشاء مكتبة أجزاء التعليمات البرمجية، أكمل الخطوات التالية:

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

إضافة جزء تعليمة برمجية

بمجرد إنشاء مكتبة، يمكنك إضافة أجزاء التعليمات البرمجية إليها. لإضافة جزء تعليمة برمجية، قم بما يلي:

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

   تعرض القائمة المنسدلة تحديد عنصر مكتبة أجزاء التعليمات البرمجية المكتبات التي يمكنك إضافة جزء التعليمة البرمجية الخاصة بك إليها. تشير القائمة أيضًا إلى عدد أجزاء التعليمات البرمجية الموجودة في تلك المكتبة التي تم تعيين المشاركة لها على اكتساب.

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

   ملاحظة:‏

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

5. انقر حفظ.

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

إدراج جزء تعليمات برمجية

باستخدام جزء أجزاء التعليمات البرمجية، أكمل الخطوات التالية لإدراج جزء التعليمات البرمجية:

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

فيما يلي مثال على جزء تعليمات برمجية تمت إضافته إلى دفتر الملاحظات.

# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
    if "admin" in gis.__dict__:
        credits = gis.admin.credits.credits
        print(f"This ArcGIS Online organization has {credits} credits.")
    else:
        print("Please connect to the ArcGIS Online organization as an administrator to check credits.")

# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")

# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)

أجزاء التعليمات البرمجية في Esri

يتم تنسيق كل أجزاء التعليمات البرمجية من قبل Esri. تتيح لك أجزاء التعليمات البرمجية المنسقة هذه تنفيذ تدفقات عمل نظام المعلومات الجغرافية "GIS" الشائعة في دفاتر الملاحظات. تتم كتابة أجزاء التعليمات البرمجية كوظائف Python يمكن إدخالها في دفتر الملاحظات الخاص بك واستدعاؤها من خلاله. يمكن أيضًا تحرير جزء تعليمات برمجية بمجرد إضافته إلى دفتر الملاحظات.

ملاحظة:‏

في 11.0، تتوفر أسماء وأوصاف أجزاء التعليمات البرمجية المنسقة باللغة الإنجليزية فقط.

فيما يلي أجزاء التعليمات البرمجية المتاحة التي يمكن إدخالها في دفتر الملاحظات:

1. إدارة نظام المعلومات الجغرافية—أجزاء التعليمات البرمجية التي تؤدي مهام إدارة نظام المعلومات الجغرافية الشائعة.

   ملاحظة:‏

   تتطلب العديد من أجزاء التعليمات البرمجية هذه اتصال المسؤول.

   • تحقق من الاعتمادات المتبقية (ArcGIS Online فقط).
   • تحقق من اعتمادات مستخدم معين (ArcGIS Online فقط).
   • الحصول على عنوان URL للخدمة الأساسية لعنصر طبقة.
   • سجلات بوابة الاستعلام وحفظها بتنسيق CSV (ArcGIS Enterprise فقط)
   • تسجيل الدخول إلى البوابة الإلكترونية لـ ArcPy
2. إدارة المحتوى—أجزاء التعليمات البرمجية تساعد في إدارة المحتوى في نظام المعلومات الجغرافية والملفات في دليل مساحة عمل دفتر الملاحظات.
   • نسخ قاعدة البيانات الجغرافية في دليل مساحة العمل.
   • إنشاء قاعدة بيانات جغرافية للملفات مع تصنيف معلم فارغ.
   • إنشاء مجلد في دليل مساحة العمل.
   • تنزيل عنصر الملف من البوابة إلى دليل مساحة العمل.
   • إدراج مجموعات البيانات.
   • إدراج الملفات.
   • إزالة قاعدة بيانات جغرافية للملف في دليل مساحة العمل.
   • إزالة مجلد في دليل مساحة العمل.
   • فك ضغط الملف إلى دليل مساحة العمل.
3. علم البيانات وتحليلها—أجزاء التعليمات البرمجية التي يمكن تنفيذها في سير عمل علوم البيانات وتحليلها باستخدام ArcGIS API for Python وArcPy، ومكتبات Python الأخرى.

   ملاحظة:‏

   استخدم وقت تشغيل دفتر الملاحظات المتقدم لتشغيل أجزاء التعليمات البرمجية التي تتطلب ArcPy. لمزيد من المعلومات حول أوقات تشغيل دفتر الملاحظات، راجع تحديد وقت تشغيل دفتر الملاحظات.

   • تحويل تصنيف معالم إلى طبفة معالم.
   • تحويل تصنيف معالم إلى Spatially Enabled DataFrame.
   • تحويل طبقة معالم إلى Spatially Enabled DataFrame.
   • تحويل Spatially Enabled DataFrame إلى تصنيف المعالم.
   • عرض صورة من عنوان URL.
   • عرض صورة من دليل مساحة العمل.
   • تعبئة القيم المفقودة.
   • قم بسرد الحقول في تصنيف معالم.
   • قم بسرد الحقول في طبقة.
   • إدراج الطبقات في عنصر.
   • رسم Spatially Enable DataFrame (بداية سريعة).
   • رسم Spatially Enable DataFrame مع عارض استراحة التصنيف.
   • رسم Spatially Enable DataFrame مع عارض بسيط.
   • رسم Spatially Enable DataFrame مع عارض قيمة فريدة.
   • نشر Spatially Enabled DataFrame على أنه طبقة معالم.