Skip To Content

PortalPy-Modul

In diesem Hilfethema sind alle Klassen und Methoden im PortalPy-Modul aufgelistet, die zum Schreiben von Verwaltungsskripten für Portal for ArcGIS herangezogen werden können.

Klasse: Portal

Ein Objekt, das eine URL-Verbindung mit einem Portal darstellt. Um ein Portal-Objekt zu instanziieren, führen Sie den Code beispielsweise folgendermaßen aus:

PortalPy.Portal(portalUrl, user, password)

Die verfügbaren Portal-Methoden sind in den folgenden Abschnitten aufgeführt. Bevor Sie die Methoden verwenden, sollten Sie Folgendes berücksichtigen:

  • Gruppen-IDs: Viele Gruppenfunktionen erfordern eine Gruppen-ID. Die ID unterscheidet sich vom Namen oder Titel der Gruppe. Um die Gruppen-ID zu bestimmen, verwenden Sie die Funktion "search_groups", und geben Sie den Titel an, um die Gruppen-ID abzurufen.
  • Zeit: Bei vielen Methoden wird ein Zeitfeld zurückgegeben. Alle Zeitangaben werden ab 1. Januar 1970 in Millisekunden zurückgegeben. Python erwartet die Zeitangaben seit 1. Januar 1970 in Sekunden; daher sollten Sie Zeitangaben aus PortalPy durch 1.000 teilen. Im folgenden Beispiel wird veranschaulicht, wie PortalPy-Zeitangaben in Python-Zeitangaben umgewandelt werden.
    group = portalAdmin.get_group('67e1761068b7453693a0c68c92a62e2e')
    pythontime = time.ctime(group['created']/1000)

PortalPy-Methoden

Nachfolgend werden die verfügbaren Portal-Methoden beschrieben.

_init_

Der Portal-Konstruktor. Hierfür sind die Portal-URL und optional ein Benutzername und ein Passwort erforderlich.

_init_(self, url, username=None, password=None, key_file=None, cert_file=None, expiration=60, referer=None, proxy_host=None, proxy_port=None, connection=None, workdir=r'c:\users\davi3690\appdata\local\temp\2')

add_group_users

Fügt der angegebenen Gruppe Benutzer hinzu. Verwenden Sie diese Methode nur, wenn der Benutzer des Portal-Objekts Administrator für das gesamte Portal oder der explizite Besitzer der Gruppe ist.

add_group_users(self, user_names, group_id)

Argumente

ParameterBeschreibung

user_names

Erforderliche Zeichenfolge, kommagetrennte Benutzer

group_id

Erforderliche Zeichenfolge, angegebene Gruppen-ID

Rückgabewert

Ein Wörterbuch mit dem Schlüssel "not_added", das Benutzer enthält, die der Gruppe nicht hinzugefügt wurden.

create_group

Erstellt eine Gruppe und gibt, wenn erfolgreich, eine Gruppen-ID zurück.

create_group(self, title, tags, description=None, snippet=None, access='public', thumbnail=None, is_invitation_only=False, sort_field='avgRating', sort_order='desc', is_view_only=False)

Argumente

ParameterBeschreibung

title

Erforderliche Zeichenfolge, Name der Gruppe

tags

Erforderliche Zeichenfolge, kommagetrennte Tag-Liste

description

Optionale Zeichenfolge, beschreibt die Gruppe im Detail

snippet

Optionale Zeichenfolge, weniger als 250 Zeichen für Gruppenzusammenfassung

access

Optionale Zeichenfolge, kann "private", "public" oder "org" sein

thumbnail

Optionale Zeichenfolge, URL zum Gruppenbild

isInvitationOnly

Optionaler boolescher Wert, legt fest, ob Benutzer auf Anforderung beitreten können

sort_field

Optionale Zeichenfolge, legt die Sortierung der für die Gruppe freigegebenen Elemente fest

sort_order

Optionale Zeichenfolge, "asc" oder "desc" für aufsteigend oder absteigend

is_view_only

Optionaler boolescher Wert, definiert, ob die Gruppe durchsuchbar ist

Rückgabewert

Eine Zeichenfolge, bei der es sich um die Gruppen-ID handelt.

create_group_from_dict

