Skripterstellung für Verwaltungsaufgaben mit PortalPy

PortalPy ist ein Python 2.7-Modul, mit dem Sie Skripte für allgemeine Verwaltungsaufgaben für das eigene Portal erstellen können. Python-Skripte, die PortalPy nutzen, können über jeden Computer ausgefürt werden, der Zugriff auf Ihr Portal hat, sofern der Computer für die Ausführung von Python 2.7 (erforderlich) konfiguriert ist.

Dieses Thema enthält eine grundlegende Einführung in das PortalPy-Modul, mehrere Beispiele und Anweisungen zu den ersten Schritten. Die Verwendung von PortalPy erfordert Kenntnisse in der Skripterstellung, stellt jedoch die flexibelste Möglichkeit dar, die Verwaltung des Portals umfassend zu automatisieren. Mit PortalPy können alle Workflows automatisiert werden, die von Befehlszeilenprogrammen, Beispiel-Python-Skripten usw. bereitgestellt werden.

Laden Sie das PortalPy-Modul (.zip) herunter

Das PortalPy-Modul ist auch über ein öffentliches GitHub-Repository verfügbar. Diese Ressource enthält das aktuelle PortalPy-Modul sowie zusätzliche Inhalte, die von der Anwender-Community bereitgestellt wurden. Um auf dieses Repository zuzugreifen, müssen Sie ein GitHub-Konto erstellen oder sich mit Ihrem vorhandenen GitHub-Konto anmelden.

Konfigurieren des PortalPy-Moduls auf dem Computer

Um Skripte für Verwaltungsaufgaben mit PortalPy zu erstellen, muss das PortalPy-Modul auf dem Computer eingerichtet werden. Dabei kann es sich um einen beliebigen Computer mit Zugriff auf Ihr Portal handeln. Führen Sie zunächst folgende Schritte aus.

Schritte:
  1. Laden Sie das PortalPy-Modul (.zip) herunter , und extrahieren Sie den Inhalt der Datei in einem Verzeichnis namens portalpy auf Ihrem Computer.
  2. Legen Sie auf dem Computer, der das PortalPy-Modul hostet, eine Umgebungsvariable namens PYTHONPATH fest. Geben Sie den Pfad zum portalpy-Verzeichnis an, das im vorherigen Schritt eingerichtet wurde. Beispielsweise export PYTHONPATH=$PYTHONPATH:<path from previous step>/portalpy-master.
  3. Erstellen Sie eine Datei namens test.py, und fügen Sie den folgenden Code in die Datei ein:
    #!/usr/bin/python
    import portalpy
    url = "https://portalpy.esri.com/arcgis"
    portal = portalpy.Portal(url)
    print portal.get_version()
    
  4. Speichern und schließen Sie die Datei.
  5. Führen Sie test.py aus. Das Skript druckt eine Versionsnummer, beispielsweise 2.3.

Ihr Computer ist nun für die Verwendung des PortalPy-Moduls konfiguriert.

Dokumentation zum PortalPy-Modul

Um die in PortalPy enthaltenen Klassen und Methoden zu überprüfen, finden Sie weitere Informationen unter PortalPy-Modul. Das Thema enthält Verwendungsbeispiele mit Informationen zum Programmieren mit der ArcGIS-REST-API mit dem PortalPy-Modul.

Beispielskripte

Für folgende allgemeine Verwaltungsaufgaben können Skripte mit PortalPy erstellt werden:

Beispiel: Auflisten von Benutzern in einer Gruppe

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

Beispiel: Erstellen einer Gruppe

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

Beispiel: Löschen eines Benutzers und erneutes Zuweisen des Inhalts des Benutzers zu einem anderen Benutzer

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