Salesforce Commerce Cloudのデジタルデータを IBM App Connect Enterprise で活用する

Salesforce Commerce Cloud Digital Data (旧称「Demandware」) は、顧客向けのオンライン統合ショッピング・エクスペリエンスを作成するためのクラウド・ベースのソリューションを企業に提供します。 このプラットフォームにより、企業は獲得した貴重な洞察から顧客のニーズを予測できるため、顧客は製品を参照して迅速かつ簡単に購入することができます。 IBM® App Connect Enterprise Salesforce Commerce Cloud Digital Data Input ノードおよび Salesforce Commerce Cloud Digital Data Request ノードが提供されており、これらを使用して Salesforce Commerce Cloud Digital Data と連携することができます。

以下のステップは、コネクター・ディスカバリーを使用して Salesforce Commerce Cloud Digital Data アカウントに接続し、 Salesforce Commerce Cloud Digital Data Request ノードを構成する方法を示しています。 同様の手順に従って、 Salesforce Commerce Cloud Digital Data Input ノードを含むフローを作成し、コネクター・ディスカバリーを介して構成することにより、 Salesforce Commerce Cloud Digital Data で新規または更新されたオブジェクトをモニターするように Salesforce Commerce Cloud Digital Data Input ノードを構成することができます。

1. 「 IBM App Connect Enterprise 」ツールキットで、 Salesforce Commerce Cloud Digital Data Request ノードを含むフローを作成します。
2. フロー内の Salesforce Commerce Cloud Digital Data Request ノードを選択して、エディターにノード・プロパティーを表示します。
3. 「基本」 タブで、 「コネクター・ディスカバリーの起動」をクリックします。
   コネクターのディスカバリー中に使用するポリシー・プロジェクトの名前とボールトの詳細を指定するパネルが表示されます。
4. コネクターのディスカバリー中に使用するポリシー・プロジェクトとボールトの詳細を指定します。
   1. 「ポリシー・プロジェクト」 フィールドに、コネクター・ディスカバリー中に作成されるポリシーを保管するために使用されるポリシー・プロジェクトを指定します。
      あるいは、「新規」をクリックし、新規ポリシー・プロジェクトの名前を指定して、新規ポリシー・プロジェクトを作成することもできます。 次に、「完了」をクリックします。
   2. コネクターのディスカバリー中に使用するボールトを指定します。 デフォルトでは、コネクター・ディスカバリー中に使用される資格情報は、 外部ディレクトリー・ボールトに保管されます。これは、任意の統合サーバーで使用できる App Connect Enterprise ボールトです。 あるいは、資格情報を統合サーバー・ボールトに保管することもできます。統合サーバー・ボールトは、統合サーバーの作業ディレクトリーに作成され、その特定の統合サーバーでのみ使用できます。
      資格情報の保管に使用するボールトを指定するには、以下のいずれかのトピックの 「コネクター・ディスカバリー・ウィザードの使用」 セクションのステップを実行します。

      • 外部ディレクトリ保管庫の設定
      • 統合サーバー・ボールトの構成
   3. 「ボールト鍵 (Vault key)」 フィールドに、ボールトに保管されている資格情報にアクセスするために使用するボールト鍵を入力します。 ボールト鍵の長さは 8 文字以上でなければなりません。
   4. オプション: デフォルトでは、指定されたボールト・ロケーションとボールト・キーが Toolkit の設定として保存されるため、コネクター・ディスカバリーの起動時に値が事前設定されます。 設定を保存しない場合は、ボールト設定に保存 を選択解除します。
