インポート用データ マップの作成

  • [アーティクル]

Microsoft Dataverse にデータをインポートするには、適切なデータ マップを指定する必要があります。

データ マップの例を、 Microsoft ダウンロード: DataImportMaps.zipからダウンロードできます。

データ マップを使って、ソース ファイルに含まれるデータを Dataverse のテーブルの列にマッピングします。 ソース ファイルのすべての列を適切な列にマッピングする必要があります。 マップされていない列のデータは、データ インポートの操作中にインポートされません。

データ マップは、データ マップ (ImportMap) テーブルで表現されます。 このテーブルの新しいレコードを作成することで、新しいマップを作成できます。 マッピングには、ImportMap.Name の列に含まれる固有の名前があります。 このデータマッピングの作成対象となるインポートソースの名前は、ImportMap.Source 列で指定できます。

列、リスト値、検索マッピング

ソースファイル内の列、リスト値、ルックアップ値を Dataverse カラムにマッピングするには、以下のマッピングを使用します :

列マッピング

ソース ファイルの列を Dataverse の列にマッピングします。 列のマッピングには、ColumnMapping テーブルを使用します。 ソースカラムとターゲット カラムの間には、1:1 (一対一) または1:N (一対多) の関係を使用できます。 たとえば、取引先企業の住所情報を、受注の請求先住所と送付先住所にマップできます。

リスト値マッピング

ソース ファイルのリスト値を OptionSetValue 型の Dataverse 列にマッピングします。 リストの値のマッピングには、リストの値のマッピング (PickListMapping) テーブルを使用します。

ソース ファイルの列で指定された値が OptionSetValue、Status、State、Boolean などのリスト値である場合は、列マッピングの他に、リスト値マッピングを指定する必要があります。 たとえば、ソース ファイルに含まれている "請求先" および "送付先" のリスト値を、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 リストの ImportProcessCode.Internal 値に設定します。 ProcessCode の値の一覧は、このテーブルの選択肢の値を参照してください。

    ソース データがノートを表している場合は、ノートのテキストを Annotation.NoteText 列にマッピングします。 Salesforce ファイルで作業している場合、これらのファイルは、通常、ディスクの一意の ID 番号の下に格納されます。 添付ファイルをインポートするには、ソース ファイルに含まれるファイル識別番号を Annotation.DocumentBody の列にマッピングする必要があります。 DocumentBody 列には、添付ファイルの内容が格納されます。

    インポートの非同期ジョブでは、ノートや添付ファイルを検出するために、ソースの列名が "true" と "false" に設定されているマッピングを確認します。 添付ファイルのマッピングが見つかった場合、ディスク上の指定されたファイルが検索され、ファイルの内容が添付ファイルとして Dataverse にアップロードされます。 ファイルが見つからない場合、エラーが返されます。

    ノート テーブルのマッピングを指定しない場合、インポート ジョブはノートの既定のマッピングを生成します。

注意

アップロードできる最大ファイル サイズは、Organization.MaxUploadFileSize プロパティによって決まります。 このプロパティは、Dataverse アプリケーションの システム設定 にある 電子メール タブで設定します。 この設定で電子メール メッセージ、メモ、および Web リソースに添付できるファイルのサイズを制限します。 既定の設定は 5 MB です。 ただし、添付ファイルのサイズが、HTTP 要求サイズの最大値 (既定では 16MB) を超えてはいけません。

データ マップのインポートとエクスポート

既存のデータ マップを XML ファイルにエクスポートし、XML のデータ マッピングを Dataverse にインポートできます。 データ マップを Dataverse からエクスポートするには、ExportMappingsImportMapRequest Class または ExportMappingsImportMap Action を使用して ExportMappingsImportMap メッセージを使用します。 XML データ マッピングをインポートして Dataverse でデータ マップを作成するには、ImportMappingsImportMapRequest Class または ImportMappingsImportMap Action を使用して ImportMappingsImportMap メッセージを使用します。

関連情報

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

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。