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 partitionGlobalId für die Nutzung der API

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.

Verständnis partitionGlobalId

Der Parameter partitionGlobalId muss im Anforderungstext enthalten sein, wenn API-Anforderungen gestellt werden. Sie 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 angezeigt wird, wenn Sie sich anmelden.

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

Methode 2 – Abrufen mithilfe von Entwicklertools 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. Gehen Sie zur Registerkarte Netzwerk und aktivieren Sie die Aufzeichnung.

   

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

4. Sobald die Seite vollständig geladen ist, 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 partitionGlobalId gefolgt von einer ID. Diese ID ist Ihre partitionGlobalId und ist der Wert, der in Ihren API-Aufrufen verwendet werden soll.