ملاحظة:
تتوفر بيئة برمجة Insights النصية في Insights in ArcGIS Enterprise وInsights desktop. يمكن أن يكون الاتصال الأساسي إما Insights in ArcGIS Enterprise أو Insights in ArcGIS Online
يمكن تعطيل موصلات Jupyter Kernel Gateway لمؤسسة Insights in ArcGIS Enterprise أثناء عملية التثبيت. اتصل بالمسؤول إذا كانت اتصالات Jupyter Kernel Gateway غير متوفرة. لمزيد من المعلومات، راجع موضوع تثبيت Insights in ArcGIS Enterprise.
بعد إجراء الاتصال بـ Jupyter Kernel Gateway، يمكن الوصول إلى بيئة البرمجة النصية والاستعانة بها في إنشاء البرامج النصية وتشغيلها في Python وR. تتكون بيئة البرمجة النصية من خلية In[ ]، حيث يتم تحميل البرامج النصية أو كتابتها وخلية Out[ ]، حيث يتم عرض النتائج وشريط الأدوات.
فتح بيئة البرمجة النصية
لاستخدام بيئة البرمجة النصية، يتعين عليك أولاً إعداد Jupyter Kernel Gateway وإنشاء اتصال بالبوابة. بمجرد إعداد الاتصال بالبوابة، أكمل الخطوات التالية لفتح بيئة البرمجة النصية والبدء في كتابة البرامج النصية:
- افتح مصنفًا وأضف البيانات، إذا لزم الأمر.
تلميح:
يمكنك أيضًا تحميل البيانات من داخل بيئة البرمجة النصية.
- انقر فوق زر البرمجة النصية
في شريط أدوات المُصنّف. - إذا لم يُحفظ أي اتصال في المصنف سابقًا، فعليك بالقيام بأي مما يلي:
- في Insights desktop، إذا ظهرت نافذة اتصال Jupyter Kernel Gateway جديد، فهذا يعني أنك لم تجري إعداد الاتصال بالبوابة. أدخل عنوان URL وعنوان الويب الخاص بالبوابة لإنشاء الاتصال. راجع الاتصال ببوابة kernel لمزيد من المعلومات.
- في Insights in ArcGIS Enterprise، إذا ظهرت نافذة اتصال Kernel Gateway، فحدد اتصال Kernel Gateway موجود من قائمة اسم البيئة. يمكنك أيضًا إنشاء اتصال على علامة تبويب إضافة جديد. راجع الاتصال ببوابة kernel لمزيد من المعلومات.
تُفتح بيئة البرمجة النصية ويُضاف عنوان البرامج النصية إلى جزء البيانات.
- من قائمة تحديد Kernel، اختر Kernel التي تريد استخدامها للبرمجة النصية.
بناءً على اتصال بوابة kernel الذي تستخدمه، ستكون الخيارات إما Python أو R أو كلاهما.
يتم تحديث بيئة البرمجة النصية لتضمين خلية In[ ] إلى جانب شريط الأدوات.
أصبحت بيئة البرمجة النصية جاهزة الآن لاستخدام البرامج النصية وإنشائها وتحميلها وتشغيلها.
يتم حفظ البرنامج النصي تلقائيًا تحت عنوان البرامج النصية في جزء البيانات باسم Insights Script. يمكنك إعادة تسمية البرنامج النصي باستخدام زر إعادة تسمية البرنامج النصي 
.
تتوفر أيضًا الخيارات التالية للبرنامج النصي باستخدام زر خيارات مجموعة البيانات 
:
- فتح—تحميل البرنامج النصي إلى خلية In[ ].
- تشغيل—تشغيل البرنامج النصي دون فتح بيئة البرمجة النصية.
- تنزيل—تنزيل البرنامج النصي كملف Jupyter Notebook (.ipynb).
- نشر—نشر البرنامج النصي لإنشاء عنصر برنامج Insights النصي (متاح في Insights in ArcGIS Enterprise).
- إزالة—إزالة البرنامج النصي من جزء البيانات.
تحرير أحد البرامج النصية
يمكنك تحرير البرامج النصية من خلايا In[ ]، حتى بعد تشغيل الخلية. لتحرير برنامج نصي، انقر داخل الخلية، وأجر التعديلات، ثم شغّل الخلية. يتم إنشاء خلية Out[ ] جديدة بالنتائج التي تم تحريرها.
تصدير البرنامج النصي
يمكنك تصدير البرامج النصية التي يتم كتابتها في بيئة البرمجة النصية وحفظها كبرامج نصية .py لـ Python أو كبرنامج نصي .R لـ R. لتصدير برنامج نصي من بيئة البرمجة النصية، حدد خلية واحدة أو أكثر، ثم انقر فوق زر التصدير 
.
تتوفر خيارات التصدير التالية عند حفظ برنامج نصي:
- تنزيل الخلايا المحددة—يحفظ فقط البرنامج النصي في خلايا In[ ] المحددة.
- تنزيل المحفوظات—يحفظ البرنامج النصي من جميع خلايا In[ ] في بيئة البرمجة النصية كملف Jupyter Notebook (.ipynb).
يتم حفظ البرامج النصية المُصدّرة في مجلد التنزيل الافتراضي على جهاز الكمبيوتر.
تحميل برنامج نصي
يمكنك إنشاء البرامج النصية مباشرة في بيئة البرمجة النصية عن طريق الكتابة في خلية In[ ]. لتحميل البرامج النصية الموجودة مسبقاً إلى بيئة البرمجة النصية، قم بما يلي:
- افتح بيئة البرمجة النصية، إذا لزم الأمر، واختر kernel الصحيح للبرنامج النصي الذي ستقوم بتشغيله.
- انقر فوق زر استيراد ملف
على شريط أدوات بيئة البرمجة النصية. - استعرض البرنامج النصي الذي تريد تشغيله وقم بفتحه.
يتم فتح البرنامج النصي في الخلية In[ ].
- انقر فوق زر تشغيل
على شريط أدوات بيئة البرمجة النصية.
يتم تشغيل البرنامج النصي وتظهر النتائج في الخلية Out[ ].
يمكن أيضًا تحميل البرامج النصية، المحفوظة في جزء البيانات، إلى بيئة البرمجة النصية. لتحميل برنامج نصي من جزء البيانات، قم بما يلي:
- قم بتوسيع عنوان البرامج النصية في جزء البيانات.
- انقر فوق زر خيارات مجموعة البياناتلمشاهدة البرنامج النصي الذي ترغب في تحميله.
- انقر على فتح.
يتم فتح البرنامج النصي في الخلية In[ ].
إنشاء بطاقة صورة
يمكن تصدير نتائج البرامج النصية، مثل المخططات من خلية Out[ ] لإنشاء بطاقة صورة على صفحة Insights الخاصة بك. لتصدير خلية، يتعين عليك تشغيل البرنامج النصي باستخدام زر تشغيل ، وتمييز خلية Out[ ] ومن ثم انقر فوق زر إنشاء بطاقة 
لنقل الصورة من أحدث خلية Out[ ] إلى بطاقة صورة.
ملاحظة:
بطاقات الصور التي تم إنشاؤها من البرامج النصية ثابتة ولا تحتوي على نفس الإمكانات التفاعلية للخريطة والمخطط وبطاقات الجدول التي تم إنشاؤها في Insights.
حفظ البرنامج النصي إلى نموذج
يمكنك إضافة البرنامج النصي من بيئة البرمجة النصية إلى نموذج كبرنامج نصي لـ Insights باستخدام زر إضافة إلى النموذج 
. يمكن تحرير البرنامج النصي Insights من تحليل العرض 
. لمزيد من المعلومات حول تحديث نموذج في Insights، راجع إعادة تنفيذ التحليل.
مسح أو إغلاق بيئة البرمجة النصية
لمسح بيئة البرمجة النصية، بما في ذلك جميع خلايا In[ ] وOut[ ]، انقر فوق زر إعادة التشغيل 
. لا يمكن التراجع عن مسح بيئة البرمجة النصية.
لإغلاق بيئة البرمجة النصية، انقر فوق زر الإغلاق 
أو انتقل إلى صفحة مختلفة في Insights.
للتبديل بين صفحة Insights وبيئة البرمجة النصية، قم بتصغير البيئة باستخدام زر التصغير 
بدلاً من إغلاقها، حتى لا تفقد برامجك النصية.