2.0
  1. エンティティの側面

MongoDBから連絡先へのマップデータ

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

xConnectエンドポイントを更新してください

xConnectに接続する際にはモデルを指定する必要があります。モデルは利用可能なファセットを定義します。ロイヤルティプログラムデータをxConnectに書き込むためには、xDBデータ移行ツールを作成したモデルをxConnectに使用するように設定する必要があります。

  1. コンテンツエディターでテナントを選択します。

  2. エンドポイント / プロバイダー / xConnect / xConnect クライアントエンドポイントへナビゲーション

    select-xconnect-endpoint.png
  3. ツールバーで 「展開済みモデルを表示」をクリックします。

    show-deployed-models-button.png
  4. ポップアップダイアログに、作成してxConnectにデプロイしたカスタムモデルが表示されるはずです。 OKをクリックします。

    Collection Model Information dialog with the name of the custom model highlighted in red.

    !注カスタムモデルがリストにない場合は、そのモデルがxConnectサーバーにデプロイされていないことを意味します。続ける前に、まずモデルをデプロイする必要があります。

  5. コレクションモデルフィールドで作成したカスタムモデルを選択してください。

    The Collection Service section with the custom model selected in the Collection model field.
  6. アイテムを保存してください。

接触モデルを解決するパイプラインステップを更新します

  1. コンテンツエディターでテナントを選択します。
  2. パイプラインへのナビゲーション / MongoDB 連絡先 xConnect 移行パイプライン / MongoDB パイプラインからの単一連絡先処理 / xDB トラッカーIDによる接触モデルの解決 xConnectからの
  3. フィールドのファセットを見つけて読み取ってください。
  4. 選択されたファセットリストに以下の項目を追加してください:コレクションモデル> xDBデータマイグレーションツール>カスタムマイグレーションモデル>ファセット> > LoyaltyProgramにお問い合わせください。
  5. アイテムを保存してください。

MongoDBから読み取るデータを指定してください

MongoDBで連絡先からデータを読み取るためには、xDBデータ移行ツールにMongoDB文書内のデータの検索方法を指示する必要があります。このセクションでは、MongoDBに保存された連絡先からロイヤルティプログラムデータを読み取れるようにツールの設定方法を説明します。

  1. コンテンツエディターでテナントを選択します。

  2. データアクセス / 値アクセスセット / プロバイダ / MongoDB / MongoDB コンタクトへナビゲーション

  3. 以下の項目を追加してください:

    テンプレート

    MongoDB ドキュメントフィールド値アクセサ

    アイテム名

    MongoDBのロイヤルティプログラム Contact

  4. 新しいアイテムを選択してください。

  5. 以下のフィールド値を設定します:

    フィールド

    価値

    フィールド名

    LoyaltyProgram

  6. アイテムを保存してください。

  7. 入居者を選びましょう。

  8. データアクセス / 値アクセスセット / プロバイサ / MongoDBへのナビゲーション

  9. 以下の項目を追加してください:

    テンプレート

    MongoDB ドキュメント値アクセスセット

    アイテム名

    MongoDB コンタクト・ロイヤルティ・プログラム

  10. MongoDB Contact Loyalty Programの項目を選択してください。

  11. 以下の項目を追加してください:

    テンプレート

    MongoDB ドキュメントフィールド値アクセサ

    アイテム名

    MongoDB Contact Loyalty Program での登録日

  12. 新しいアイテムを選択してください。

  13. 以下のフィールド値を設定します:

    フィールド

    価値

    フィールド名

    入学日

    BSONフィールドバリューリーダー

    Bson Value リーダーズ > Bson デートタイム バリューリーダー

  14. アイテムを保存してください。

  15. MongoDB Contact Loyalty Programの項目を選択してください。

  16. 以下の項目を追加してください:

    テンプレート

    MongoDB ドキュメントフィールド値アクセサ

    アイテム名

    MongoDBのホームストアID Contactロイヤルティプログラム

  17. 新しいアイテムを選択してください。

  18. 以下のフィールド値を設定します:

    フィールド

    価値

    フィールド名

    ホームストアID

    BSONフィールドバリューリーダー

    Bsonバリューリーダー > Bsonストリングバリューリーダー

  19. アイテムを保存してください。

  20. MongoDB Contact Loyalty Programの項目を選択してください。

  21. 以下の項目を追加してください:

    テンプレート

    MongoDB ドキュメントフィールド値アクセサ

    アイテム名

    MongoDB ContactロイヤルティプログラムのメンバーシップIDです

  22. 新しいアイテムを選択してください。

  23. 以下のフィールド値を設定します:

    フィールド

    価値

    フィールド名

    MembershipId

    BSONフィールドバリューリーダー

    Bson Valueリーダーズ > Bson Int32 Value リーダー

  24. アイテムを保存してください。

