Erstellen von API-Anfragen

All Orchestrator API calls are made using HTTP methods to the Orchestrator URL. The Orchestrator URL has the following syntax: https://{yourDomain} . It is recommended to encrypt the data you send via API calls, by using the HTTPS protocol.

Wichtig:

Für den Zugriff auf Ressourcen in einem Ordner muss jede Anforderung entweder FolderId, FolderPathoder FolderKey in einem HTTP-Header enthalten. Dieser Header kann codiert (mit Base64 UTF-16LE-Codierung) oder als Nur-Text sein.

Zum Beispiel:

• X-UIPATH-OrganizationUnitId "FolderId",
• X-UIPATH-FolderPath-Encoded "{Encoded FolderPath value}",
• X-UIPATH-FolderPath "PlainText FolderPath value", oder
• X-UIPATH-FolderKey "FolderKey".

Die FolderId kann abgerufen werden, indem eine GET-Anforderung an den /odata/Folders-Endpunkt ausgeführt und der Wert „Id“ kopiert wird, oder über die Orchestrator-URL – https://your-domain-server.com/? fid=2032 &tid=8. FolderId ist vom Typ Int 64.

Die FolderKey kann durch Ausführen einer GET-Anforderung an den Endpunkt /odata/Folders und Kopieren des Werts „Key“ abgerufen werden. FolderKey ist vom Typ Eindeutige ID/Zeichenfolge.

Wenn Sie den Lizenzierungsplan für Ihr Orchestrator-Konto ändern (z. B. von Enterprise Trial zu Enterprise), ändert sich auch der Wert FolderId , während der Wert von FolderKey gleich bleibt.

Relative Ordnerpfade werden in einem X-UIPATH-FolderPath-Encoded-Header wie folgt unterstützt:

• Pfad, der mit / beginnt – Beginnt im root-Ordner der Struktur, zu welcher der Umgebungsordner gehört.
• Pfad, der mit . beginnt – Beginnt im Umgebungsordner.
• Pfad, der mit .. beginnt – Beginnt eine Ebene höher in der Hierarchie des Umgebungsordners für jedes .. im Pfad (z. B. ../ für eine Ebene höher, ../../ für zwei Ebenen höher in der Hierarchie).

Beachten Sie, dass nachgestellte Schrägstriche nicht akzeptiert werden.

Wichtig: Wenn Sie die Orchestrator-API in Verbindung mit MSXML verwenden, kann die Antwort 204 Kein Inhalt zu einem 1223-Statuscode führen und Fehler verursachen.

GET-Abfragen (GET Requests)

GET-Abfragen sind normalerweise die einfachsten, die es gibt. Mit ihnen können Sie Daten abrufen und generische OData-Klauseln verwenden:

• $top
• $filter
• $erweitern
• $select
• $bestellen nach
• $skip

$top

Diese Klausel hilft Ihnen, die Menge der abgerufenen Daten zu begrenzen. Sie hat einen Höchstwert, der von dem Endpunkt bestimmt wird, an den Sie Abfragen richten, und der Anzahl dieser Ressourcen, die in Ihren Orchestrator-Instanzen vorhanden sind.

For example, this request https://{yourDomain}/odata/Environments?$top=10 returns the first 10 environments available in the Community Edition of Orchestrator. However, if only 5 environments exist, only those are retrieved.

$filter

Diese OData-Klausel wird verwendet, um eine bestimmte Ressource nach ihren Eigenschaften zu filtern.

Zum Beisiel kann man filtern nach:

• numerischen Eigenschaften:

  • https://{yourDomain}/odata/Environments?$filter=Id%20eq%2015 - requests a specific environment based on its Id

• Texteigenschaften:

  • https://{yourDomain}/odata/Environments?$filter=contains(Name,'N')&$top=10 - returns the first 10 environments whose name contains the letter "N"

• Boolesche Eigenschaften:

  • https://{yourDomain}/odata/Processes?$filter=Title%20eq%20'test'%20%26%20IsLatestVersion%20eq%20true - returns all processes that contain the word "test" and represent the latest version

• aufzählbare Eigenschaften:

  • https://{yourDomain}/odata/QueueItems?$filter=Priority%20eq%20'High' - returns all queue items that have a High priority

• Die Eigenschaft einer Eigenschaft:

  • https://{yourDomain}/odata/Jobs?$top=10$filter=Robot/MachineName%20eq%20'Documentation' - returns the first 10 jobs that were executed by any Robot that exists on the "Documentation" machine

