サンプル: 複雑なデータ マップを使用してデータをインポートする
このサンプルは、データ インポートによって、新しいレコードを作成する方法を示します。 このサンプルは、複雑なデータ マップを使用します。 サンプルは ここ からダウンロードできます。
Note
このサンプルのソース データは、ImportComplexDataMap\import accounts.csv ファイルに含まれています。
Note
このサンプルは、Dynamics 365 Customer Engagement (on-premises) と Dataverse の両方に適用されます。
このサンプルを実行する方法
すべてのサンプルのローカル コピーを取得してビルドするには、次の手順を実行します。
- サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
- (オプション) dataverse/App.config ファイルを編集して、接続先のインスタンスまたは組織を指定した接続文字列を定義します。
- サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。
dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先のインスタンスまたは組織についての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
このサンプルの動作方法
上述のシナリオをシミュレートするために、サンプルは次のことを行います:
セットアップ
- 組織の現在のバージョンをチェックします。
ImportMapメソッドは、インポート マップを作成します。ColumnMappingメソッドは、textタイプのフィールドに列マッピングを作成します。EntityReferenceメソッドは、列マッピングとデータ マップを関連付けます。LookUpMappingメソッドは、取引先企業の親会社に検索のマッピングを作成します。ImportFileメソッドは、インポート ファイルを作成します。GetHeaderColumnsImportFileRequestメソッドは、インポート ファイルで使用されている見出し列を取得します。ParseImportRequestメソッドは、インポート ファイルを解析します。RetrievedParsedDataImportFileRequestメソッドは、解析テーブルからデータを取得します。TransformImportRequestメソッドは、インポートを変換します。
クリーン アップ
セットアップ で作成されたレコードを削除するオプションを表示します。 サンプルで作成されるエンティティおよびデータを検証する場合、削除は任意です。 手動でレコードを削除することで同じ結果を得られます。