--- title: "xDBからCDPへの移行ツールを使います" slug: "use-the-xdb-to-cdp-migration-tool" abstract: "XP(xDB)からCDPへの顧客情報移行方法" --- # xDBからCDPへの移行ツールを使います このトピックでは、Sitecore ConnectでxDB to CDP移行ツールのインストール、設定、実行に必要な手順を概説します。 > !注**始める前に**以下を必ず確認してください: > > - Sitecore Experience Platform(XP)ライセンスと、顧客データを含むXPインスタンスバージョン9.0以降が必要です。 > > - Sitecore CDPライセンスとCDPインスタンスです。 > > - アクティブなSitecore Connectインスタンスです。 > このウォークスルーでは、以下の方法を説明します: - [パッケージをSitecore Connectにインストールしてください](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/use-the-xdb-to-cdp-migration-tool.html#UUID-17dc8548-b1c5-c2f9-3912-7b085b0f9318_section-idm463157918707523300893103881 "Install the package in Sitecore Connect") - [xConnectを通じてXPインスタンスへの接続を確立します](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/use-the-xdb-to-cdp-migration-tool.html#UUID-17dc8548-b1c5-c2f9-3912-7b085b0f9318_section-idm4655203599211234244669236447 "Establish connection to your XP instance through xConnect") - [xConnectを通じてCDPへの接続を確立する](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/use-the-xdb-to-cdp-migration-tool.html#UUID-17dc8548-b1c5-c2f9-3912-7b085b0f9318_section-idm4655203570976034244669583405 "Establish connection to CDP through xConnect") - [XCM REC002 | を設定してください |xDBレシピから接点をロード・変換します](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/use-the-xdb-to-cdp-migration-tool.html#UUID-17dc8548-b1c5-c2f9-3912-7b085b0f9318_section-idm453606203487363424467064205 "Configure the [XCM] REC002 | Load And Transform Contacts From xDB recipe") - [マイグレーションツールを実行します](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/use-the-xdb-to-cdp-migration-tool.html#UUID-17dc8548-b1c5-c2f9-3912-7b085b0f9318_section-idm4494637882256034244671056274 "Run the migration tool") ## パッケージをSitecore Connectにインストールしてください パッケージをインストールするには、xConnectアカウントにインポートする必要があります。 Sitecore Connectでパッケージをインストールするには: 1. [移行パッケージをダウンロード](https://developers.sitecore.com/downloads/xDB_to_CDP_Migration)してください。 2. Sitecore Connectポータルに行け。 3. **ツール**\>**レシピライフサイクル管理**へ移動します。 ![Recipe lifecycle management in Sitecore Connect](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-sitecore-connect-tools.png) 4. インポート **タブをクリックして** から **インポート**をクリックします。 ![The Import tab under Recipe lifecycle management in Sitecore Connect](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-import-package.png) 5. ステップ1でダウンロードしたパッケージを選択してください。以下の [レシピ](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/the-xdb-to-cdp-migration-tool.html "The xDB to CDP migration tool") が表示されます: ![An example of imported recipes in Sitecore Connect](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-recipes.png) - \[XCM\] REC001 |加工レシピトリガー - \[XCM\] REC002 |xDBからの負荷および変換接点 - \[XCM\] REC003 |連絡先をCDPにアップロード - \[XCM\] REC004 |連絡先をIDで移行する > !注また、Sitecore XP ConnectionとSitecore CDP Connectionの接続も確認できます。インスタンスに接続するには、まず設定を更新する必要があります。 これで移行パッケージをSitecore Connectアカウントに正常にインポートしました。 ## xConnectを通じてXPインスタンスへの接続を確立します パッケージをインポートした後、xConnectを通じてXPインスタンス内のxDBへの接続を確立します。 接続を確立する前に、.pfxファイルから証明書とキーを取得する必要があります。 証明書と鍵を取得するには: 1. OpenSSLを開始してください。Gitをインストールしている場合、以下のフォルダでopensslを見つけられます: cd 'C:\\Program Files\\Git\\mingw64\\bin\\' 2. PowerShellで以下のコマンドを実行します: .\\openssl.exe pkcs12 -info -in C:\\Users\\\\Downloads\\myCert.pfx 関連性を確立するために: 1. Sitecore Connectでは、**Assets** > **Connections**にアクセスしてください。 2. 以前インポートしたSitecore XP Connectionを開きます。 3. xConnectに接続するには以下の情報を入力してください: - **Connection Name** - xConnectへの接続のために定義する名前。 このパラメータは、Workatoアカウント内の複数の接続を特定し管理するのに役立ちます。 - **Certificate** - xConnect証明書の値を使用。 > !重要 \-----BEGIN CERTIFICATE----- と \-----END CERTIFICATE----- 行を含める必要があります。 これはxConnectサービスとの安全な通信に必要なSSL証明書です。この証明書はWorkatoとxConnect間で交換されるデータの機密性と完全性を保証します。 - **Key** - xConnect証明書の値を使用。 > !重要\----- ENCRYPTED PRIVATE KEY ----- と \----- END ENCRYPTED PRIVATE KEY ----- 行を含める必要があります。 これはSSL証明書に関連付けられた秘密鍵です。この鍵はSSLハンドシェイクプロセス中の暗号化および復号に使用されます。 - **Passphrase** - xConnect証明書の値を使用。 - **URL** - xConnectサービスのURLエンドポイントを入力します。 このパラメータは、xConnectサービスがホストされアクセス可能な場所を指定します。 - オンプレミスインスタンスXP: \\App\_Configフォルダに行き、ConnectionStrings.configファイルを開いて**xconnect.collection**フィールドの値をコピーして**URL**フィールドに貼り付けてください。 - XPのインスタンスがAzure上で動作していてXP0インスタンスがある場合、**xc-single** App ServiceのURLを使います。URLのフォーマットは次のようになります: https://-xc-single.azurewebsites.net - XPのインスタンスがAzure上で動作していてXP1インスタンスがある場合は、**xc-search**アプリのURLを使ってください。URLのフォーマットは次のようになります: https://-xc-search.azurewebsites.net 4. **Connect**をクリックします。接続が成功すると、画面は以下のようになります: ![When connecting to XP (xDB) in Sitecore Connect is successful](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-xconnect-successful1.png) > !注環境によっては、ファイアウォールがSitecore Connect XPインスタンスへの接続を妨げることがあります。この問題を解決するために、[Workatoで許可されているIPをホワイトリストに追加して](https://docs.workato.com/security/ip-allowlists.html)IPホワイトリストを使うことを検討してください。 これでXPインスタンスに正常に接続されました。 ## xConnectを通じてCDPへの接続を確立する XPインスタンスに接続した後、xConnectを通じてCDPインスタンスへの接続を確立します。 1. Sitecore Connectでは、**Assets** > **Connections**にアクセスしてください。 2. 以前インポートしたSitecore CDP Connectionを開きます。 3. **ロケーション**フィールドで、接続を保存したいプロジェクトまたはフォルダを選択し、ページの指示に従って残りのフィールドを埋めてください。 4. **クライアントID**と**クライアントシークレット**は省略できます。 5. **Connect**をクリックします。接続が成功すると、画面は以下のようになります: ![When connecting to CDP in Sitecore Connect is successful](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-xconnect-to-cdp-successful.png) これでCDPインスタンスに正常に接続されました。 ## XCM REC002 | を設定してください |xDBレシピから接点をロード・変換します XCM REC002 | Load And Transform Contacts From xDBレシピには既知の接点だけが移行されるフィルターが内蔵されています。追加のフィルターを1つ追加できます。 カスタムファセットを移行したい場合は、レシピを設定する*前に*手動でカスタムファセットの[マッピングを作成する](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/select-and-map-custom-facets-to-be-migrated-with-your-contacts.html "Select and map custom facets to be migrated with your contacts")必要があります。 レシピにフィルターを追加するには: 1. Sitecore ConnectでXCM REC002 | Load and Transform Contacts From xDBレシピを開きます。 ![Example of a recipe in Sitecore Connect](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-configure-recipe.png) 2. レシピのステップ5で、「 **xConnectから少なくとも1つの既知の連絡先識別子を含むすべての連絡先**を取得する」をクリックしてください。 ![Example of a step in a recipe in Sitecore Connect](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-get-all-contacts.png) 3. 右上隅で **編集**をクリックします。 ![Example of a recipe step in edit mode in Sitecore Connect](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-edit-get-all-contacts.png) 4. 「 **フィルターを有効にする** 」リストで*Yes*を選択します。 5. **フィルタープロパティ**リストで、ファセット、演算子、値を選択します。 ![Set filter properties for a recipe in Sitecore Connect](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-filter-property.png) 6. 右上で **「保存** 」をクリックして変更を保存します。 レシピの設定は完了しました。 ## マイグレーションツールを実行します フィルターを使うオプションで連絡先を移行するには、以下の順序で最初の3つのレシピを実行する必要があります。 IDに基づいて連絡先を移行するには、4つ目のレシピだけを実行します。 > !注**始める前に**カスタムファセットがある場合は、レシピを実行する*前に*[マッピングを設定する](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/select-and-map-custom-facets-to-be-migrated-with-your-contacts.html "Select and map custom facets to be migrated with your contacts")必要があります。CDPでは、ゲストデータ拡張にマッピングされるのは組み込みのファセットのみです。 > > CDPテナントのデフォルトアイデンティティルールを変更したり、新しいルールを追加した場合は、レシピを実行する前に [ゲスト識別子を設定する](https://doc.sitecore.com/xp/ja/developers/93/sitecore-experience-platform/configure-guest-identifiers-in-the-xdb-to-cdp-migration-tool.html "Configure guest identifiers in the xDB to CDP Migration Tool") 必要があります。 フィルタリングオプション付きの連絡先を移行するには: 1. Sitecore Connectで XCM REC002 | Load and Transform Contacts From xDB レシピを開き、「 **レシピ開始**」をクリックします。 2. XCM REC003 | Upload Contacts to CDPレシピを開き、「**レシピ開始**」をクリックします。 3. XCM REC001 | Processing Recipe Triggerを開き、「**テストレシピ**」をクリックします。 IDに基づいて特定の連絡先を移行するには: - Sitecore Connectで XCM REC004 | Migrate Contacts by ID レシピを開き、「 **テストレシピ**」をクリックします。 > !ヒントWorkatoは各ステップの状況をリアルタイムでフィードバックし、成功したか失敗したか、警告に遭遇したかを示します。ジョブの実行を監視するには、「ジョブ」タブをクリックし、その後個別のジョブをクリックしてください。 > > ![In Sitecore Connect, monitor the execution of a job.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/93/sitecore-experience-platform/images/xdb-cdp-monitor-job-execution.png) XPインスタンスからCDPインスタンスへの連絡先情報の移行は成功しました。