サンプル: データ マップのエクスポートおよびインポート

このサンプルは、Microsoft Dataverse でインポート マップ (データ マップ) を作成し、それを XML 形式のデータとしてエクスポートしてから、変更したマッピングをインポートし、そのインポート済みのマッピングに基づいて新しい Dataverse 用インポート マップを作成する方法を示します。

このサンプルを実行する方法

1. サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
2. (オプション) Dataverse/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定する接続文字列を定義します。
3. サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。

Dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスについての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。

このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、Dataverse/App.config ファイルを参照するリンクが含まれます。

このサンプルの概要

プログラムの主な機能は設定中に実行されるため、設定セクションの説明テキストを参照してください。

このサンプルがどのように動作するか

このサンプルの概要で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:

セットアップ

1. 組織の現在のバージョンをチェックします。
2. CreateImportMapping メソッドは、インポート マッピング レコードを作成します。
3. RetrieveMappingXML メソッドは、作成されたマッピング (XML) をエクスポートします。
4. ChangeMappingName メソッドは、XML を解析して、名前の列を変更します。
5. ImportMappingsByXml メソッドは、XML (以前にエクスポートされた) からマッピングを作成します。

クリーンアップ

設定で作成されたサンプル データを削除するためのオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。

関連項目

データのインポート
ソース ファイルのインポートを準備する
インポート用データ マップの作成
インポート用の変換マッピングの追加
データ インポートの構成
データ インポートの実行
データ インポート テーブル
サンプル: 複雑なデータ マップを使用してデータをインポートする