Erstellt eine Gruppe und gibt, wenn erfolgreich, eine Gruppen-ID zurück. In den meisten Fällen wird empfohlen, stattdessen "create_group" zu verwenden, da bei dieser Methode ein Gruppenwörterbuch, das von einem anderen PortalPy-Aufruf zurückgegeben wurde, verwendet und kopiert werden kann.

create_group_from_dict(self, group, thumbnail=None)

Argumente

ParameterBeschreibung

group

dict-Objekt

thumbnail

URL für Bild

Beispiel

create_group({'title': 'Test', 'access':'public'})

delete_group

Löscht eine Gruppe.

delete_group(self, group_id)

Argumente

ParameterBeschreibung

group_id

Zeichenfolge mit der ID für die gelöschte Gruppe.

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

delete_user

Löscht einen Benutzer aus dem Portal, wobei Gruppen und Elemente optional gelöscht oder erneut zugewiesen werden. Benutzer, die Gruppen oder Elemente besitzen, können im Portal nicht gelöscht werden. Wenn Sie Kaskadierung auswählen, werden diese Elemente und Gruppen dem in der Option "reassign_to" identifizierten Benutzer neu zugewiesen. Wenn Sie keine Kaskadierung auswählen, ist der Löschvorgang je nachdem, ob die Elemente und Gruppen des Benutzers zuvor übertragen wurden, erfolgreich oder nicht.

Beim Kaskadieren werden bei dieser Methode bis zu 10.000 Elemente gelöscht. Wenn der Benutzer über mehr als 10.000 Elemente verfügt, schlägt die Methode fehl.

delete_user(self, username, cascade=False, reassign_to=None)

Argumente

ParameterBeschreibung

username

Erforderliche Zeichenfolge, der Name des Benutzers

cascade

Optionaler boolescher Wert, "true" bedeutet, dass Elemente und Gruppen neu zugewiesen werden

reassign_to

Optionale Zeichenfolge, neuer Besitzer von Elementen und Gruppen

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

generate_token

Generiert und gibt einen neuen Token zurück, es erfolgt jedoch keine erneute Anmeldung.Diese Methode ist nicht erforderlich, wenn Aufrufe im Portal mit der Portal-Klasse erfolgen. Sie dient für Aufrufe im Portal außerhalb der Portal-Klasse.

Das Portal verwendet einen Token-basierten Authentifizierungsmechanismus, bei dem Benutzer ihre Anmeldeinformationen bereitstellen und ein kurzfristiger Token für Aufrufe verwendet wird. Die meisten Aufrufe an die ArcGIS-REST-API erfordern einen Token, der an diese Anforderungen angehängt werden kann.

generate_token(self, username, password, expiration=60)

Argumente

ParameterBeschreibung

username

Erforderliche Zeichenfolge, der Name des Benutzers

password

Erforderliches Kennwort, das Kennwort des Benutzers

expiration

Optionaler Ganzzahlwert, Anzahl der Minuten, bis der Token abläuft

Rückgabewert

Eine Zeichenfolge mit dem Token.

get_group

Gibt Gruppeninformationen für den angegebenen group_id-Wert zurück.

get_group(self, group_id)

Argumente

ParameterBeschreibung

group_id

Erforderliche Zeichenfolge, die die Gruppe angibt

Rückgabewert

Ein Wörterbuchobjekt mit den Gruppeninformationen. Die Schlüssel im Wörterbuchobjekt können Folgendes enthalten:

ParameterBeschreibung

title

Der Name der Gruppe

isInvitationOnly

Wenn dieser Wert auf "true" festgelegt ist, können Benutzer sich nicht um den Beitritt zur Gruppe bewerben

owner

Der Benutzername des Besitzers der Gruppe

description

Beschreibt die Gruppe

snippet

Eine kurze Zusammenfassung der Gruppe

tags

Benutzerdefinierte Tags, die die Gruppe beschreiben

phone

Kontaktinformationen für die Gruppe

thumbnail

Dateiname relativ zu http://<community-url>/groups/<groupId>/info

created

Zeitpunkt der Erstellung der Gruppe, Millisekunden seit 1. Januar 1970

modified

Zeitpunkt der letzten Änderung der Gruppe, Millisekunde seit 1. Januar 1970

access

Kann "private", "org" oder "public" sein

userMembership

Ein Wörterbuch mit Schlüsseln (Benutzername) und memberType

memberType

Bietet dem aufrufenden Benutzer Zugriff ("owner", "admin", "member", "none")