5. 「ディスカバリーの起動」 をクリックして、 Salesforce Commerce Cloud Digital Data コネクターの「コネクター・ディスカバリー」ウィザードを開始します。
   「コネクター・ディスカバリー」 ウィンドウが表示されます。 既存の Salesforce Commerce Cloud Digital Data 接続 (アカウント) が使用可能な場合は、それらの接続のリストが表示されます。 既存の接続がない場合、 Salesforce Commerce Cloud Digital Data コネクターの状況は Not connectedとして表示されます。
   • 1 つ以上の Salesforce Commerce Cloud Digital Data 接続 (アカウント) が使用可能な場合は、以下のステップを実行します。
     1. 接続 (アカウント) をクリックして、使用する接続を選択します。
     2. 必要なオブジェクト・タイプをクリックし、オブジェクトに対して実行するアクションを選択します。 例えば、 Salesforce Commerce Cloud Digital Dataからカタログを取得するには、 「カタログ」 をクリックしてから、 「カタログの取得」をクリックします。
   • 既存の接続 (アカウント) がない場合は、以下のステップを実行します。
     1. 必要なオブジェクト・タイプをクリックし、そのオブジェクトに対して実行するアクションを選択します。 例えば、 Salesforce Commerce Cloud Digital Dataからカタログを取得するには、 「カタログ」 をクリックしてから、 「カタログの取得」をクリックします。
     2. 「接続」 をクリックします。
        Salesforce Commerce Cloud Digital Data アカウントの接続の詳細を入力するウィンドウが表示されます。 次の情報を入力します。

        • ベース URL ：お客様の Salesforce Commerce Cloudインスタンスのベース URL （またはプロトコルとホスト名）。
        • API バージョン: ご使用の Salesforce B2C Commerce インスタンスの API バージョン。
        • クライアント ID: Salesforce Commerce Cloud クライアント ID。
        • クライアント秘密鍵: Salesforce Commerce Cloud クライアント ID。

        これらの接続情報の取得または生成に関する詳細については、 『 IBM 』 の 「継続的デリバリー（CD）」ドキュメントにある「 Salesforce Commerce Cloud Digital Data での IBM App Connect の使用方法」 App Connect in containers を参照してください。

     3. 「接続」 をクリックします。
6. ウィザードで必要なコネクター・プロパティーを設定します。
   取得アクションまたは更新アクションの場合、 「条件の追加」 をクリックし、フィルターに掛けるプロパティーを選択することで、データを取得するための条件を追加できます。

   取得アクションまたは更新アクションの条件を追加する場合、オプションで条件フィルターを使用して、適用される条件を絞り込むことができます。 条件フィルターを使用するには、「閉じる」ボタン (X) をクリックして「コネクター・ディスカバリー」ウィザードを終了し、 条件フィルターの使用の手順を実行します。

   作成アクションの場合は、オプションで拡張モードを使用できます。 アクションのデフォルトの編集ビューでは、一部のアプリケーションには、一般的なユース・ケースでは必要ないために非表示になっているフィールドがあります。 より高度なユース・ケースでは、拡張モード編集に切り替えることができます。これにより、フローを編集するための追加機能が提供されます。 拡張モードを使用するには、「閉じる」ボタン (X) をクリックして「コネクター・ディスカバリー」ウィザードを終了し、 拡張モードの使用の手順を実行します。

   また、取得するレコードの最大数と、その制限を超えた場合に実行するアクションを指定するプロパティーを設定することもできます。

7. 「コネクター・ディスカバリー」ウィザードでのプロパティーの指定が完了したら、 「保存」をクリックします。
   Salesforce Commerce Cloud Digital Data への接続に使用される資格情報はボールトに保管され、その他の接続の詳細は Salesforce Commerce Cloud Digital Data ポリシーに保管されます。 ウィザードで設定したプロパティの値は、 IBM App Connect Enterprise Toolkit 内の Salesforce Commerce Cloud Digital Data Request ノードに返されます。
8. ディスカバリーを終了してプロパティー値を保存したら、ウィンドウの右上隅にある X をクリックするか、 Alt+F4を押して、「コネクター・ディスカバリー」ウィザードを終了します。
9. 「 IBM App Connect Enterprise 」ツールキットで、 「 Salesforce Commerce Cloud Digital Data Request 」ノードの編集画面に戻ります。
   「コネクター・ディスカバリー」ウィザード (ステップ 6) で設定したコネクター・プロパティーが、プロパティー・エディターの Salesforce Commerce Cloud Digital Data Request ノードに表示されるようになりました。 「基本」 タブには、ウィザードで設定した 「アクション」 プロパティーと 「オブジェクト」 プロパティーの値が表示されます。 例えば、ウィザードで カタログ > 「カタログの取得」 を選択した場合、以下のプロパティーがノードの 「基本」 タブに表示されます。

   • 処置 - RETRIEVEALL
   • オブジェクト - catalog

   処置 プロパティーおよび オブジェクト プロパティーの値は、読み取り専用形式で表示されます。 これらの値を変更するには、「コネクター・ディスカバリーの起動」を再度クリックし、「コネクター・ディスカバリー」ウィザードで新しい値を設定します。

   「スキーマ・ベース名」 プロパティーは、 Salesforce Commerce Cloud Digital Data コネクターとの間で送受信される要求メッセージおよび応答メッセージの形式を記述するスキーマ・ファイルのベース名を指定します。 スキーマ・ベース名は、ノードのディスカバリーを初めて実行したときに自動的に設定され、現在のフロー名とノード名に基づいています。 ディスカバリーを初めて実行する前にこのプロパティーを手動で設定した場合は、設定した値が使用されます。 ディスカバリー後にスキーマを名前変更する場合は、このプロパティーを編集して、プロジェクト内の名前変更されたスキーマで使用されるスキーマ・ベース名と一致するようにする必要があります。 ディスカバリー後にこのプロパティーを変更する場合は、一致するようにスキーマ名を変更するか、ディスカバリーを再実行する必要があります。

   「コネクター・ディスカバリー」ウィザードは、ディスカバリー中に選択されたアクションに応じて、要求スキーマと応答スキーマ、または応答スキーマのみのいずれかを生成します。 要求スキーマは、選択されたアクションおよびオブジェクトが要求メッセージを必要とする場合にのみ生成されます。 生成された要求スキーマは、要求メッセージの妥当性検査に使用されます。 アクションが RETRIEVE または DELETEの場合、コネクターによって返されるのは応答スキーマのみです。

   生成されたスキーマ・ファイルはプロジェクトに追加され、入力データまたは出力データを変換するために Mapping ノードで使用できます。 スキーマの完全なファイル名は、スキーマのベース名 ( gen/MyMessageFlow.Salesforce_Commerce_Cloud_Digital_Data_Requestなど) から派生し、接尾部に response.schema.json または request.schema.jsonが付きます。 「要求スキーマを開く」 または 「応答スキーマを開く」をクリックして、スキーマを開くことができます。

