コネクタ ノード

事前構築済みの操作を使用してサードパーティのサービスをキャンバス上で直接統合するコネクタ ノードです。

それらは何ですか

コネクタ ノードを使用すると、手動で HTTP を設定することなく、キャンバスからサードパーティのサービスを直接操作できます。各コネクタは、特定のサービス (GitHub、Salesforce、Slack、Microsoft 365 など) 用に事前に構築されたノードを提供し、型指定された入力、型指定された出力、および Integration Service による自動認証を提供します。

ノード パレットの [ コネクタ ] カテゴリに、コネクタ ノードがサービス別にグループ化されて表示されます。

動作のしくみ

コネクタ ノードは、UiPath の Integration Service から動的に読み込まれます。利用可能なコネクタは、Automation Cloud 組織で設定されている内容によって異なります。各コネクタ ノードは、ターゲット サービス上の特定の API 操作にマップされます。

コネクタ ノードをキャンバスに追加すると、Flow はその入力スキーマを取得し、[プロパティ] パネルに動的な設定フォームを表示します。必要なフィールドに入力して認証用のコネクションを選択すると、ノードが実行時に API 呼び出しを処理します。

構成

コネクション

すべてのコネクタ ノードには、 コネクション、つまり Integration Service で管理される事前設定済みの認証資格情報が必要です。接続は、ノードの構成時に [プロパティ] パネルで選択します。

コネクションでは、トークンの更新、OAuth フロー、資格情報の保存が自動的に処理されます。認証ヘッダーとシークレットは直接管理されません。

注:

コネクションは、UiPath Automation Cloud ポータルの Integration Service で設定します。設定手順については、 Integration Service のドキュメント をご覧ください。

ノード固有の入力

各コネクタ ノードには、ラップする API 操作に基づいて独自の入力フィールドがあります。これらはプロパティ パネルで動的にレンダリングされます。[課題を作成] ノードのフィールドは、[リポジトリのリストを表示] ノードとは異なるフィールドで、同じコネクタ内であっても表示されます。

すべての入力フィールドで、変数式 ($vars.<nodeName>.<property>) がサポートされています。

出力

コネクタ ノードの出力は $vars.<nodeName>.outputで確認できます。出力の形状は、特定のノードと、ノードが呼び出す API によって異なります。

// Access the output of a GitHub connector node named "listBranches1"
$vars.listBranches1.output

エラー処理

コネクタ ノードでは、エラー ハンドルがサポートされています。API 呼び出しが失敗した場合にエラー ハンドルが接続されている場合、実行は標準エラー オブジェクト $vars.<nodeName>.errorのエラー パスにルーティングされます。

詳しくは、「 エラー処理 」をご覧ください。

コネクタ トリガー

一部のコネクタには 、外部サービスで何かが発生したときに発生するトリガー (新しいメールの受信、フォームの送信など) が発生するトリガーも用意されています。コネクタ トリガーは、ノード パレットの [トリガー] セクションに表示されます。

トリガーの入力はトリガーによって所有され、 $vars.<triggerName>.output.<inputName>としてアクセスします。詳しくは「 トリガー 」をご覧ください。

コネクタを使用すべき状況と HTTP 要求を使用すべき状況

コネクタ ノードは、次の場合に使用します。	HTTP 要求は次の場合に使用します。
対象のサービスにコネクタが存在する	サービス用のコネクタが存在しません
手動で設定しない、型指定された入力と出力が必要な場合	ヘッダー、クエリ パラメーター、本文を完全に制御する必要がある
Integration Service による自動認証が必要な場合	この API では、非標準の認証スキームが使用されます
API の変更に適応する、保守可能なプロセスが必要である	新しい API または内部 API に対してプロトタイピングを行っている

経験則: ノード パレットは、コネクタを最初に確認する場所です。HTTP 要求は、ターゲット サービスにコネクタが存在しない場合のフォールバックです。

利用可能なコネクタ

利用可能なコネクタの完全なリストは、Automation Cloud の組織と Integration Service の構成によって異なります。設定、認証、利用可能なノードなど、コネクタ固有のドキュメントについては、UiPath Integration Service のドキュメントをご覧ください。

Integration Service のコネクタに関するドキュメント

関連ページ

• HTTP 要求ノード: コネクタが存在しない場合の汎用 API 呼び出し
• トリガー: コネクタベースのトリガーとその他の種類のトリガー
• エラー処理: コネクタ ノードからのエラーを処理する
• 変数とデータ フロー: $vars を使用してコネクタの出力にアクセスする