コネクタ ノード

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

それらは何ですか

コネクタ ノードを使用すると、HTTP 要求を自分で設定することなく、キャンバスから直接他のアプリを操作できます。各コネクタは、GitHub、Salesforce、Slack、Microsoft 365 など、1 つのアプリ用の既製のノードと、型指定された入力と出力、およびサインインを処理するコネクションを提供します。

コネクタ ノードは、[ノードを追加] パネルの [コネクタ] カテゴリにあります。このカテゴリは [HTTP 要求] で始まり、任意の Web アドレスを呼び出して、その後に Act!365 以降。各アプリでアクションのリストが開きます。

利用可能なコネクタ

利用可能なコネクタは組織によって異なり、[ノードを追加] パネルの [コネクタ] カテゴリにすべてのコネクタのリストが表示されます。Salesforce、ServiceNow、Slack などのアプリに対応しています。一般的なコネクタ 最も一般的なコネクタへの リンク。『Integration Service ガイド』の 「コネクタ」 では、各コネクタの設定、サインイン、操作について説明しています。

動作のしくみ

[ ノードを追加 ] パネルに、組織で利用可能なコネクタが一覧表示されます。各コネクタ ノードは、ターゲット サービス上の特定の API 操作にマップされます。

When you add a connector node to the canvas, Maestro Orchestrate fetches its input schema and renders a dynamic configuration form in the properties panel. You fill in the required fields, select a connection for authentication, and the node handles the API call at runtime.

構成

コネクション

Every connector node needs a connection, which signs UiPath in to the app with your account. You select the connection in the properties panel when you set up the node. The connection field lists the existing connections, grouped by folder, with Add new connection to create one without leaving the canvas, and Open connections to review all of them. Create a connection has the steps.

Connections handle token refresh, OAuth workflows, and credential storage automatically. Auth headers and secrets are not managed directly. Connections are managed by Integration Service. Connections in the Integration Service guide describes how to share and manage them.

ノード固有の入力

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

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

次のステップ

• 人気のコネクタ: 最も一般的なアプリと、各コネクタへのリンク
• Create a connection: create a connection from the node
• HTTP 要求ノード: コネクタが存在しない場合の汎用 API 呼び出し
• トリガー: コネクタベースのトリガーとその他の種類のトリガー
• エラー処理: コネクタ ノードからのエラーを処理する
• 変数とデータ フロー: $vars を使用してコネクタの出力にアクセスする