10. Salesforce Commerce Cloud Digital Data Request ノードのプロパティー設定が正しいことを確認してから、メッセージ・フローを保存します。
11. Salesforce Commerce Cloud Digital Data Request ノードの 「接続」 タブで、 「ポリシー」 プロパティーは、接続に使用されるセキュリティー ID の詳細を含むポリシーの名前を表示します。 ポリシーのタイプは Salesforce Commerce Cloud Digital Dataです。
    詳しくは、 Salesforce Commerce Cloud デジタル・データ・ポリシーを参照してください。
12. オプション: 「接続」 タブの 「タイムアウト」 プロパティーを設定して、ノードが Salesforce Commerce Cloud デジタル・データ による操作の処理を待機する時間 (秒単位) を指定します。
13. Salesforce Commerce Cloud Digital Data Request ノードの 「フィルター」 タブには、メッセージ・フローがデータを選択する方法を制御するプロパティーが含まれています。 これらのプロパティーの初期値は、「コネクター・ディスカバリー」ウィザードの Salesforce Commerce Cloud Digital Data コネクターに設定されたプロパティー値から取得されます。これには、フィルター・オプション・プロパティーおよび指定された条件 (ステップ 6で説明) が含まれます。 後で「コネクター・ディスカバリー」ウィザードに戻り、(例えば、新しい条件を追加して) プロパティーの値を変更すると、それらの更新はノード上のプロパティー・セットに反映されます。

    「フィルター・オプション」 プロパティーは、 Salesforce Commerce Cloud Digital Data Request ノードの実行時にどのオブジェクトを操作するかを制御します。 「フィルター制限」 プロパティーは、取得する項目の最大数と、制限を超えた場合に実行するアクションを制御します。

    値を変更するには、 「フィルター・オプション」 セクションで変更する値の横にある 「編集」 をクリックし、 「フィルター制限」 セクションで設定したプロパティー値を変更します。

    プロパティー値は、実行時に Salesforce Commerce Cloud Digital Data Request ノードに渡されるメッセージの内容から解決される、テキスト値、ESQL 式、または XPATH 式のいずれかになります。

14. 「要求」 タブで、 「データの場所」 プロパティーを設定して、 Salesforce Commerce Cloud Digital Dataで作成されるオブジェクト・データを含む、着信メッセージ・ツリー内の場所を指定します。 このデータは、 Salesforce Commerce Cloud Digital Data Request ノードから Salesforce Commerce Cloud Digital Dataに送信される要求を形成します。
15. 「結果」 タブで、 「出力データのロケーション」 プロパティーを設定して、 Salesforce Commerce Cloud デジタル・データで作成されたレコードのデータを含める、出力メッセージ・ツリー内のロケーションを指定します。
16. デフォルトでは、要求メッセージは、コネクターのディスカバリー中に生成された要求スキーマに照らして検証されます。 Salesforce Commerce Cloud Digital Data Request ノードの 「検証」 プロパティーを使用して、要求の検証をオフにしたり、検証設定を変更したりすることができます。
17. メッセージ・フローを 保存 します。