get_group_members

Gibt Mitglieder der angegebenen Gruppe zurück.

get_group_members(self, group_id)

Argumente

ParameterBeschreibung

group_id

Erforderliche Zeichenfolge, die die Gruppe angibt

Rückgabewert

Ein Wörterbuch mit Schlüsseln: "owner", "admins" und "users".

ParameterBeschreibung

owner

Zeichenfolgenwert, der Besitzer der Gruppe

admins

Liste der Zeichenfolgen, in der Regel mit "owner" identisch

users

Liste der Zeichenfolgen, die Mitglieder der Gruppe

Beispiel

Die Benutzer in einer Gruppe drucken:

response = portal.get_group_members("67e1761068b7453693a0c68c92a62e2e")
for user in response['users'] :
   print user

get_group_thumbnail

Gibt die Byte zurück, aus denen die Miniaturansicht für die angegebene "group_id" besteht.

get_group_thumbnail(self, group_id)

Argumente

ParameterBeschreibung

group_id

Erforderliche Zeichenfolge, gibt die Miniaturansicht der Gruppe an

Rückgabewert

Byte zur Darstellung des Bildes.

Beispiel

response = portal.get_group_thumbnail("67e1761068b7453693a0c68c92a62e2e")
f = open(filename, 'wb')
f.write(response)

get_users

Gibt alle Benutzer in der Portal-Organisation zurück.

get_users(self, max_users=1000)

Argumente

ParameterBeschreibung

max_users

Optionaler Ganzzahlwert, die maximale Anzahl von Benutzern, die zurückgegeben werden sollen

Rückgabewert

Eine Wörterbuchliste. Jedes Wörterbuch enthält die folgenden Schlüssel:

SchlüsselWert

username

Zeichenfolge

storageUsage

Ganzzahl

storageQuota

Ganzzahl

description

Zeichenfolge

tags

Zeichenfolgenliste

region

Zeichenfolge

created

Ganzzahlwert, Erstellung des Kontos, Millisekunden seit 1. Januar 1970

modified

Ganzzahlwert, seit der letzten Änderung des Kontos, Millisekunden seit 1. Januar 1970

email

Zeichenfolge

culture

Zeichenfolge

orgId

Zeichenfolge

preferredView

Zeichenfolge

groups

Zeichenfolgenliste

role

Zeichenfolge (user, publisher, admin, <benutzerdefinierter_Rollenname> [wobei <benutzerdefinierter_Rollenname> der Name der benutzerdefinierten Rolle ist, zum Beispiel: hostedservicepublisher])

Ältere Versionen:

In Portal for ArcGIS 10.3 und früheren Versionen lauteten die zulässigen Werte für nicht benutzerdefinierte Rollen org_user, org_publisher und org_admin. In 10.3.1 sind diese Werte veraltet und wurden durch die oben aufgeführten Werte ersetzt. Sie können die älteren Werte in 10.3.1 weiterhin verwenden, müssen jedoch beachten, dass die Werte in zukünftigen Versionen möglicherweise ungültig sind.

fullName

Zeichenfolge

thumbnail

Zeichenfolge

idpUsername

Zeichenfolge

Beispiel

Alle Benutzernamen im Portal drucken:

resp = portalAdmin.get_users() for user in resp:
   print user['username']

get_properties

Gibt die Eigenschaften des Portals unter Verwendung des Caches zurück, es sei denn "force=True".

get_properties(self, force=False)

get_user

Gibt die Benutzerinformationen für den angegebenen Benutzernamen zurück.

get_user(self, username)

Argumente

ParameterBeschreibung

username

Erforderliche Zeichenfolge, der Benutzername, dessen Informationen abgerufen werden sollen

Rückgabewert

Wenn der Benutzer gefunden wurde, wird ein Wörterbuchobjekt mit den folgenden Schlüsseln zurückgegeben. Wenn kein Benutzer gefunden wurde, wird nichts zurückgegeben.

SchlüsselWert

access

Zeichenfolge

created

Ganzzahlwert, Erstellung des Kontos, Millisekunden seit 1. Januar 1970

culture

Zeichenfolge, zweistelliger Sprachcode ('en')

description

Zeichenfolge

email

Zeichenfolge

fullName

Zeichenfolge

idpUsername

Zeichenfolge, Name des Benutzers im Enterprise-System