xConnectの接触面に書き込むデータを指定してください

xConnectで連絡先にデータを書き込むには、xDBデータ移行ツールにそのデータの書き込み方法を指示する必要があります。このセクションでは、そのデータのために作成したカスタム連絡先の側面にロイヤルティプログラムのデータを書き込めるようにツールの設定方法を説明します。

  1. コンテンツエディターでテナントを選択します。

  2. データアクセス / 値アクセスセット / プロバイダー / xConnectへナビゲーション

  3. 以下の項目を追加してください:

    テンプレート

    xConnect エンティティ ファセット 値 アクセサセット

    アイテム名

    xConnect 連絡先 ロイヤルティプログラム情報の側面

  4. 項目xConnect 連絡先 ロイヤルティプログラム情報 オプションを選択してください。

  5. 以下の項目を追加してください:

    テンプレート

    xConnect エンティティ ファセットプロパティ バリュー アクセサ

    アイテム名

    ロイヤルティプログラムの登録日 xConnect のファセット 連絡先

  6. 新しいアイテムを選択してください。

  7. 以下のフィールド値を設定します:

    フィールド

    価値

    ファセット特性

    コレクションモデル> xDBデータ移行ツール>カスタムマイグレーションモデル>ファセット> >LoyaltyProgram > EnrollmentDate お問い合わせ

  8. アイテムを保存してください。

  9. 項目xConnect 連絡先 ロイヤルティプログラム情報 オプションを選択してください。

  10. 以下の項目を追加してください:

    テンプレート

    xConnect エンティティ ファセットプロパティ バリュー アクセサ

    アイテム名

    ロイヤルティプログラム情報のホームストアID、xConnectの連絡先の側面

  11. 新しいアイテムを選択してください。

  12. 以下のフィールド値を設定します:

    フィールド

    価値

    ファセット特性

    コレクションモデル> xDBデータ移行ツール>カスタムマイグレーションモデル>ファセット> LoyaltyProgramの連絡先> > HomeStoreId

  13. アイテムを保存してください。

  14. 項目xConnect 連絡先 ロイヤルティプログラム情報 オプションを選択してください。

  15. 以下の項目を追加してください:

    テンプレート

    xConnect エンティティ ファセットプロパティ バリュー アクセサ

    アイテム名

    ロイヤルティプログラムの会員ID、xConnectの情報面、連絡先

  16. 新しいアイテムを選択してください。

  17. 以下のフィールド値を設定します:

    フィールド

    価値

    ファセット特性

    コレクションモデル> xDBデータ移行ツール>カスタムマイグレーションモデル>ファセット> >LoyaltyProgram > MembershipId に連絡

  18. アイテムを保存してください。

MongoDBの連絡先からxConnectの連絡先面へのマッピングを設定する

