統合のカスタム・アクションに構成を追加

メモ： この記事は、Adobe、AWS Lambda、Genesys Cloud、Google、Microsoft Dynamics 365、Salesforce、Webサービス、Zendeskデータアクションの統合に適用されます。

カスタムアクションを作成するときは、最初に契約を追加してから設定を追加します。構成は、アクションがコントラクトを実装する方法を定義します。詳細については、データ操作のテストそしてカスタムアクションに設定を追加する。

メモ： アクションを公開した後に設定を変更できます。詳細については、カスタムアクションで設定を変更する。

クリックし、構成 ] タブ。
HTTPメソッドを選択してください。
下 リクエスト、アクションがWebサービスに送信するリクエストを設定します。 Genesysでは、下のフィールドを使用してリクエストを設定することをお勧めします。 単純な。
ヒント: 下のプロパティをクリックします 利用可能な入力 コピーしてすぐにリクエストに貼り付けることができます。これらの特性はあなたの入力契約から来ます。詳細については、カスタムアクションに契約を追加する。テンプレートでマクロを使うことができます。詳細については、データアクション用の速度マクロ。

表示されたフィールドに情報を入力します。表示されるフィールドは、選択したHTTP方式と追加したコントラクトによって異なります。
メモ:
- AdobeおよびAWS Lambdaデータアクションの統合とGoogle Cloud Functionsについては、特別リクエスト構成セクション。
- 過度にネストされたJSONオブジェクトは、データアクションサービスのパフォーマンスに影響を与える可能性があります。パフォーマンスを維持するため、JSONオブジェクトの深さは50レベルに制限されている。詳しくは、Genesys Cloud Developer Center のLimits をご覧ください。

リクエスト URL テンプレート
セットリクエストURLテンプレート HTTPリクエストがヒットしたリモートエンドポイントへ。
ヘッダ（オプション）
リモートエンドポイントに送信される要求にHTTPヘッダーとして追加されるキーと値のペア。
注意： Acceptヘッダーを設定する場合は、ヘッダー値としてJSONメディアタイプを使用する必要があります。
転送エンコーディング
Webサービスがサポートしていない場合転送エンコーディングに設定チャンク、追加転送エンコーディング：緩衝下ヘッダー。詳細については、カスタムアクションが予期せぬ理由で失敗する。
承認
要求構成に許可情報を含めることができます。詳細については、ユーザー定義資格情報タイプの使用方法そしてユーザー定義（OAuth）資格情報の種類を使用する方法。

特別リクエスト構成

AdobeまたはAWS Lambdaデータアクション統合に関連付けられている、またはGoogle Cloud Functionsを実行するカスタムアクションのリクエスト構成は、ウェブサービスの標準リクエスト構成とは異なります。

ヘッダー
でデータアクションに追加されたキーと値のペアランタイムのための認証処理：
- x-api-key
- x-gw-ims-org-id
- x-sandbox-name（設定されている場合）
  サンドボックス名を統合認証情報に追加するか、アクションのヘッダーとして追加できます。サンドボックス名が両方の場所に設定されている場合、統合はで構成され、ヘッダ使用データアクション。詳細については、データアクション統合を追加する。

リクエスト URL テンプレート
セットリクエストURLテンプレート AWS Lambda関数のARNに。詳細については、 AWS Lambda関数を呼び出すためのIAMリソースを作成する。
申請のタイプ
セット要求タイプに役職。このHTTPメソッドは、アクションがリクエスト設定とともにリクエストボディを送信することを保証します。
ヘッダー
に追加されるキーと値のペアカスタム上の地図 clientContext オブジェクト。の clientContext 次に、オブジェクトは呼び出しの値です環境オブジェクト。次の属性が存在する場合、それらは自動的に設定されます環境オブジェクト：
- ININ-組織ID
- ININ-Home-Organization-Id
- ININ-相関ID
- ININ-ユーザーID
- ININ-統合ID
のJavaの例 clientContext オブジェクト、参照インターフェースClientContext.
リクエストテンプレート
指定した値 リクエストテンプレート で利用可能になります イベント 呼び出されたAWS Lambda関数のパラメーター。

リクエスト URL テンプレート
セットするリクエストURLテンプレート場所あなたがしたいことをGoogleクラウド機能のデータアクションを実行するには： https://{location-of-function}-{project-owning-function}/{function-name}.
申請のタイプ
セット要求タイプに役職。
リクエストテンプレート
リクエストテンプレート を${input.rawRequest} に設定 .

要求の部分の詳細な説明については、データアクションの設定要求。

上級ユーザー（JSON）

JSONに精通している人はJSON入力オプションを使用できます。 JSONを作成するためのガイドとして、他のアクションまたは次の例の要求を使用してください。

{
  "requestUrlTemplate": "https://www.example.com/health/check/services/${input.service}",
  "requestType": "GET",
  "headers": {},
  "requestTemplate": "${input.rawRequest}"
}

下応答JSON設定を追加します。
JSON設定は、WebサービスまたはAWS Lambda関数からの応答がどのように処理されるかを定義します。

JSONを作成するためのガイドとして、他のアクションまたは次の例で応答を使用できます。成功テンプレートでマクロを使用する方法の詳細については、データアクション用の速度マクロ。

ヒント: 下のプロパティをクリックします 利用可能な出力 コピーしてすばやく応答に貼り付けます。これらの特性はあなたの生産契約から来ます。詳細については、カスタムアクションに契約を追加する。
```
{
      "translationMap": {
          "buildNumber": "$.Build-Version",
          "serviceName": "$.name",
          "status": "$.Status"
      },
      "successTemplate": "{\r\n      \t\"build\": ${buildNumber},\r\n      \t\"name\": ${serviceName},\r\n\"status\": ${status}\r\n      }"
 }
```
応答の部分の詳細な説明については、データアクションのレスポンス設定。

次、アクションをテストする検証および実行エラー

詳細については、統合のカスタムアクションについて。

統合の詳細については、データアクションの統合についてをご覧ください。

統合用のカスタムアクションに設定を追加する

上級ユーザー（JSON）