groups

Wörterbuchliste. Weitere Informationen zu Wörterbuchschlüsseln finden Sie unter get_group.

modified

Ganzzahlwert, seit der letzten Änderung des Kontos, Millisekunden seit 1. Januar 1970

orgId

Zeichenfolge, die Organisations-ID

preferredView

Zeichenfolge, Wert ist "Web", "GIS" oder "null"

region

Zeichenfolge, kein oder zweistelliger Ländercode

role

Zeichenfolge (user, publisher, admin, <benutzerdefinierter_Rollenname> [wobei <benutzerdefinierter_Rollenname> der Name der benutzerdefinierten Rolle ist, zum Beispiel: hostedservicepublisher])

Ältere Versionen:

In Portal for ArcGIS 10.3 und früheren Versionen lauteten die zulässigen Werte für nicht benutzerdefinierte Rollen org_user, org_publisher und org_admin. In 10.3.1 sind diese Werte veraltet und wurden durch die oben aufgeführten Werte ersetzt. Sie können die älteren Werte in 10.3.1 weiterhin verwenden, müssen jedoch beachten, dass die Werte in zukünftigen Versionen möglicherweise ungültig sind.

storageUsage

Ganzzahl

storageQuota

Ganzzahl

tags

Zeichenfolgenliste

thumbnail

Zeichenfolge

username

Zeichenfolge

get_version

Gibt die Softwareversionsnummer unter Verwendung des Caches zurück, es sei denn "force=True". Die Versionsinformationen werden abgerufen, wenn Sie das Portal-Objekt erstellen, und dann für zukünftige Anforderungen gecacht. Wenn Sie eine Anforderung an das Portal senden und sich nicht auf den Cache stützen möchten, legen Sie das force-Argument auf "true" fest.

get_version(self, force=False)

Argumente

ParameterBeschreibung

force

Boolescher Wert, true=Abfrage erstellen, false=Cache verwenden

Rückgabewert

Eine Zeichenfolge mit der Version. Die Version ist eine interne Nummer, die möglicherweise nicht mit der Version des installierten Produkts übereinstimmt.

invite_group_users

Lädt Benutzer zur Gruppe ein. Einem Benutzer, der zu einer Gruppe eingeladen wird, wird auf der Registerkarte "Gruppen" des Portals eine Liste der Einladungen angezeigt. Der Benutzer kann die Einladung annehmen oder ablehnen. Der Benutzer, der den Befehl ausführt, muss der Gruppenbesitzer sein.

invite_group_users(self, user_names, group_id, role='group_member', expiration=10080)

Argumente

ParameterBeschreibung

user_names

Erforderliche Zeichenfolge, kommagetrennte Liste der Benutzer, die eingeladen werden sollen

group_id

Erforderliche Zeichenfolge, gibt die ID der Gruppe an, zu der Sie Benutzer einladen

role

Optionale Zeichenfolge, "group_member" oder "group_admin"

expiration

Optionaler Ganzzahlwert, gibt an, wie lange die Einladung gültig ist (in Minuten)

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

is_all_ssl

Gibt "true" zurück, wenn das Portal HTTPS erfordert.

is_all_ssl(self)

is_logged_in

Gibt "true" zurück, wenn der Benutzer beim Portal angemeldet ist.

is_logged_in(self)

is_org

Gibt "true" zurück, wenn das Portal eine Organisation ist.

is_org(self)

leave_group

Entfernt den angemeldeten Benutzer aus der angegebenen Gruppe. Der Benutzer muss angemeldet sein, um diese Methode verwenden zu können.

leave_group(self, group_id)

Argumente

ParameterBeschreibung

group_id

Erforderliche Zeichenfolge, angegebene Gruppen-ID

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

logged_in_user

Gibt Informationen zum angemeldeten Benutzer zurück.

logged_in_user(self)

Rückgabewert

Ein Wörterbuch mit den folgenden Schlüsseln:

SchlüsselWert

username

Zeichenfolge

storageUsage

Ganzzahl

description

Zeichenfolge

tags

Kommagetrennte Zeichenfolge

created

Ganzzahlwert, Erstellung des Kontos, Millisekunden seit 1. Januar 1970

modified

Ganzzahlwert, seit der letzten Änderung des Kontos, Millisekunden seit 1. Januar 1970

fullName

