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

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

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

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

    表示されたフィールドに情報を入力します。 表示されるフィールドは、選択したHTTP方式と追加したコントラクトによって異なります。

    重要。   AdobeおよびAWS Lambdaデータアクションの統合とGoogle Cloud Functionsについては、 特別リクエスト構成 セクション。

    • リクエスト 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:/// v1 / projects / {project- 場所 -function} / locations / {場所場所 -function} / functions / {function-name}:call

    • 申請のタイプ

      セット 要求 タイプ に 役職。

    • リクエストテンプレート

      Set Request Template to { \”data\”: \”$esc.jsonString(${input.rawRequest})\” }. The Google Cloud Function call method expects an attribute named data that has the stringified JSON of your parameters. $esc.jsonString() takes the raw request and escapes it correctly for the JSON function.

       メモ:   交換できます $ {input.rawRequest} 文字列化される適切にフォーマットされたJSONを使用します。

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

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

    {{
     "requestUrlTemplate": "https://www.example.com/health/check/services/${input.service}"、
     "リクエストの種類": "得る"、
     「ヘッダー」: {}、
     "requestTemplate": "$ {input.rawRequest}"
     }

  • 応答JSON設定を追加します。

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

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

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

    応答の部分の詳細な説明については、 データアクションのレスポンス設定

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

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

統合の詳細については、 データアクションの統合について.