サンプル: データ マップのエクスポートおよびインポート
このサンプルは、Microsoft Dataverse でインポート マップ (データ マップ) を作成し、それを XML 形式のデータとしてエクスポートしてから、変更したマッピングをインポートし、そのインポート済みのマッピングに基づいて新しい Dataverse 用インポート マップを作成する方法を示します。
このサンプルを実行する方法
- サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
- (オプション) Dataverse/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定する接続文字列を定義します。
- サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。
Dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスについての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、Dataverse/App.config ファイルを参照するリンクが含まれます。
このサンプルの概要
プログラムの主な機能は設定中に実行されるため、設定セクションの説明テキストを参照してください。
このサンプルがどのように動作するか
このサンプルの概要で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:
セットアップ
- 組織の現在のバージョンをチェックします。
-
CreateImportMapping
メソッドは、インポート マッピング レコードを作成します。 -
RetrieveMappingXML
メソッドは、作成されたマッピング (XML) をエクスポートします。 -
ChangeMappingName
メソッドは、XML を解析して、名前の列を変更します。 -
ImportMappingsByXml
メソッドは、XML (以前にエクスポートされた) からマッピングを作成します。
クリーンアップ
設定で作成されたサンプル データを削除するためのオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。
関連項目
データのインポート
ソース ファイルのインポートを準備する
インポート用データ マップの作成
インポート用の変換マッピングの追加
データ インポートの構成
データ インポートの実行
データ インポート テーブル
サンプル: 複雑なデータ マップを使用してデータをインポートする