CONNECTREQUEST

Integration Hubリクエストを実行します。 このアクションで使用する接続にシークレットが含まれている場合は、このアクションを含むスクリプトでシークレットを使用できます。 このアクションをダブルクリックするとIntegration Hubが開き、このアクションで使用する接続の統合を設定できます。

依存関係

• このアクションにはIntegration Hubが必要です。
• このアクションは通常、ConnectAuthアクションと一緒に使用します。

• スクリプト内のこのアクションの各インスタンスが1つの接続を実行できます。 Integration Hubを開いて選択アイコンをクリックして、このアクションに接続を割り当てます。

• Studioリクエストについては、requestPayloadプロパティに、URL、ヘッダー、動詞、パラメーター、シークレットなどを含むリクエストの詳細を含むダイナミックオブジェクトを設定する必要があります。 内容はJSON形式でなければなりません。 動的オブジェクトとそのメンバーをJSONに変換するには、Snippetアクションを使用します。

サポートされているスクリプトタイプ

一般	Eメール	チャット	電話	ボイスメール	ワークアイテム	SMS

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

プロパティ	説明
Add Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。
connectName	このアクションで使用する特定の接続を定義します。 このアクションをダブルクリックすると、Integration Hubから接続を割り当てることができます。
requestName	このアクションで実行する、指定されたコネクターで設定された特定のリクエストを定義します。 このアクションをダブルクリックすると、Integration Hubからリクエストを割り当てることができます。
requestPayload	指定されたリクエストのペイロードをJSON形式で入力します。 リクエストをJSONに変換するには、Snippetアクションを使用できます。

出力プロパティ

これらのプロパティには、実行したアクションから返されたデータを保持する変数が含まれています。 これらはアクションが完了したときに参照・使用することができます。

プロパティ	説明
requestBodyVarName (out)	リクエストの本文を保持します。 デフォルトはrequestBodyです。
requestErrorDetailsVarName (out)	リクエストでエラーが発生した場合にエラーの詳細を保持します。 デフォルトはrequestErrorDetailsです。
requestHeadersListVarName (out)	リクエストヘッダーのリストを保持します。 デフォルトはrequestHeadersListです。
requestProxyVarName (out)	リクエストのプロキシを保持します。 デフォルトはrequestProxyです。

結果分岐条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。 他のブランチが未定義の場合にも使用されます。
OnError	アクションが正しく実行されなかったときにとられるパス。 たとえば、構文エラー、HTTPエラーコードなど予期しない問題が発生したときに使用されるパス。 ERR変数には、問題の簡潔な説明を入力する必要があります。
OnSuccess	アクションがエラーなしで完了し、API呼び出しまたはデータの戻りが成功した場合に実行されるパス(2xx応答コード)。
OnTimeout	Integration Hubの要求設定で定義されているミリ秒数の間、要求から応答がない場合に実行されるパス。