استخدام أجزاء تعليمات استخدام أجزاء التعليمات البرمجية

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

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

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

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

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

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

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

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

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

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

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

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

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

     ملاحظة:‏

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

6. انقر حفظ.

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

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

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

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

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

# 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 يمكن إدخالها في دفتر الملاحظات الخاص بك واستدعاؤها من خلاله. يمكن أيضًا تحرير جزء تعليمات برمجية بمجرد إضافته إلى دفتر الملاحظات.

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

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

   ملاحظة:‏

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

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

   ملاحظة:‏

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

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