Orchestrator HTTP-Anfrage (Orchestrator HTTP Request)

UiPath.Core.Activities.OrchestratorHttpRequest

Beschreibung

Erstellt HTTP-Anfragen an die Orchestrator-API über die Authentifizierung unter dem ausführenden Roboter. Sie können die Verben GET, POST, PUT, PATCH und DELETE verwenden, um Daten zu extrahieren oder zu ändern, und bestimmte Informationen über JSON senden. Beachten Sie, dass jede Anfrage unterschiedliche Rechte auf die Rolle des Roboters des Orchestrators benötigt, je nachdem, welche Anfragen Sie ausführen möchten und dass der Roboter mit dem Orchestrator verbunden sein muss. Zum Ausführen von Anfragen PUT auf Organisationseinheiten benötigen Sie z. B. die Rechte Ansehen (View), Erstellen (Create) und Bearbeiten (Edit). Die Aktivität läuft unter dem Roboter, der sie ausführt.

Projektkompatibilität

Windows – Legacy | Windows | Plattformübergreifend

Windows, plattformübergreifende Konfiguration

• Orchestrator-Ordner – Der Pfad zum Orchestrator-Ordner, der mit der Aktivität verwendet werden soll.
• Methode (Method) - Die zu verwendende Anfragemethode, wenn die Orchestrator-API aufgerufen wird. Folgende HTTP-Verben werden unterstützt: GET, POST, PUT, PATCH und DELETE. Standardmäßig wird das Verb GET ausgewählt.
• RelativerEndpunkt (RelativeEndpoint) - Der Endpunkt, an den Anfragen gestellt werden sollen, relativ zu Ihrer Orchestrator-Basis-URL.
• JSONPayload (JSONPayload) - Die Information, die Sie im JSON-Format an den angezeigten Orchestrator-Endpunkt senden möchten. Das JSON muss nicht eingerückt sein. Das Feld unterstützt nur Zeichenfolgen, Zeichenfolgenvariablen oder Zeichenfolgenausdrücke.

Zusätzliche Optionen

Optionen

• Timeout (Millisekunden) (Timeout (milliseconds)) - Gibt an, wie lange (in Millisekunden) die Aktivität laufen muss, bevor ein Fehler ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung auch dann fortgesetzt werden soll, wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (True, False). Der Standardwert ist false. Wenn das Feld leer ist und ein Fehler ausgegeben wird, wird die Ausführung des Projekts angehalten. Wenn der Wert auf true gesetzt ist, wird die Ausführung des Projekts ungeachtet eines Fehlers fortgesetzt.

Ausgabe

• Header – Verweis auf die von der Anforderung zurückgegebenen Header.
• JSONAntwort (JSONResponse) - Das von der HTTP-Anfrage zurückgegebene JSON als Variable vom Typ Zeichenfolge (String).
• StatusCode (StatusCode) - Der von der HTTP-Anfrage zurückgegebene Statuscode als Variable vom Typ Integer.

Windows – Legacy-Konfiguration

Eigenschaften-Panel

Allgemein

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
• Timeout (Millisekunden) (Timeout (milliseconds)) - Gibt an, wie lange (in Millisekunden) die Aktivität laufen muss, bevor ein Fehler ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

Eingabe

• JSONPayload (JSONPayload) - Die Information, die Sie im JSON-Format an den angezeigten Orchestrator-Endpunkt senden möchten. Das JSON muss nicht eingerückt sein. Das Feld unterstützt nur Zeichenfolgen, Zeichenfolgenvariablen oder Zeichenfolgenausdrücke.
• Methode (Method) - Die zu verwendende Anfragemethode, wenn die Orchestrator-API aufgerufen wird. Folgende HTTP-Verben werden unterstützt: GET, POST, PUT, PATCH und DELETE. Standardmäßig wird das Verb GET ausgewählt.
• RelativerEndpunkt (RelativeEndpoint) - Der Endpunkt, an den Anfragen gestellt werden sollen, relativ zu Ihrer Orchestrator-Basis-URL.

Sonstiges

• Ordnerpfad – Der Pfad des Ordners, in dem die Anforderung ausgelöst werden soll, wenn er sich vom Ordner unterscheidet, in dem der Prozess ausgeführt wird. Dieses Feld unterstützt nur String-Werte mit / als Trennzeichen zur Angabe von Unterordnern. Zum Beispiel: "Finance/Accounts Payable".
• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Header – Verweis auf die von der Anforderung zurückgegebenen Header.
• JSONAntwort (JSONResponse) - Das von der HTTP-Anfrage zurückgegebene JSON als Variable vom Typ Zeichenfolge (String).
• StatusCode (StatusCode) - Der von der HTTP-Anfrage zurückgegebene Statuscode als Variable vom Typ Integer.

Die Anfrage in folgendem Bildschirmfoto ermöglicht z. B. das Anlegen einer neuen Organisationseinheit, Dokumentation, zu der Ihr Roboter auf dem Orchestrator verbunden ist. Die JSON-Antwort und der Statuscode werden als Variablen gespeichert.