外部アクションの設定

管理 > 設定​に移動します。

中間パネルで「外部アクション」をクリックします。

{width="800" modal="regular"}

右上の「アクションを作成」をクリックします。

外部サービスのOpenAPI仕様のURLを入力し、作成​をクリックします。

{width="500"}

このステップを成功させるには、外部サービスがライブで到達可能である必要があります。 検証エラーがある場合、ダイアログには、エラーを説明するメッセージと、そのエラーを解決するための提案が表示されます。 詳しくは、トラブルシューティング​を参照してください。

URLが正常に解決したら、サービスの詳細​を確認します。

サービスの詳細は、アクションの作成時にOpenAPI仕様から直接読み取られます。 作成後に設定でこれらのプロパティを変更することはできません。

外部サービス （components.securitySchemes）の​ 認証 ​資格情報を入力します。

{width="600" modal="regular"}

設定されたアクションが​ ドラフト ​または​ アクティブ ​の状態にある場合、必要に応じて資格情報を変更できます。

「次へ」をクリックします。

アクションが外部サービスとデータを交換する方法を定義するには、設定 プロパティを設定します。

• アクションの種類 （静的） – サポートされているジャーニーノードの種類：

  • 外部アクション ​ （enableSplitPath = false）
  • 外部アクション分割パス ​ （enableSplitPath = true）

  アクション設定の作成後にアクションタイプを変更することはできません。

• アクセサー （静的） – （外部アクション分割パスのみ）外部サービスによって返される変数は、外部スプリットパスノードのパス条件として使用できます。 (invocationPayloadDef.accessorsMetadata)

• ジャーニーコンテキスト （静的） – リクエストで送信されたオーディエンスデータの範囲（supportedEntityType）:

  • ​ アカウント ​ - アカウントのみを送信

  • 人物 – 人物のみを送信

  • ​ アカウントのユーザー - アカウントおよびアカウント関連のユーザーを送信します

• 送信フィールド - テーブル内の各フィールドをXDM フィールド ​にマッピングします。 これらのフィールドは、リクエスト本文で外部サービスに送信されます。 サービス定義プロパティ：invocationPayloadDef.accountFields、invocationPayloadDef.fields。

  {width="600" modal="regular"}

• 受信フィールド - テーブル内の各フィールドを更新可能なXDM フィールド ​にマッピングします。 これらのフィールドは、外部サービス応答から入力されます。 サービス定義プロパティ：callbackPayloadDef.accountFields、callbackPayloadDef.fields。 作成後に更新可能。

• ヘッダーパラメーター - リクエストでHTTP ヘッダーとして渡す各行の値を入力します。 サービス定義プロパティ：invocationPayloadDef.headers。

• タイムアウト - リクエストが失敗したと見なされるまでのコールバックを外部サービスが呼び出すのを待つ時間を分単位で入力します。 サービス定義プロパティ：timeout。

• グローバル属性 - リクエスト本文に静的フィールドとして含める各行の値を入力します。 サービス定義プロパティ：invocationPayloadDef.globalAttributes。

  {width="600" modal="regular"}

戻る矢印​をクリックしてリストに戻り、アクションを​ ドラフト ​状態に保ちます。

または、アクティブ化​をクリックして、アクション設定を​ アクティブ ​状態に変更します。 設定された外部アクションは、アカウントジャーニーで使用できるようにするためにアクティブである必要があります。