Plattformverwaltungs-APIs

Der Abschnitt „Plattformverwaltungs-APIs“ gibt einen Überblick über die einzelnen Bereiche der Plattformverwaltung sowie über die entsprechenden Endpunkte.

• Protokolle

• Gruppen

• Robot-Konten

• Benutzerkonten

• Einstellungen

• Nachrichtenvorlagen

Abrufen von partitionGlobalId für die API-Verwendung

Das Abrufen der partitionGlobalId ist ein kritischer Schritt bei der Verwendung der API zur Verwaltung von Benutzern und Gruppen. Dieser Parameter stellt die ID der Organisation dar, für die Sie Konten verwalten möchten. In dieser Anleitung erfahren Sie verschiedene Methoden zum Abrufen Ihrer partitionGlobalId.

Grundlegendes zur partitionGlobalId

Der Parameter partitionGlobalId muss im Anforderungstext enthalten sein, wenn API-Anforderungen gestellt werden. Er identifiziert die Organisation, die Sie verwalten, eindeutig.

Wenn Sie diesen Parameter fälschlicherweise abrufen oder verwenden, wird eine Fehlermeldung ähnlich der folgenden angezeigt:'{"errors":{"partitionGlobalId":["The value 'DatacomGroup' is not valid."]} '. Dies zeigt an, dass der eingegebene Wert partitionGlobalId nicht gültig ist.

Methode 1 – Abrufen der partitionGlobalId aus der URL

Ihre partitionGlobalId ist in die URL eingebettet, die beim Anmelden angezeigt wird.

Betrachten Sie zum Beispiel die folgende URL: https://baseURL/tenant/portal_/cloudrpa?organizationId=xxxxxx&ecommerceRedirect=false&isAuth0=true, xxxxxx ist die partitionGlobalId. Dies zu erfassen kann jedoch schwierig sein, da die URL möglicherweise zu schnell geladen wird.

Methode 2 – Verwenden von Entwicklertools zum Abrufen der partitionGlobalId

Führen Sie die folgenden Schritte aus, um das Problem des schnellen Ladens zu umgehen:

1. Öffnen Sie die Entwicklertools Ihres Webbrowsers, bevor Sie sich anmelden. Unter Windows und Linux können Sie Entwicklertools mit der Tastenkombination Strg + Umschalt + J öffnen. Unter Mac können Sie Entwicklertools mit der Tastenkombination Befehl + Option + J öffnen.

2. Navigieren Sie zur Registerkarte Netzwerk und aktivieren Sie die Aufzeichnung.

   

3. Melden Sie sich bei {baseURL_vanilla} an und wählen Sie den gewünschten Mandanten aus.

4. Sobald die Seite vollständig geladen wurde, kehren Sie auf der Registerkarte Netzwerk zu den Entwicklertools zurück.

5. Untersuchen Sie die Anforderungen, die beim Laden der Seite gestellt wurden. Suchen Sie nach einer Anforderung, z. B. der API-Anforderung für Einstellungen.

6. In der Anforderungs-URL dieser spezifischen Anforderung finden Sie die partitionGlobalId gefolgt von einer ID. Diese ID ist Ihre partitionGlobalId und ist der Wert, der in Ihren API-Aufrufen verwendet werden soll.