次に、前述のセクションで定義したデータのマッピング方法を設定する必要があります。これは、MongoDBドキュメントの各フィールドをxConnectのコンタクト面のプロパティに接続することを意味します。

  1. コンテンツエディターでテナントを選択します。

  2. 値マッピングセットへナビゲーション / MongoDB to xConnect 連絡先マッピング

    The MongoDB to xConnect Contact Mappings folder in the Content tree.
  3. 以下の項目を追加してください:

    テンプレート

    値マッピングセット

    アイテム名

    MongoDB ロイヤルティプログラムからロイヤルティプログラム情報面 xConnect Contact

  4. xConnect Contactの「MongoDB Loyalty Program」項目から「Loyalty Program Info」セクションを選択してください。

  5. 以下の項目を追加してください:

    テンプレート

    バリューマッピング

    アイテム名

    入学日

  6. 新しいアイテムを選択してください。

  7. 以下のフィールド値を設定します:

    フィールド

    価値

    ソースアクセサル

    データアクセス>価値アクセス装置はプロバイダー > > MongoDB > MongoDB連絡先ロイヤルティプログラム>登録日MongoDB設定します。

    ターゲットアクセサ

    データアクセス>価値アクセスセット プロバイダー > > xConnect > xConnect 連絡先 ロイヤルティプログラム情報 ファセット ロイヤルティプログラム情報 > ロイヤルティプログラムの登録日 連絡先 ファセット xConnect 連絡先

  8. アイテムを保存してください。

  9. xConnect Contactの「MongoDB Loyalty Program」項目から「Loyalty Program Info」セクションを選択してください。

  10. 以下の項目を追加してください:

    テンプレート

    バリューマッピング

    アイテム名

    ホームストアID

  11. 新しいアイテムを選択してください。

  12. 以下のフィールド値を設定します:

    フィールド

    価値

    ソースアクセサル

    データアクセス>価値アクセスセットはプロバイダー > > MongoDB > MongoDBロイヤルティプログラム>ホームストアID MongoDBロイヤルティプログラム

    ターゲットアクセサ

    データアクセス>価値アクセスセット プロバイダー > > xConnect > xConnect Contact ロイヤルティプログラム情報 ファセット > ホームストアID、ロイヤルティプログラム情報 xConnect Contact ファセット

  13. アイテムを保存してください。

  14. xConnect Contactの「MongoDB Loyalty Program」項目から「Loyalty Program Info」セクションを選択してください。

  15. 以下の項目を追加してください:

    テンプレート

    バリューマッピング

    アイテム名

    会員ID

  16. 新しいアイテムを選択してください。

  17. 以下のフィールド値を設定します:

    フィールド

    価値

    ソースアクセサル

    データアクセス>価値アクセスセット>プロバイダー > MongoDB > MongoDB連絡先ロイヤルティプログラム>連絡先ロイヤルティプログラムの会員ID MongoDB

    ターゲットアクセサ

    データアクセス>価値アクセスセット プロバイダー > > xConnect > xConnect 連絡先 ロイヤルティプログラム情報 > ロイヤルティプログラム情報の会員ID、xConnect 連絡先

  18. アイテムを保存してください。

xConnectコンタクトのファセットをどのように埋めるかを指定します

次に、xConnectの連絡先にあるロイヤルティプログラムのファセットをどのように埋めるかを指定する必要があります。つまり、そのファセットを前のセクションで設定したマッピングに接続するということです。

  1. コンテンツエディターでテナントを選択します。

  2. データアクセス / 価値アクセスセット / プロバイダー / xConnect / xConnect 連絡先へナビゲーション

  3. 以下の項目を追加してください:

    テンプレート

    xConnect エンティティ ファセット 値 アクセサセット

    アイテム名

    xConnect Contact 上のロイヤルティプログラム情報の側面

  4. 新しいアイテムを選択してください。

  5. 以下のフィールド値を設定します:

    フィールド

    価値

    面の定義

    コレクションモデル> xDBデータ移行ツール>カスタムマイグレーションモデル>ファセット> LoyaltyProgram >お問い合わせ

    マッピングセット

    価値マッピングセット xConnect 連絡先マッピング > MongoDB > MongoDB ロイヤルティプログラムからロイヤルティプログラム情報への xConnect Contact の側面

  6. アイテムを保存してください。

xConnectコンタクトの面のマッピングを、コンタクト用のエンティティモデルに追加します

xConnectに変更のバッチを提出することをサポートするために(個別に提出するのではなく)、xDBデータ移行ツールはエンティティモデルと呼ばれるオブジェクトを使って、変更をコンタクトに変更が提出できるまで保存しています。

新しいコンタクトの面にマッピングを追加する必要があります。

!注エンティティモデルとは何か、なぜ必要なのかについては、xConnect Provider for Data Exchange Frameworkの開発者ドキュメントをご覧ください。

  1. コンテンツエディターでテナントを選択します。

  2. 値マッピングセットへナビゲーション / MongoDBからxConnectへの接触マッピング / MongoDBから接触モデルへの接触

    The MongoDB Contact to Contant Model item seleced in the Content tree.
  3. 以下の項目を追加してください:

    テンプレート

    バリューマッピング

    アイテム名

    ロイヤルティプログラム情報の側面

  4. 新しいアイテムを選択してください。

  5. 以下のフィールド値を設定します:

    フィールド

    価値

    ソースアクセサル

    データアクセス>価値アクセスセット>プロバイダー > MongoDB連絡先でロイヤルティプログラムに連絡> MongoDB > MongoDB

    ターゲットアクセサ

    データアクセス>価値アクセスセット プロバイダー > > xConnect > xConnect Contact > ロイヤルティプログラムの側面 xConnect Contact

  6. アイテムを保存してください。

この記事を改善するための提案がある場合は、 お知らせください!