Microsoft Dataverse にデータをインポートするには、適切なデータ マップを指定する必要があります。
Microsoft ダウンロード: DataImportMaps.zipからデータ マップの例 をダウンロード できます。
データ マップを使用して、ソース ファイルに含まれるデータを Dataverse テーブル列にマップします。 ソース ファイルのすべての列を適切な列にマップする必要があります。 マップされていない列のデータは、データインポート操作中にインポートされません。
データ マップは、 データ マップ (ImportMap) テーブルによって表されます。 このテーブルの新しいレコードを作成することで、新しいマップを作成できます。 マップには、 ImportMap.Name 列に含まれる一意の名前があります。
ImportMap.Source列を使用して、このデータ マップを作成するインポート ソースの名前を指定できます。
列、リスト値、および参照マッピング
ソース ファイル内の列、リスト値、または参照値を Dataverse 列にマップするには、次のマッピングを使用します。
列マッピング
ソース ファイル内の列を Dataverse 列にマップします。 列マッピングの場合は、 ColumnMapping テーブルを使用します。 ソース列とターゲット列の間には、1 対 1 (1 対 1) または 1:N (一対多) のリレーションシップを使用できます。 たとえば、注文の請求先住所と配送先住所にアカウント アドレス情報をマップできます。
リスト値マッピング
ソース ファイル内のリスト値を、 OptionSetValue 型の Dataverse 列にマップします。 リスト値マッピングの場合は、 リスト値マッピング (PickListMapping) テーブルを使用します。
ソース ファイルの列に指定された値が、OptionSetValue、Status、State、Boolean などのリスト値である場合は、列マッピングに追加でリスト値マッピングを指定する必要があります。 たとえば、ソース ファイルの "bill" と "ship" リストの値を、 OptionSetValue の種類の請求書と出荷の値にマップします。
ルックアップ マッピング
ソース ファイル内の参照値を、 EntityReference 型の Dataverse 列にマップします。 ルックアップ マッピングの場合は、 LookUpMapping テーブルを使用します。
ソース ファイルで指定された値がテーブルを参照する場合は、この値の参照マッピングを指定する必要があります。
LookupMapping.LookupSourceCode列を使用して、ソース ファイル内または Dataverse 内の参照先テーブルを検索するかどうかを指定します。 事前バインド型を使用している場合は、 LookupSourceType 列挙を使用して参照値を設定できます。 ソース ファイル内で検索するには、 LookupSourceType.Source 値を使用します。 Dataverse 内で検索するには、 LookupSourceType.System 値を使用します。 LookupSourceCode の値の一覧については、この表の選択肢の値を参照してください。 組織のメタデータを表示するには、 環境内のテーブル定義の参照に関するページで説明されているメタデータ ブラウザー ソリューションをインストールします。
テーブル リファレンスでテーブルのリファレンス ドキュメントを閲覧することもできます。 複数の参照マッピングを指定できます。 非同期変換ジョブは、使用可能なすべてのマッピングを処理します。 参照されているレコードを検索し、レコードの一意識別子を使用して解析テーブルを更新します。 詳細については、「 データインポートの実行」を参照してください。
所有者マッピング
所有者マッピングを使用して、ソース ファイルで指定されたユーザーを Dataverse のユーザーにマップします。 ログ情報には、Dataverse ユーザーログオン名を使用します。 所有者マッピングの場合は、 OwnerMapping テーブルを使用します。
メモと添付ファイル
ノートと添付ファイルのマッピングは、他のテーブルとは異なる方法で処理されます。 メモと添付ファイルは、Dataverse のレコードに追加情報を追加するために使用されます。 メモはテキストとして保存され、添付ファイルは Dataverse データベースにファイルとして格納されます。
Dataverse でメモを作成するには、注釈 (メモ) テーブルの Annotation.IsDocument 列を falseに設定します。 添付ファイルを作成するには、 IsDocument を true に設定します。
メモと添付ファイルのマッピングには、次の設定を使用します。
ColumnMapping.SourceAttributeName列を "true" または "false" に設定します。 "true" 値は添付ファイルを示します。 "false" 値はメモを示します。ColumnMapping.TargetAttributeName列をIsDocumentに設定します。事前バインド型を使用している場合は、
ColumnMapping.ProcessCode列をImportProcessCode.Internal列挙型のImportProcessCode値に設定します。 ProcessCode 値の一覧については、この表の選択肢の値を参照してください。ソース データがノートを表す場合は、ノートのテキストを
Annotation.NoteText列にマップします。 Salesforce ファイルを使用している場合、通常は一意の ID 番号でディスクに格納されます。 添付ファイルをインポートするには、ソース ファイルに含まれるファイル識別番号をAnnotation.DocumentBody列にマップする必要があります。DocumentBody列には、添付ファイルの内容が格納されます。インポート非同期ジョブは、ソース列名が "
true" と "false" に設定されているマッピングをチェックして、メモと添付ファイルを検出します。 添付ファイルマッピングが見つかると、ディスク上の指定されたファイルが検索され、ファイルの内容が添付ファイルとして Dataverse にアップロードされます。 ファイルが見つからない場合は、エラーが返されます。注釈 (メモ) テーブルのマッピングを指定しない場合、インポート ジョブによってメモの既定のマッピングが生成されます。
注
アップロードできる最大ファイル サイズは、Organization.MaxUploadFileSize プロパティによって決まります。 このプロパティは、Dataverse アプリケーションの [システム設定] の [電子メール] タブで設定されます。 この設定で電子メール メッセージ、メモ、および Web リソースに添付できるファイルのサイズを制限します。 既定の設定は 5 MB です。 ただし、添付ファイルのサイズが最大 HTTP 要求サイズ (既定値は 16 MB) を超えることはできません。
データ マップのインポートとエクスポート
既存のデータ マップを XML ファイルにエクスポートし、XML データ マッピングを Dataverse にインポートできます。 Dataverse からデータ マップをエクスポートするには、ExportMappingsImportMapまたは ExportMappingsImportMap アクションを使用して、 メッセージを使用します。 XML データ マッピングをインポートし、Dataverse でデータ マップを作成するには、ImportMappingsImportMapまたは ImportMappingsImportMap アクションを使用して、 メッセージを使用します。
こちらもご覧ください
データのインポート
インポート用のソース ファイルを準備する
インポート用の変換マッピングを追加する
データのインポートを構成する
データのインポートを実行する
データ インポート テーブル
サンプル: データ マップのエクスポートとインポート
サンプル: 複雑なデータ マップを使用してデータをインポートする