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


注意:この記事は、Adobe、AWS Lambda、Google、Microsoft Dynamics 365、 PureCloud 、 Salesforce 、Webサービス、およびZendeskデータアクションの統合に適用されます。

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

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

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

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

    特別リクエスト構成

    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-O 作動 ID
      • ININ-H オム組織-ID
      • ININ-C または関係-ID
      • ININ-U ザー ID
      • ININ-I 度-ID

      のJavaの例 clientContext オブジェクト、参照 インターフェースClientContext

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

      指定した値 リクエストテンプレート で利用可能になります イベント 呼び出されたAWS Lambda関数のパラメーター。

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

      セットする リクエストURLテンプレート 場所あなたがしたいことをGoogleクラウド機能のデータ アクションを実行するには:https://cloudfunctions.googleapis.com/ v1 / projects / {project- 場所 -function} / locations / {場所場所 -function} / functions / {function-name}:call

    • 申請の種類

      セット 要求 タイプ役職

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

      セットする リクエストテンプレート{ \ \” data \ \”: \ \” $ esc.jsonString($ {input.rawRequest}) \ \”}. Google Cloud Function呼び出しメソッドは、名前付きの属性期待し属性 データ パラメータの文字列化されたJSONがあります。 $ esc.jsonString() 生のリクエストを受け取り、JSON関数で正しくエスケープします。

      注意:交換できます $ {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      }"
     }

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

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

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

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