Tareas administrativas con PortalPy mediante secuencias de comandos

PortalPy es un módulo de Python 2.7 que puede usar para programar tareas administrativas habituales mediante secuencias de comandos con su propio portal. Las secuencias de comandos de Python que aprovechan PortalPy pueden ejecutarse desde cualquier máquina con acceso a su portal siempre y cuando su máquina esté configurada para ejecutar Python 2.7 (obligatorio).

En este tema se proporciona una introducción básica al módulo PortalPy, se incluyen varias muestras e instrucciones para comenzar. El uso de PortalPy requiere habilidades de programación mediante secuencias de comandos con Python, pero proporciona el modo más flexible de automatizar verdaderamente la administración de su portal. Con PortalPy, puede automatizar todos los flujos de trabajo que ofrecen las utilidades de línea de comandos, las secuencias de comandos de muestra de Python, y mucho más.

Descarga del módulo PortalPy (.zip)

El módulo PortalPy también está disponible a través de un repositorio GitHub público. Este recurso contiene el módulo de PortalPy más actualizado además de contenido adicional contribución de la comunidad de usuarios. Para acceder a este repositorio, tendrá que crear una cuenta de GitHub o iniciar sesión con su cuenta de GitHub existente.

Configuración del módulo de PortalPy en su máquina

Para programar tareas administrativas mediante secuencias de comandos con PortalPy, tendrá que configurar el módulo PortalPy en su máquina (cualquiera que tenga acceso a su portal). Para empezar, consulte los pasos que siguen a continuación.

Pasos:

1. Descarga del módulo PortalPy (.zip) y extraiga el contenido del archivo en un directorio llamado portalpy en su máquina.
2. En la máquina que aloja el módulo PortalPy, defina una variable de entorno llamada PYTHONPATH. Especifique la ruta al directorio portalpy configurado en el paso anterior. Por ejemplo, C:\portalpy. Si necesita ayuda con este paso, consulte la documentación de producto de Windows.
3. Cree un archivo llamado test.py y coloque el siguiente código en él:

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

4. Guarde y cierre el archivo
5. Ejecute test.py desde la línea de comandos o el entorno IDLE de Python. La secuencia de comandos imprimirá un número de versión, como 2.3.

Su máquina está configurada ahora para usar el módulo PortalPy.

Documentación del módulo PortalPy

Para revisar las clases y métodos incluidos con PortalPy, consulte Módulo PortalPy. En el tema se incluyen muestras de uso que pueden ayudarle a aprender cómo programar con la API REST ArcGIS usando el módulo PortalPy.

Secuencia de comandos de ejemplo

Entre las tareas administrativas habituales que se pueden programar mediante secuencias de comandos con PortalPy se incluyen las siguientes:

Ejemplo: Enumerar los usuarios de un grupo

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

Ejemplo: Crear un grupo

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

Ejemplo: Eliminar un usuario y reasignar el contenido de dicho usuario a otro usuario

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