Filterparameter können mit den logischen Operatoren „und“, „oder“ und/oder „nicht“ verknüpft und mit Klammern „( )“ angeordnet werden, wie die folgende Anfrage:

• https://{yourDomain}/odata/Jobs?$top=10&$filter=Robot/MachineName eq 'LAVINIA-PC' and (not(Source eq 'Manual') or StartTime gt 2017-10-28T12:13:00.07Z) - displays the top 10 jobs that are being executred manually or after "2017-10-28T12:13:00.07Z", by a Robot deployed on the "LAVINIA-PC" machine.

$erweitern

Diese Klausel wird verwendet, um Navigationseigenschaften der angeforderten Ressource vollständig zu laden.

$select

Mit dieser OData-Klausel können Sie eine Untergruppe von Ressourceneigenschaften angeben, die Sie zurückgegeben haben möchten. Wenn Sie mehrere Ressourcen extrahieren möchten, können Sie diese durch Komma trennen.

$bestellen nach

Die Klausel $orderby ermöglicht Ihnen das Sortieren abgerufener Ressourcen. Wie bei der Klausel $select sind die Ressourcen, die Sie ordnen möchten, durch Komma getrennt und können in aufsteigender (asc) oder absteigender (desc) Reihenfolge sortiert werden. Ist keiner dieser Operatoren angegeben, werden die Ressourcen automatisch in aufsteigender Reihenfolge sortiert.

$skip

Mit dieser Klausel können Sie die ersten n Elemente in einem angegebenen Filter überspringen.

POST-Abfragen

Mit dem Verb POST HTTP können Sie neue Objekte erstellen, die anderen Ressourcen untergeordnet sind. Beim Erstellen einer neuen Ressource POST für die übergeordnete ordnet Orchestrator die neue Ressource der übergeordneten zu und weist ihr eine ID sowie andere erforderliche Informationen zu. Die Daten werden im Hauptteil der Anfrage hinzugefügt und die Antwort ist das gesamte erstellte Objekt.

Sie können einer Warteschlange neue Objekte hinzufügen, neue Assets, Umgebungen oder Prozesse erstellen, einer oder mehreren fehlgeschlagenen Transaktionen einen Prüfer zuweisen, und so weiter.

Hinweis: Bei Sonderzeichen ist im Hauptteil der POST-Abfrage kein Escaping möglich. Um Sonderzeichen zu verwenden, müssen Sie zunächst den Parameter, in dem Sie diese als Zeichenfolge verwenden, im folgenden Format "[e-mail]": "#String" deklarieren. Um dies besser zu verstehen, schauen Sie sich an, wie der Parameter Specific Content im Beispiel unten ausgefüllt wurde.

PUT-Abfragen

PUT ist normalerweise erforderlich, wenn Sie den Inhalt einer Ressource aktualisieren möchten. Im Allgemeinen werden Anforderungen an eine bestimmte Entität gestellt, indem deren Id in der URL hinzugefügt wird. Beachten Sie, dass ein PUT-Aufruf die vorhandene Entität durch den Inhalt der Anforderung ersetzt oder, wenn keine am angegebenen Speicherort vorhanden ist, versucht, sie zu erstellen.

Es besteht die Möglichkeit, Warteschlangen, Umgebungen, Organisationseinheiten, Kommentare zu Transaktionen, Prozesse und andere Details von Ressourcen zu aktualisieren.

PATCH-Anforderungen

PATCH wird verwendet, um den Inhalt einer vorhandenen Entität zu aktualisieren, wobei die gewünschte Entität durch Hinzufügen ihres Id in der URL angegeben wird. Der Text der Anforderung enthält nur die Inhalte, die Sie ändern möchten. Dies unterscheidet sich von einem PUT-Aufruf, der die aktuelle Entität durch den Inhalt der nachfolgenden Anforderung ersetzt .

Es ist möglich, eine PATCH-Anforderung zu verwenden, um Maschinen, Prozesse, Roboter, Mandanten, Benutzer (außer Organisationseinheit und Rollen) und Webhooks-Entitäten zu aktualisieren.

DELETE-Abfragen

Mit diesem HTTP-Verb können Sie ein angegebenes Objekt in der Datenbank als gelöscht markieren. Die Ressource wird normalerweise mit Hilfe ihrer ID in der URL, an welche Sie die Abfrage richten, angegeben. Eine Antwort 204 informiert Sie, dass Ihre Abfrage erfolgreich war.

Es besteht die Möglichkeit, Assets, Warteschlangenobjektkommentare, Prozesse, Rollen, Mandanten, Benutzer und viele andere zu löschen.