Zeichenfolge

email

Zeichenfolge

idpUsername

Zeichenfolge, Name des Benutzers im Enterprise-System

login

Die Anmeldung beim Portal erfolgt mit einem Benutzernamen und einem Kennwort. Sie können sich beim Konstruieren eines Portal-Objekts oder zu einem späteren Zeitpunkt bei einem Portal anmelden. Diese Funktion dient der späteren Anmeldung.

login(self, username, password, expiration=60)

Argumente

ParameterBeschreibung

username

Erforderliche Zeichenfolge

password

Erforderliche Zeichenfolge

expiration

Optionaler Ganzzahlwert, wie lange der generierte Token gültig ist

Rückgabewert

Eine Zeichenfolge, die den Token enthält.

logout

Führt die Abmeldung vom Portal aus. Vorhandene Token, die zuvor verwendet wurden, werden vom Portal nicht mehr erkannt und alle nachfolgenden Portal-Aufrufe sind so lange anonym, bis eine andere Anmeldung erfolgt.

logout(self)

Rückgabewert

Kein Rückgabewert.

reassign_group

Weist einem anderen Besitzer eine Gruppe erneut zu.

reassign_group(self, group_id, target_owner)

Argumente

ParameterBeschreibung

group_id

Erforderliche Zeichenfolge, eindeutige Kennung für die Gruppe

target_owner

Erforderliche Zeichenfolge, Benutzername eines neuen Gruppenbesitzers

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

remove_group_users

Entfernt Benutzer aus einer Gruppe.

remove_group_users(self, user_names, group_id)

Argumente

ParameterBeschreibung

user_names

Erforderliche Zeichenfolge, kommagetrennte Benutzerliste

group_id

Erforderliche Zeichenfolge, eindeutige Kennung für die Gruppe

Rückgabewert

Ein Wörterbuch mit dem Schlüssel "notRemoved" zur Angabe der Liste der nicht entfernten Benutzer.

reset_user

Setzt das Kennwort, die Sicherheitsfrage und Sicherheitsantwort eines Benutzers zurück. Diese Funktion gilt nicht für Portale, die mit Konten konfiguriert sind, die aus einem Enterprise-Identitätsspeicher wie Active Directory oder LDAP. . . . . . Sie gilt nur für integrierte Portal-Benutzer. Wenn eine neue Sicherheitsfrage angegeben wird, wird eine neue Sicherheitsantwort bereitgestellt.

reset_user(self, username, password, new_password=None, new_security_question=None, new_security_answer=None)

Argumente

ParameterBeschreibung

username

Erforderliche Zeichenfolge, Konto wird zurückgesetzt

password

Erforderliche Zeichenfolge, aktuelles Kennwort

new_password

Optionale Zeichenfolge, neues Kennwort, wenn das Kennwort zurückgesetzt wird

new_security_question

Optionaler Ganzzahlwert, bei Bedarf eine neue Sicherheitsfrage

new_security_answer

Optionale Zeichenfolge, bei Bedarf eine neue Sicherheitsantwort

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

search

search(self, q, bbox=None, sort_field='title', sort_order='asc', max_results=1000, add_org=True)

search_groups

Sucht nach Portal-Gruppen. Berücksichtigen Sie bei Verwendung dieser Methode Folgendes:

  • Die Abfragesyntax verfügt über viele Funktionen, die hier nicht beschrieben werden. Weitere Informationen zu allen Funktionen finden Sie in der Suchreferenz der ArcGIS-REST-API.
  • Wenn Sie Gruppen suchen, suchen Sie häufig innerhalb der Organisation. Bei dieser Methode wird die Organisations-ID standardmäßig an die Abfrage angehängt. Wenn die API nicht an Ihre Abfrage angehängt werden soll, legen Sie "add_org" auf "false" fest.

search_groups(self, q, sort_field='title', sort_order='asc', max_groups=1000, add_org=True)

Argumente

ParameterBeschreibung

q

Erforderliche Zeichenfolge, Abfragezeichenfolge.

sort_field

Optionale Zeichenfolge, gültige Werte können "title", "owner" oder "created" sein

sort_order

Optionale Zeichenfolge, gültige Werte sind "asc" oder "desc"

max_groups

Optionaler Ganzzahlwert, maximale Anzahl von zurückgegebenen Gruppen

add_org

