当事者およびグローバル アドレス帳モデルへのアップグレード
Microsoft Azure Data Factory のテンプレートを使用すると、デュアルライトの既存データをパーティとグローバル アドレス帳モデル (取引先企業、取引先担当者、ベンダー テーブルのデータ、郵便、電子アドレス) にアップグレードすることができます。
データファクトリーのテンプレートには以下の 3 種類が用意されています。 財務と運用アプリおよび Customer Engagement アプリの両方からのデータを照合するのに役立ちます。
- 連絡先テンプレート (データをデュアルライト パーティ GAB schema/arm_template.json にアップグレードします) – このテンプレートは、アカウント、連絡先、仕入先 の各データに関連付けられている 関係者 および 連絡先 データのアップグレードに役立ちます。
- 関係者の住所テンプレート (データをデュアルライト パーティ schema/Upgrade to Party Postal Address - GAB/arm_template.json にアップグレードします) – このテンプレートは、アカウント、連絡先、仕入先 の各データに関連付けられている住所のアップグレードに役立ちます。
- 関係者の電子住所テンプレート (データをデュアルライト パーティ schema/Upgrade to Party Postal Address - GAB/arm_template.json にアップグレードし、パーティの電子住所 GAB/arm_template.json にアップグレードします) – このテンプレートは、アカウント、連絡先、仕入 の各データに関連付けられている電子住所のアップグレードに役立ちます。
プロセスの最後に、以下のカンマ区切りの値 (.csv) ファイルが生成されます。
ファイル名 | 使用方法 |
---|---|
FONewParty.csv | このファイルは、財務と運用アプリ内で新しい関係者レコードの作成に使用します。 |
ImportFONewPostalAddressLocation.csv | このファイルは、財務と運用アプリ内で新しい 配送先住所のロケーション レコードの作成に使用します。 |
ImportFONewPartyPostalAddress.csv | このファイルは、財務と運用アプリ内で新しい関係者の住所レコードの作成に使用します。 |
ImportFONewPostalAddress.csv | このファイルは、財務と運用アプリ内で新しい住所レコードの作成に使用します。 |
ImportFONewElectronicAddress.csv | このファイルは、財務と運用アプリ内で新しい電子アドレス レコードの作成に使用します。 |
この記事では、Data Factory のテンプレートを使用し、データをアップグレードする方法について説明します。 カスタマイズを実行しない場合は、このテンプレートをそのまま使用できます。 ただし、取引先企業、連絡先、ベンダー データをカスタマイズする場合は、この記事で説明するようにテンプレートを変更する必要があります。
重要
関係者の住所と関係者の電子アドレスのテンプレートを実行するための特別な指示があります。 最初にパーティのテンプレートを起動し、次にパーティの配送先住所のテンプレートを起動し、次にパーティの電子住所のテンプレートを起動する必要があります。 各テンプレートは、個別のデータ ファクトリでインポートするように設計されています。
必要条件
パーティのグローバルアドレス帳モデルにアップグレードするには、以下の前提条件が必要です:
- Azure のサブスクリプションに登録している必要があります。
- このテンプレートへのアクセス許可が必要です。
- 既存の二重書き込み顧客である必要があります。
- 当事者およびグローバル アドレス帳ソリューションがインストールされている場合は、Microsoft.Dynamics.SCMExtended.Plugins.Plugins.LeadPripripriyContactPostCreate: QualifyLead of lead.
アップグレードの準備
アップグレードには以下の準備が必要です:
- 完全同期: Finance and Operations 環境と Customer Engagement 環境の両方で、取引先企業 (顧客)、取引先担当者、ベンダー の各テーブルが完全に同期された状態になります。
- 統合キー: Customer Engagement アプリの取引先企業 (顧客)、連絡先、および仕入先テーブルは、既成の統合キーを使用しています。 統合キーをカスタマイズした場合は、テンプレートをカスタマイズする必要があります。
- 当事者番号 : すべての アカウント (顧客)), 顧客および 顧客 当事者番号が必要です。 パーティ番号がないレコードは無視されます。 これらのレコードをアップグレードする場合は、アップグレード処理を開始する前に、それらのレコードにパーティ番号を追加します。
- システム - アップグレード プロセスを作成する場合は、財務と工程の両方をオフラインにする環境顧客環境する必要があります。
- スナップショット: 財務と運用アプリと Customer Engagement アプリ両方のスナップショットを作成します。 その後、必要に応じてスナップショットを使って以前の状態を復元することができます。
展開
テンプレートを Dynamics-365-FastTrack-Implementation-Assets からダウンロードします。
Azure ポータルにサインインします。
リソース グループを作成します。
作成したリソース グループにストレージ アカウントを作成します。
作成したリソース グループにData Factory を作成します。
Data Factory を開き、作成者 & モニター タイルを選択します。
管理タブで、ARM テンプレートを選択します。
ARM テンプレートをインポートするを選択して、パーティテンプレートをインポートします。
テンプレートをデータ ファクトリーにインポートします。 プロジェクトの詳細およびインスタンスの詳細に対して次の値を入力します。
フィールド 値 サブスクリプション Azure サブスクリプション リソース グループ ストレージ アカウントが作成されたのと同じリソースを提供します。 リージョン リージョン ID ファクトリー名 ファクトリー名 FO リンクされた Service_service プリンシパル キー アプリケーションのキー Azure Blob Storage_connection 文字列 Azure Blob Storage 接続文字列 Dynamics CRM リンクされた Service_password ユーザー名に指定したユーザーアカウントのパスワードです FO リンクされた Service_properties_type Properties_url https://sampledynamics.sandbox-operationsdynamics.com/data
FO リンクされた Service_properties_type Properties_tenant アプリケーションが所属するテナントに関する情報 (ドメイン名またはテナント ID) です FO リンクされた Service_properties_type Properties_aad リソース ID https://sampledynamics.sandboxoperationsdynamics.com
FO リンクされた Service_properties_type Properties_service プリンシパル ID アプリケーションのクライアント ID です Dynamics CRM リンクされた Service_properties_type Properties_username Dynamics 365 サービスに接続するために使用するユーザー名です 詳細については、次のトピックを参照してください。
配置後に、データ ファクトリのデータセット、データ フロー、およびリンクされたサービスを検証します。
管理に移動します。 接続で、リンクされたサービスを選択します。 DynamicsCrmLinkedService を選択します。 リンクされたサービスの編集 (Dynamics CRM) ダイアログ ボックスに、次の値を入力します。
フィールド 値 Name DynamicsCrmLinkedService 説明 エンティティ データをフェッチする CRM インスタンスに接続するリンクされたサービス 統合ランタイム経由の接続 AutoResolvelntegrationRuntime 配置のタイプ オンライン サービス URI https://<organization-name>.crm[x].dynamics.com
認証タイプ Office365 ユーザー名 パスワードまたは Azure Key Vault パスワード パスワード
Data Factory のテンプレートの実行を準備する
ここでは、パーティの配送先住所およびパーティの電子住所の Data Factory のテンプレートを実行する前に必要な設定について説明します。
当事者の郵便番号テンプレートを実行するために設定
Customer Engagement アプリにサインインして、設定>パーソナライズ設定 に移動します。 全般 タブで、 システム管理者アカウントのタイムゾーン構成を行います。 財務と運用アプリからの住所の「有効開始日」および「有効終了日」を更新するには、協定世界時 (UTC) である必要があります。
Data Factory の管理タブにあるグローバルパラメーターで、次のグローバルパラメーターを作成します。
番号 Name 種類 値 1 PostalAddressIdPrefix 文字列 このパラメーターは、新規に作成された配送先住所の宛先に、接頭辞としてシリアル番号を付加します。 サービス契約および顧客関与アプリケーションで、郵便番号と競合しない財務と運用アプリを指定します。 たとえば、ADF-PAD- を使用します。 完了したら、すべて発行するを選択します。
当事者電子住所テンプレートを実行するために設定
Data Factory の管理タブにあるグローバルパラメーターで、次のグローバルパラメーターを作成します。
番号 Name 種類 値 1 IsFOSource ブール このパラメーターは、競合が発生した場合に、どのプライマリ システムのアドレスを置き換えるかを決定します。 この値が " 場合、顧客財務と運用アプリアプリケーションの基本住所を置き換える必要があります。 この値がfalse 場合は契約アプリケーションの基本住所が、顧客契約の基本住所に置き財務と運用アプリ。 2 ElectronicAddressIdPrefix 文字列 このパラメーターは、新規に作成された電子住所の宛先に、接頭辞としてシリアル番号を付加します。 財務と運用アプリや Customer Engagement アプリの電子アドレスと競合しない文字列を入力してください。 たとえば、ADF-EAD- を使用します。 完了したら、すべて発行するを選択します。
テンプレートの実行
財務と運用アプリを使用する、次の 関係者、取引先企業、連絡先、仕入先 の二重書き込みマップを停止します。
- CDS 関係者 (msdyn_parties)
- 顧客 V3 (アカウント)
- 顧客 V3 (連絡先)
- CDS 連絡先 V2 (連絡先)
- CDS 連絡先 V2 (連絡先)
- 仕入先 V2 (msdyn_vendors)
- 連絡先 V2 (msdyn_contactforparties)
- CDS 当事者の住所場所 (msdyn_partypostaladdresses)
- CDS 住所履歴 V2 (msdyn_postaladdresses)
- CDS 住所場所 (msdyn_postaladdresscollections)
- 当事者連絡先 V3 (msdyn_partyelectronicaddresses)
Dataverse の msdy_dualwriteruntimeconfig テーブルからマッピングが削除されていることを確認してください。
AppSource から 二重書き込み当事者およびグローバル アドレス帳ソリューションをインストールします 。
次のテーブルにデータが含まれている場合は、財務と運用アプリで初期同期を実行します:
- あいさつ文
- 個人の特徴タイプ
- 結句
- 連絡担当者の肩書き
- 意思決定ロール
- ロイヤルティ レベル
Customer Engagement アプリで、次のプラグイン ステップを無効にします。
取引先企業の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromAccountEntity: 取引先企業の更新
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForCustomerTypeCodes: 取引先企業の更新
連絡先の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromContactEntity: 連絡先の更新
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForSellableContact: 連絡先の更新
msdyn_party の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromPartyEntity: msdyn_party の更新
msdyn_vendor の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromVendorEntity: msdyn_vendor の更新
Customeraddress
作成
- Microsoft.Dynamics.GABExtended.Plugins.CreatePartyAddress: customeraddress の作成
更新
- Microsoft.Dynamics.GABExtended.Plugins.CreatePartyAddress: customeraddress の更新
削除
- Microsoft.Dynamics.GABExtended.Plugins.DeleteCustomerAddress: customeraddress の削除
msdyn_partypostaladdress
作成
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: msdyn_partypostaladdress の作成
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: msdyn_partypostaladdress の作成
更新
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: msdyn_partypostaladdress の更新
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: msdyn_partypostaladdress の更新
msdyn_postaladdress
作成
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddress: msdyn_postaladdress の作成
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressPostCreate: msdyn_postaladdress の作成
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: msdyn_postaladdress の作成
更新
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressUpdate: msdyn_postaladdress の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: msdyn_postaladdress の更新
msdyn_partyelectronicaddress
作成
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: msdyn_partyelectronicaddress の作成
更新
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: msdyn_partyelectronicaddress の更新
削除
- Microsoft.Dynamics.GABExtended.Plugins.DeletePartyElectronicAddressSync: msdyn_partyelectronicaddress の削除
Customer Engagement アプリで、次のワークフローを無効にします:
- 取引先企業テーブルでの仕入先の作成
- 取引先企業テーブルでの仕入先の作成
- 連絡先テーブルでの個人タイプの仕入先の作成
- 仕入先テーブルでの個人タイプの仕入先の作成
- 取引先企業テーブルでの仕入先の更新
- 仕入先テーブルでの仕入先の更新
- 取引先担当者テーブルでの個人タイプの仕入先の更新
- 仕入先テーブルでの個人タイプの仕入先の更新
Data Factory で、次のイラストに示すように今すぐトリガーするを選択してテンプレートを実行します。 このプロセスは、データ量にもよりますが、完了までに数時間かかる場合があります。
メモ
取引先企業、連絡先、ベンダーをカスタマイズする場合は、テンプレートを変更する必要があります。
新しい関係者レコードを財務と運用アプリにインポートします。
- Azure Blob Storage から FONewParty.csv ファイルをダウンロードします。 このパスは、 partybootstrapping/output/FONewParty.csv です。
- FONewParty.csv ファイルを Excel ファイルに変換し、Excel ファイルを財務と運用アプリにインポートします。 または、CSV のインポートが機能する場合は、.csv ファイルを直接インポートできます。 この手順は、データ量にもよりますが、完了までに数時間かかる場合があります。 詳細については、データのインポート ジョブとエクスポート ジョブの概要を参照してください。
データ 工場で、当事者の郵便番号を実行し、次に当事者の電子住所を実行します。
- パーティの配送先住所テンプレートは、Customer Engagement アプリ内のすべての配送先住所レコードをアップサートし、対応する取引先企業、取引先担当者、ベンダーレコードと関連づけます。 3 種類の .csv が生成されます: ImportFONewPostalAddressLocation.csv、ImportFONewPartyPostalAddress.csv、ImportFONewPostalAddress.csv 。
- パーティの電子先住所テンプレートは、Customer Engagement アプリ内のすべての電子住所レコードをアップサートし、対応する取引先企業、取引先担当者、ベンダーレコードと関連づけます。 1 種類の .csv が生成されます: ImportFONewElectronicAddress.csv 。
このデータを使用して財務と運用アプリを更新するには、.csv ファイルを Excel ブックに変換し、財務と運用アプリにインポート します。 または、CSV のインポートが機能する場合は、.csv ファイルを直接インポートできます。 この手順は、データ量にもよりますが、完了までに数時間かかる場合があります。
Customer Engagement アプリで、次のプラグイン ステップを有効にします。
取引先企業の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromAccountEntity: 取引先企業の更新
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForCustomerTypeCodes: 取引先企業の更新
連絡先の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromContactEntity: 連絡先の更新
- Microsoft.Dynamics.FinanceExtended.Plugins.TriggerNotesForSellableContact: 連絡先の更新
msdyn_party の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromPartyEntity: msdyn_party の更新
msdyn_vendor の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdatePartyAttributesFromVendorEntity: msdyn_vendor の更新
msdyn_partypostaladdress
作成
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: msdyn_partypostaladdress の作成
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: msdyn_partypostaladdress の作成
更新
- Microsoft.Dynamics.GABExtended.Plugins.CreateCustomerAddress: msdyn_partypostaladdress の更新
- Microsoft.Dynamics.GABExtended.Plugins.PartyPostalAddress: msdyn_partypostaladdress の更新
msdyn_postaladdress
作成
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddress: msdyn_postaladdress の作成
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressPostCreate: msdyn_postaladdress の作成
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: msdyn_postaladdress の作成
更新
- Microsoft.Dynamics.GABExtended.Plugins.PostalAddressUpdate: msdyn_postaladdress の更新
- Microsoft.Dynamics.GABExtended.Plugins.UpdateCustomerAddress: msdyn_postaladdress の更新
msdyn_partyelectronicaddress
作成
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: msdyn_partyelectronicaddress の作成
更新
- Microsoft.Dynamics.GABExtended.Plugins.PartyElectronicAddressSync: msdyn_partyelectronicaddress の更新
削除
- Microsoft.Dynamics.GABExtended.Plugins.DeletePartyElectronicAddressSync: msdyn_partyelectronicaddress の削除
Customer Engagement アプリで、前述の手順で次のワークフローを無効化した場合は、有効にします:
- 取引先企業テーブルでの仕入先の作成
- 仕入先テーブルでの仕入先の作成
- 連絡先テーブルでの個人タイプの仕入先の作成
- 仕入先テーブルでの個人タイプの仕入先の作成
- 取引先企業テーブルでの仕入先の更新
- 仕入先テーブルでの仕入先の更新
- 取引先担当者テーブルでの個人タイプの仕入先の更新
- 仕入先テーブルでの個人タイプの仕入先の更新
パーティおよびグローバル アドレス帳の指示に従ってパーティ関連のマップを実行します。
Data Factory テンプレートの説明
ここでは、Data Factory の各テンプレートの手順を説明します。
パーティ テンプレートの手順
手順 1~6 では、デュアルライトが可能な企業を特定し、その企業のためのフィルター句を構築します。
手順 7-1 から 7-9 では、財務と運用アプリと Customer Engagement アプリの両方からデータを取得し、そのデータをアップグレード用にステージングします。
手順 8 から 9 では、財務と運用アプリと Customer Engagement アプリの間で、取引先企業、取引先担当者、仕入先レコードの関係者番号を比較します。 パーティ番号がないレコードはスキップされます。
手順 10 では、Customer Engagement アプリと財務と運用アプリで作成する必要がある関係者レコード用の 2 つの .csv ファイルを生成します。
- FOCDSParty.csv – このファイルには、企業がデュアルライトを有効にしているかどうかにかかわらず、両システムのすべてのパーティ レコードが含まれています。
- FONewParty.csv – このファイルには、Dataverse が認識しているパーティ レコードのサブセット (例えば、見込顧客 タイプのアカウント) が含まれています。
手順 11 では、Customer Engagement アプリにパーティを作成します。
手順 12 では、Customer Engagementアプリからパーティ のグローバルに一意な識別子 (GUID)を取得し、後続の手順で取引先企業、取引先担当者、 ベンダーのレコードに関連づけられるようにステージングします。
手順 13 では、取引先企業、取引先担当者、ベンダー の各レコードをパーティの GUID と関連付けます。
手順 14-1 から 14-3 では、Customer Engagement アプリの取引先企業、取引先担当者、ベンダーのレコードをパーティの GUID で更新します。
手順 15-1 から 手順 15-3 では、取引先企業, 取引先担当者、ベンダーのレコードに対するパーティーの連絡先 レコードを用意します。
手順 16-1 から 手順 16-7 では、敬称や個人の文字種などの参照データを取得し、パーティーの連絡先 レコードに関連付けることができます。
手順 17 では、取引先企業, 取引先担当者、ベンダーのレコードに対するパーティーの連絡先 レコードをマージします。
手順 18 では、パーティーの連絡先レコードを Customer Engagement アプリにインポートします。
パーティの配送先住所テンプレートの手順
手順 1-1 から 1-10 では、財務と運用アプリと Customer Engagement アプリの両方からデータを取得し、そのデータをアップグレード用にステージングします。
手順2つのファイルは、財務および操作アプリケーションの郵便番号データを、その郵便番号と当事者の郵便番号に結合して処理します。
手順契約アプリケーションから3つのdedup手順データを作成し、勘定、連絡先、および仕入先の住所データをマージします。
手順 4 では、財務と運用アプリで使用する .csv ファイルを作成し、取引先企業、取引先担当者、仕入先の住所に基づいた新しい住所データを作成します。
手順 5-1 では、財務と運用アプリと Customer Engagement アプリの両方に基づいて、Customer Engagement アプリで使用する .csv ファイルを作成し、すべての住所データを作成します。
手順 5-2では、.csvファイルを手動インポートで使用する財務と運用インポートのフォーマットに変換します。
- ImportFONewPostalAddressLocation.csv
- ImportFONewPartyPostalAddress.csv
- ImportFONewPostalAddress.csv
手順 6 では、配送先住所のコレクション データを Customer Engagement アプリにインポートします。
手順 7 では、パーティーの配送先住所のコレクション データを Customer Engagement アプリから取得します。
手順 8 では、顧客の住所データを作成し、配送先住所のコレクション ID を関連付けます。
手順 9-1 ~ 9-2 では、パーティーおよび配送先住所の収集 ID と配送先住所とパーティーの配送先住所を関連付けます。
手順 10-1 ~ 10-3 では、顧客の住所、配送先住所、パーティの配送先住所を Customer Engagement アプリにインポートします。
パーティの電子住所テンプレートの手順
手順 1-1 から 1-5 では、財務と運用アプリと Customer Engagement アプリの両方からデータを取得し、そのデータをアップグレード用にステージングします。
手順 2 では、Customer Engagement アプリ内の電子住所を、取引先企業、取引先担当者、ベンダーの各エンティティから統合します。
手順 3 では、Customer Engagement アプリと財務と運用アプリのプライマリ電子アドレス データをマージします。
手順 4 では .csv ファイルを作成します。
- 取引先企業、取引先担当者、仕入先の住所を基に、財務と運用アプリで使用する電子アドレス データを新規作成します。
- 財務および業務アプリケーションの電子住所、勘定、連絡先、仕入先住所に基づいて、顧客関与アプリケーションの新しい電子住所データを作成します。
手順 5-1 では、電子住所を Customer Engagement アプリにインポートします。
手順 5-2 では、Customer Engagement アプリの取引先企業、取引先担当者のプライマリ住所の更新に使用する .csv ファイルを作成します。
手順 6-1 ~ 6-2 では、取引先企業、取引先担当者のプライマリ住所を Customer Engagement アプリにインポートします。
トラブルシューティング
処理に失敗した場合は、データ ファクトリを再実行してください。 失敗した活動からスタートします。
データファクトリーで生成されたファイルは、データの検証に使用することができます。
データ ファクトリは、.csv ファイルをベースに動作します。 そのため、任意のフィールド値にカンマが含まれていると、結果に影響が出る場合があります。 フィールドの値からすべてのカンマを取り除く必要があります。
監視タブでは、すべての手順と処理済みデータに関する情報が提供されます。 特定の手順を選択してデバッグします。
テンプレートの詳細を確認する
テンプレートに関する詳細については、Azure Data Factory テンプレートの readme コメント で確認できます。