برمجة المهام الإدارية نصياً مع PortalPy

يعتبر PortalPy هو وحدة Python 2.7 النمطية التي يمكن استخدامها لكتابة المهام الإدارية المشتركة في مقابل المدخل. يمكن تنفيذ برامج بايثون النصية التي تزيد من PortalPy في أي جهاز مع الوصول إلى المدخل طالما تم تكوين الجهاز لتشغيل Python 2.7 (مطلوب).

يوفر هذا الموضوع مقدمة أساسية لوحدة PortalPy النمطية، متضمنةً عينات متعددة، وتعليمات للبدء. يتطلب استخدام PortalPy بعض مهارات برمجة البايثون، لكنه يقوم بتوفير طريقة مرنة لأتمتة الإدارة بالمدخل. مع PortalPy، يمكن أتمتة جميع مسارات العمل التي يقدمها أدوات خط الأمر المساعدةو برامج بايثون النصية للعينة،وأكثر بكثير.

يتم تثبيت وحدة PortalPy باستخدام البرنامج، وتقع في دليل الأدوات. على سبيل المثال، <Portal for ArcGIS installation directory>\tools\portalpy. تتوفر الوحدة أيضًا عبر مستودع GitHub عام. يحتوي هذا المورد على أحدث وحدة PortalPy إضافةً إلى محتوى إضافي يأتي من مجتمع المستخدمين. للوصول إلى المستودع، قم بإنشاء حساب GitHub أو سجل الدخول بحساب GitHub الحالي.

تكوين وحدة PortalPy النمطية داخل الجهاز

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

1. في الجهاز المُثبّت عليه Portal for ArcGIS، استعرض <Portal for ArcGIS installation directory>\tools وانسخ مجلد portalpy كاملاً لدليل محلي على جهازك. على سبيل المثال، C:\portalpy. إذا كان الجهاز الذي تريد تشغيل وحدة PortalPy عليه مُثبتًا عليه Portal for ArcGIS، يمكنك تخطي هذه الخطوة.
2. داخل الجهاز الذي يستضيف وحدة PortalPy النمطية، حدد متغير البيئة باسم PYTHONPATH. حدد مسار الدليل حيث يوجد portalpy.py. على سبيل المثال، C:\portalpy. إذا كنت تريد المساعدة في هذه الخطوة، ارجع إلى وثيقة منتج Windows.
3. أنشئ ملف باسم test.py وضعه في نفس الدليل حيث يوجد portalpy.py. على سبيل المثال، C:\portalpy.
4. انسخ الكود التالي إلى الملف وحدّث عنوان URL لمطابقة عنوان URL للبوابة الإلكترونية.

   #!/usr/bin/python
   import portalpy
   url = "https://portal.domain.com/arcgis"
   portal = portalpy.Portal(url)
   print portal.get_version()

   ملاحظة:‏

   إذا قمت بتكوين البوابة الإلكترونية لاستخدام مصادقة إطار الويب، يمكنك الوصول إلى البوابة الإلكترونية من خلال منفذ 7443 عند استخدام PortalPy كما هو معروض في المثال أدناه:

   #!/usr/bin/python import portalpy url = "https://portal.domain.com:7443/arcgis"
   portal = portalpy.Portal(url)
   print portal.get_version()

5. احفظ الملف وأغلقه.
6. قم بتشغيل test.py من خط الأمر أو بيئة Python IDLE. يقوم البرنامج النصي بطباعة رقم إصدار مثل 3.2.

تم تكوين الجهاز لاستخدام وحدة PortalPy النمطية.

وثيقة وحدة PortalPy النمطية

لمراجعة التصنيفات والطرق المُضمّنة في PortalPy، راجع وحدة PortalPy النمطية. يحتوي الموضوع على عينات استخدام تساعد في كيفية تعلم البرنامج في مقابل ArcGIS REST API باستخدام وحدة PortalPy النمطية.

مثال البرنامج النصية

يمكن كتابة المهام الإدارية المشتركة باستخدام PortalPy وتضمين التالي:

مثال: أدرج المستخدمين في المجموعة

portal = PortalPy.Portal(portalUrl, user, password) resp = portal.get_group_members('67e1761068b7453693a0c68c92a62e2e') for user in resp['users']:
   print user

مثال: إنشاء مجموعة

portal= PortalPy.Portal(portalUrl, user, password)
group_id = portalAdmin.create_group('my group', 'test tag', 'a group to share travel maps')

مثال: حذف المستخدم وإعادة تعيين محتوى المستخدم لمستخدم آخر

portal= PortalPy.Portal(portalUrl, user, password)
portal.delete_user('amy.user', True, 'bob.user')