Optionaler boolescher Wert, steuert, ob in der Organisation gesucht werden soll

Rückgabewert

Eine Wörterbuchliste. Jedes Wörterbuch enthält die folgenden Schlüssel:

SchlüsselWert

access

Zeichenfolge, Werte sind "private", "org" oder "public"

created

Ganzzahlwert, Erstellung des Kontos, Millisekunden seit 1. Januar 1970

description

Zeichenfolge

id

Zeichenfolge, eindeutige ID für die Gruppe

isInvitationOnly

Boolescher Wert

isViewOnly

Boolescher Wert

modified

Ganzzahlwert, seit der letzten Änderung des Kontos, Millisekunden seit 1. Januar 1970

owner

Zeichenfolge, Benutzername des Besitzers

phone

Zeichenfolge

snippet

Zeichenfolge, kurze Zusammenfassung der Gruppe

sortField

Zeichenfolge, Sortierung freigegebener Elemente

sortOrder

Zeichenfolge, aufsteigend oder absteigend

tags

Zeichenfolgenliste, vom Benutzer für die Suche bereitgestellte Tags

thumbnail

Zeichenfolge, Name der Datei. Anhängen an http://<community url>/groups/<group id>/info/

title

Zeichenfolge, Name der Gruppe, wie er Benutzern angezeigt wird

search_users

Sucht nach Portal-Benutzern. Berücksichtigen Sie bei Verwendung dieser Methode Folgendes:

  • Die Abfragesyntax verfügt über viele Funktionen, die hier nicht beschrieben werden. Weitere Informationen zum Überprüfen aller Features finden Sie unter Search reference in der ArcGIS-REST-API.
  • Wenn Sie Benutzer suchen, suchen Sie häufig innerhalb der Organisation. Bei dieser Methode wird die Organisations-ID standardmäßig an die Abfrage angehängt. Wenn die API nicht an Ihre Abfrage angehängt werden soll, legen Sie "add_org" auf "false" fest.

search_users(self, q, sort_field='username', sort_order='asc', max_users=1000, add_org=True)

Argumente

ParameterBeschreibung

q

Erforderliche Zeichenfolge, Abfragezeichenfolge.

sort_field

Optionale Zeichenfolge, gültige Werte können "title", "owner" oder "created" sein

sort_order

Optionale Zeichenfolge, gültige Werte sind "asc" oder "desc"

max_users

Optionaler Ganzzahlwert, maximale Anzahl von zurückgegebenen Benutzern

add_org

Optionaler boolescher Wert, steuert, ob in der Organisation gesucht werden soll

Rückgabewert

Eine Wörterbuchliste. Jedes Wörterbuch enthält die folgenden Schlüssel:

SchlüsselWert

created

Ganzzahlwert, Erstellung des Kontos, Millisekunden seit 1. Januar 1970

culture

Zeichenfolge, zweistelliger Sprachcode

description

Zeichenfolge

fullName

Zeichenfolge, Benutzername des Benutzers

modified

Ganzzahlwert, seit der letzten Änderung des Kontos, Millisekunden seit 1. Januar 1970

region

Zeichenfolge, möglicherweise "none"

tags

Zeichenfolgenliste, vom Benutzer für die Suche bereitgestellte Tags

thumbnail

Zeichenfolge, Name der Datei. Anhängen an http://<community url>/groups/<group id>/info/.

username

Zeichenfolge, Benutzername des Benutzers

signup

Registriert Benutzer bei Portal for ArcGIS. Diese Methode gilt nur für Portal for ArcGIS und kann anonym aufgerufen werden. Selbstregistrierung kann jedoch auch im Portal deaktiviert werden. Bei dieser Methode werden außerdem nur integrierte Konten erstellt. Es werden keine Enterprise-Konten verwendet, die aus einem Enterprise-Identitätsspeicher stammen.

Es gibt eine andere Methode namens "createUser", die immer für Portal for ArcGIS 10.2.1 oder höher verwendet werden kann. Diese Methode erfordert Administratorzugriff und kann zum Erstellen integrierter Benutzer oder zum Hinzufügen von Enterprise-Konten zum Portal verwendet werden.

signup(self, username, password, fullname, email)

Argumente

ParameterBeschreibung

username

Erforderliche Zeichenfolge, muss im Portal eindeutig sein, größer als 4 Zeichen

password

