API ワークフロー

パブリッシュ済みの UiPath Studio Web API ワークフローを呼び出し、その出力を構成フィールドおよび出力変数と共に使用するための API ワークフロー ノードです。

UiPath Studio Web API ワークフローを呼び出し、その出力を返します。

API ワークフローと HTTP 要求を使用すべき状況

[ API ワークフロー ] ノードは、呼び出す必要のあるロジックが Studio Web で構築され、API ワークフローとしてパブリッシュされている場合に使用します (たとえば、自分のチームが作成した構造化データの処理や複数ステップの連携など)。UiPath Platform の外部で外部の Representational State Transfer (REST) エンドポイントを呼び出す場合は、 HTTP 要求 ノードを使用します。

構成

フィールド	Required	説明
API ワークフロー	はい	呼び出す Studio Web API ワークフローです。組織内でパブリッシュ済みの API ワークフローのリストから選択します。
入力	いいえ	API ワークフローの入力パラメーターにマッピングされたキーと値のペア変数参照がサポートされています。
Timeout	いいえ	ワークフローが完了するまで待機する最大時間です。

出力変数

変数	説明
output	API ワークフローによって、その出力スキーマに従って返される応答です。
error	呼び出しが失敗した場合のエラーの詳細です。エラー 処理 と併用して、失敗時に分岐します。

例

下流での API ワークフローの出力を式で参照します。

$vars.apiWorkflow1.output

出力から 1 つのフィールドを使用するには、API ワークフローの出力スキーマで定義されたフィールド名を追加します (例: $vars.apiWorkflow1.output.<field>)。

一般的な問題

問題	解決方法
ドロップダウンに表示されない API ワークフロー	ワークフローが Studio Web にパブリッシュされており、そのワークフローを呼び出す権限があることを確認します。
タイムアウト エラー	[タイムアウト] の値を増やすか、Studio Web のワークフローを最適化してより高速に実行します。
入力の種類が一致しない	渡す変数の型が、API ワークフローで宣言された入力パラメーターの型と一致していることを確認します。