API-Workflow

API-Workflow-Knoten zum Aufrufen eines veröffentlichten UiPath Studio Web-API-Workflows und zur Verwendung seiner Ausgabe, einschließlich seiner Konfigurationsfelder und Ausgabevariablen.

Ruft einen UiPath Studio Web-API-Workflow auf und gibt dessen Ausgabe zurück.

Wann Sie API Workflow anstelle von HTTP Request verwenden sollten

Verwenden Sie den API-Workflow-Knoten, wenn die aufzurufende Logik in Studio Web erstellt und als API-Workflow veröffentlicht wurde – z. B. für die Verarbeitung strukturierter Daten oder mehrstufige Integrationen, die von Ihrem Team erstellt wurden. Verwenden Sie den HTTP Request-Knoten, wenn Sie einen externen REST-Endpunkt (Repräsentational State Transfer) außerhalb der UiPath-Plattform aufrufen.

Konfiguration

Feld	Erforderlich	Beschreibung
API-Workflow	Ja	Der aufzurufende Studio Web-API-Workflow. Wählen Sie aus der Liste der in Ihrer Organization veröffentlichten API-Workflows aus.
Eingabe	Nein	Schlüssel-Wert-Paare, die den Eingabeparametern des API-Workflows zugeordnet sind. Unterstützt Variablenverweise.
Zeitüberschreitung	Nein	Maximale Wartezeit auf den Abschluss des Workflows.

Ausgabevariablen

Variable	Beschreibung
output	Die vom API-Workflow gemäß seinem Ausgabeschema zurückgegebene Antwort.
error	Fehlerdetails, wenn der Aufruf fehlschlägt. Verwenden Sie ihn mit der Fehlerbehandlung, um bei Fehlern zu verzweigen.

Beispiele

Verweisen Sie in nachgelagerten Knoten mit einem Ausdruck auf die Ausgabe des API-Workflows:

$vars.apiWorkflow1.output

Um ein einzelnes Feld aus der Ausgabe zu verwenden, hängen Sie den im Ausgabeschema des API-Workflows definierten Feldnamen an – z. B. $vars.apiWorkflow1.output.<field>.

Häufige Probleme

Problem	Resolution
API-Workflow nicht im Dropdown-Menü aufgeführt	Stellen Sie sicher, dass der Workflow in Studio Web veröffentlicht ist und Sie über die erforderliche Berechtigung verfügen, ihn aufzurufen.
Timeout-Fehler	Erhöhen Sie den Timeout-Wert oder optimieren Sie den Studio Web-Workflow für eine schnellere Ausführung.
Eingabetyp stimmt nicht überein	Prüfen Sie, ob die von Ihnen übergebenen Variablentypen mit den im API-Workflow deklarierten Eingabeparametertypen übereinstimmen.