Erforderliche Zeichenfolge, muss größer oder gleich 8 Zeichen sein

fullname

Erforderliche Zeichenfolge, Name des Benutzers

email

Erforderliche Zeichenfolge, muss eine gültige E-Mail-Adresse sein

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

update_group

Aktualisiert eine Gruppe. Sie müssen nur für die Argumente Werte angeben, die aktualisiert werden sollen.

update_group(self, group_id, title=None, tags=None, description=None, snippet=None, access=None, is_invitation_only=None, sort_field=None, sort_order=None, is_view_only=None, thumbnail=None)

Argumente

ParameterBeschreibung

group_id

Erforderliche Zeichenfolge, die Gruppen-ID, die geändert werden soll

title

Erforderliche Zeichenfolge, Name der Gruppe, die geändert werden soll

tags

Erforderliche Zeichenfolge, kommagetrennte Tag-Liste

description

Optionale Zeichenfolge, beschreibt die Gruppe im Detail

snippet

Optionale Zeichenfolge, weniger als 250 Zeichen für Gruppenzusammenfassung

access

Optionale Zeichenfolge, kann "private", "public" oder "org" sein

thumbnail

Optionale Zeichenfolge, URL zum Gruppenbild

isInvitationOnly

Optionaler boolescher Wert, legt fest, ob Benutzer auf Anforderung beitreten können

sort_field

Optionale Zeichenfolge, legt die Sortierung der für die Gruppe freigegebenen Elemente fest

sort_order

Optionale Zeichenfolge, "asc" oder "desc" für aufsteigend oder absteigend

is_view_only

Optionaler boolescher Wert, definiert, ob die Gruppe durchsuchbar ist

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

update_user

Aktualisiert die Eigenschaften eines Benutzers. Geben Sie nur für die Argumente Werte an, die aktualisiert werden sollen.

update_user(self, username, access=None, preferred_view=None, description=None, tags=None, thumbnail=None, fullname=None, email=None, culture=None, region=None)

Argumente

SchlüsselWert

username

Erforderliche Zeichenfolge, Name der Benutzeraktualisierung

access

Optionale Zeichenfolge, Werte: "private", "org", "public"

preferred_view

Optionale Zeichenfolge, Werte: "Web", "GIS", "null"

description

Optionale Zeichenfolge, eine Beschreibung des Benutzers

tags

Optionale Zeichenfolge, kommagetrennte Tags für die Suche

thumbnail

Optionale Zeichenfolge, Pfad oder URL zu einer Datei. Kann PNG, GIF oder JPEG sein. Maximale Größe ist 1 MB.

fullName

Optionale Zeichenfolge, Name des Benutzers, nur für integrierte Benutzer

email

Optionale Zeichenfolge, E-Mail-Adresse, nur für integrierte Benutzer

culture

Optionale Zeichenfolge, zweistelliger Sprachcode, z. B. "fr".

region

Optionale Zeichenfolge, zweistelliger Ländercode, z. B. "FR".

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.

update_user_role

Aktualisiert die Rolle eines Benutzers.

update_user_role(self, username, role)

Argumente

SchlüsselWert

username

Erforderliche Zeichenfolge, der Name des Besitzers, dessen Rolle geändert wird

role

Erforderliche Zeichenfolge, user, publisher, admin, <benutzerdefinierte_Rollen-ID> (wobei <benutzerdefinierte_Rollen-ID> die ID der benutzerdefinierten Rolle ist, z. B. 1eo7LSAhbNiG1q9t, die sich unter Rollen im Verzeichnis "Sharing" von ArcGIS-Portalverzeichnis befindet. Die URL hat das Format https://webadaptorhost.domain.com/<webadaptorname>/sharing/portals/0123456789ABCDEF/roles).

Ältere Versionen:

In Portal for ArcGIS 10.3 und früheren Versionen lauteten die zulässigen Werte für nicht benutzerdefinierte Rollen org_user, org_publisher und org_admin. In 10.3.1 sind diese Werte veraltet und wurden durch die oben aufgeführten Werte ersetzt. Sie können die älteren Werte in 10.3.1 weiterhin verwenden, müssen jedoch beachten, dass die Werte in zukünftigen Versionen möglicherweise ungültig sind.

Rückgabewert

Ein boolescher Wert, der angibt, ob der Vorgang erfolgreich war oder nicht.