構成データの管理
公開日: 2017年2月
対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
注意
Dynamics 365 のオンライン バージョンに適用されるこのトピックの内容は、Dynamics 365 (オンライン) バージョン 9.0 より前のバージョンを対象としています。 最新のドキュメントについては、「構成データを移動」を参照してください。
構成移行ツール を使用すると、構成データを Microsoft Dynamics 365 のインスタンスと組織の全体にわたって移動できます。 構成データは、Dynamics 365 のカスタム機能を定義するために使用され、通常、ユーザー定義エンティティに格納されます。 構成データは、エンド ユーザーのデータ (取引先企業や取引先担当者など) とは異なります。 構成データの典型的な例は、カスタマイズされたコール センター エージェントのアプリケーションを構成するために、Unified Service Desk for Microsoft Dynamics 365で定義するデータです。Unified Service Deskエンティティと、エンティティに格納されている構成データは、エージェント アプリケーションを定義します。Unified Service Desk の詳細については、Microsoft Dynamics 365 用 Unified Service Desk の管理者ガイドを参照してください。
重要
構成移行ツール は、主に実際の Dynamics 365 データではなく、構成データを移行するためのものです。詳細:構成移行のビデオ (2:13)
構成移行ツールでは、以下が可能です。
構成データをエクスポートするエンティティとフィールドを選択します。
エンティティ内のフィールドの組み合わせに基づき、各エンティティに一意性の条件を定義することによって、ターゲット システム上にレコードが重複しないようにします。これは、ターゲット システム上の値を比較するために使用されます。 一致する値がない場合は、ターゲット システムに一意なレコードが作成されます。 一致するレコードが見つかると、ターゲット システムでレコードが更新されます。
注意
エクスポートされるエンティティに対して重複データ検出 (一意) の条件を指定しない場合、ツールは、エンティティの主フィールド名を使用して、ターゲット システム上の既存のデータと比較します。
データをエクスポートする前にプラグインを無効にし、すべてのエンティティまたは選択したエンティティのインポートが完了した後に、ターゲット システムで再度有効にします。
すべての必要なデータや情報が存在しているかを確認するため、エクスポートする選択したエンティティのスキーマを検証します。
ソース システムからデータをエクスポートするには、既存のスキーマを再利用します。
このツール (スキーマとデータ ファイル) から作成しエクスポートしたモジュールを他のプログラムに埋め込みます。 たとえば、Microsoft Dynamics CRM Package Deployerでエクスポートしたデータとその他のソリューションのファイルやデータを使用して、Dynamics 365 インスタンスでパッケージを作成、展開できます。詳細:Dynamics CRM Package Deployer および Windows PowerShell を使用してパッケージを展開する
重要
構成移行ツールは、エンティティ内のレコードのフィルタ リングをサポートしていません。 既定では、選択したエンティティのすべてのレコードがエクスポートされます。
このトピックの内容
Configuration Migration ツールのしくみについて
ログ ファイルを使用して、構成データ移行に関する問題をトラブルシューティングします
このツールを使用して構成データを移行するためのベスト プラクティス
Configuration Migration ツールのしくみについて
次の図は、構成データの移行のために構成移行ツールを使用する方法を示します。
.jpeg "Configuration migration process flow diagram")
.jpeg "Step 1 symbol")
エクスポートするソース データのスキーマを定義する: スキーマ ファイル (.xml) には、エンティティ、属性、関連、データの一意性の定義、データのエクスポートの前にプラグインを無効にする必要があるかどうかなど、エクスポートするデータに関する情報が含まれています。詳細:構成データをエクスポートするスキーマの作成
.jpeg "Step 2 symbol")
スキーマを使ってデータをエクスポートする: スキーマ ファイルを使って、エクスポート データのデータとスキーマを格納する .zip ファイルにデータをエクスポートします。詳細:構成データをエクスポートするスキーマの作成
.jpeg "Step 3 symbol")
エクスポートしたデータをインポートする: エクスポートしたファイル (.zip ファイル) を使って、ターゲットDynamics 365インスタンスにインポートします。 データのインポートは複数のパスで実行され、最初に依存データのキュー中に基盤データをインポートし、続くパスで依存データをインポートし、データ依存またはリンクを処理します。 これにより、クリーンなデータがインポートされます。詳細:構成データのインポート
ログ ファイルを使用して、構成データ移行に関する問題をトラブルシューティングします
構成移行ツールは、ログ記録のサポートを提供しており、ツールを使用してDynamics 365インスタンスへのサインイン中に発生したエラーに関する詳細情報、スキーマの定義中および構成データのエクスポート/インポート中にツールによって実行されたアクティビティ、およびツールを使用してインポートされたデータについての情報を取得できます。 ツールによって生成される 3 つのログ ファイルがあります。これは、ツールを実行するコンピューターの次の場所にあります: c:\Users\<ユーザー名>\AppData\Roaming\Microsoft\DataMigrationUtility\<バージョン>。
Login_ErrorLog.log: ツールを使用して Dynamics 365 インスタンスにサインインするときに発生する問題に関する詳細を提供します。 サインイン時に問題がある場合は、ツールのログイン画面に、ログ ファイルへのリンクと共にメッセージが表示されます。 メッセージには、ログイン要求の処理中に発生したエラーが示され、ユーザーはエラー ログを表示できます。 メッセージ内のリンクをクリックすると、このログ ファイルを表示できます。 ログ ファイルは、最初にツールでサインインの問題が発生したときに作成されます。 その後、ログ ファイルは、サインインに関する問題が発生するときに、その情報を記録するために使用されます。
DataMigrationUtility.log: 最後の実行中に、ツールで実行された各タスクに関する詳細な情報を提供します。 ツールのログ ファイルを表示するには、メイン画面のログメニューをクリックし、実行しているログをクリックします。
ImportDataDetail.log: ツールを使用した最後のインポート ジョブでインポートされたデータに関する詳細情報を提供します。 このツールを使用してインポート ジョブを実行するたびに、ログ ファイルからの既存の詳細情報が、同じディレクトリにある ImportDataDetail._old.log という名前のファイルに移動されます。ImportDataDetail.log file ファイルには、ツールを使用して実行される最新のインポート ジョブの情報が表示されます。 ツールのログ ファイルを表示するには、メイン画面のログメニューをクリックし、最新のインポート ログをクリックします。
このツールを使用して構成データを移行するためのベスト プラクティス
このツールを使用して構成データを移行するときには、以下を考慮する必要があります。
エクスポート データ スキーマを作成するときには、ターゲット システムで意図しないデータ更新を避けるために、各エンティティに対し適切に一意性の規則を定義する必要があります。
運用前の環境 (可能であれば、運用環境のミラー イメージ) でエクスポートしたデータをインポートし、データ インポートの結果が意図したとおりであることを確認します。
データをインポートする前に、運用環境をバックアップします。
関連項目
構成データをエクスポートするスキーマの作成
構成データ スキーマの変更
構成データのインポート
別の Dynamics 365 サーバーへの Unified Service Desk 構成の移行
Dynamics 365 の管理
製品カタログの構成の管理
© 2017 Microsoft. All rights reserved. 著作権