---
title: "MongoDBから連絡先へのマップデータ"
slug: "map-data-from-mongodb-to-contact-facet"
abstract: "MongoDBの連絡先データをxDB Data MIgration ToolのxConnect接触面にマッピングする方法。"
---
# MongoDBから連絡先へのマップデータ

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

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

1.  コンテンツエディターでテナントを選択します。
    
2.  *エンドポイント / プロバイダー / xConnect / xConnect クライアントエンドポイント*へナビゲーション
    
    ![select-xconnect-endpoint.png](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/dmt/50/xdb-data-migration-tool/images/select-xconnect-endpoint.png)
    
3.  ツールバーで **「展開済みモデルを表示**」をクリックします。
    
    ![show-deployed-models-button.png](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/dmt/50/xdb-data-migration-tool/images/show-deployed-models-button.png)
    
4.  ポップアップダイアログに、作成してxConnectにデプロイしたカスタムモデルが表示されるはずです。 **OK**をクリックします。
    
    ![Collection Model Information dialog with the name of the custom model highlighted in red.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/dmt/50/xdb-data-migration-tool/images/show-deployed-models-popup.png)
    
    > !注カスタムモデルがリストにない場合は、そのモデルがxConnectサーバーにデプロイされていないことを意味します。続ける前に、まずモデルをデプロイする必要があります。
    
5.  **コレクションモデル**フィールドで作成したカスタムモデルを選択してください。
    
    ![The Collection Service section with the custom model selected in the Collection model field.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/dmt/50/xdb-data-migration-tool/images/collection-model-field.png)
    
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.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/dmt/50/xdb-data-migration-tool/images/mongodb-to-xconnect-contact-mappings.png)
    
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.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/dmt/50/xdb-data-migration-tool/images/mongodb-contact-to-contact-model1.png)
    
3.  以下の項目を追加してください:
    
    テンプレート
    
    **バリューマッピング**
    
    アイテム名
    
    **ロイヤルティプログラム情報の側面**
    
4.  新しいアイテムを選択してください。
    
5.  以下のフィールド値を設定します:
    
    フィールド
    
    価値
    
    ソースアクセサル
    
    *データアクセス>価値アクセスセット>プロバイダー > MongoDB連絡先でロイヤルティプログラムに連絡> MongoDB > MongoDB*
    
    ターゲットアクセサ
    
    *データアクセス>価値アクセスセット プロバイダー > > xConnect > xConnect Contact > ロイヤルティプログラムの側面 xConnect Contact*
    
6.  アイテムを保存してください。