ImportConfig リファレンス

  • [アーティクル]

Package Deployer で使用される ImportConfig.xml ファイルには、インポートするソリューションとデータに関する情報が含まれています。 以下が例となります。

<?xml version="1.0" encoding="utf-16"?>
<configdatastorage 
   installsampledata="true"
   waitforsampledatatoinstall="true"
   agentdesktopzipfile=""
   agentdesktopexename=""
   crmmigdataimportfile="data_1033.zip">
   <solutions>
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionOne_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionTwo_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionThree_1_0_managed.zip" />
   </solutions>
   <filestoimport>
      <configimportfile filename="SampleOption.csv"
         filetype="CSV"
         associatedmap="SampleOption"
         importtoentity="sample_option"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="false" />
      <configimportfile filename="File.zip"
         filetype="ZIP"
         associatedmap="FileMapName"
         importtoentity="FileEntity"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="true" />
      <zipimportdetails>
         <zipimportdetail filename="subfile1.csv"
            filetype="csv"
            importtoentity="account" />
         <zipimportdetail filename="subfile2.csv"
            filetype="csv"
            importtoentity="contact" />
      </zipimportdetails>
   </filestoimport>
   <filesmapstoimport>
      <configimportmapfile filename="SampleOption.xml" />
   </filesmapstoimport>
   <cmtdatafiles>
      <cmtdatafile filename="data_1033.zip"
         lcid="1033"
         usermapfilename="UserMap.xml" />
      <cmtdatafile filename="data_1041.zip"
         lcid="1041"
         usermapfilename="" />
   </cmtdatafiles>
</configdatastorage>

次のセクションでは、このドキュメントの有効な XML 要素と属性について詳しく説明します。

configdatastorage 要素

configdatastorage は、ルート要素です。

configdatastorage 属性

これらの属性はすべてオプションです。

件名 プロパティ
installsampledata サンプル データをインストールするかどうか。 これは、他の方法を使用してインストールされたものと同じサンプル データです。
- サンプル データを追加または削除する
- コードを使ってサンプル データを追加および削除する
waitforsampledatatoinstall true が設定されており、installsampledata も true に設定されている場合、パッケージを展開する前に、サンプル データがインストールされるのを待ちます。 ここで true when installsampledata を false に設定しないでください。
agentdesktopzipfile 解凍する zip ファイルの名前。 ここで.zip ファイル名を指定する場合は、パッケージの展開プロセス中に、ファイルのコンテンツを解凍する場所を選択するように求める画面を追加します。

この属性は、Dynamics 365 用 Unified Service Desk のパッケージを作成するのによく使用されます。
agentdesktopexename 展開プロセスの最後に呼び出される zip ファイルまたは URL の .exe または .msi ファイルの名前。

この属性は、Dynamics 365 用 Unified Service Desk のパッケージを作成するのによく使用されます。
crmmigdataimportfile 構成移行ツールを使用してエクスポートされた、既定の構成データ ファイル (.zip) のファイル名。

configdatastorage 要素

有効な子要素は次のとおりです。

要素 説明
solutions インポートするソリューションを記述する 0 個以上の configsolutionfile 要素 が含まれます。
filestoimport 次を含む
- 1 つ以上の configimportfile 要素
- インポートする個々のファイルと zip ファイルを記述する 0 個以上の zipimportdetails 要素。
filesmapstoimport 1 つ以上の configimportmapfile 要素が含まれます。 この要素のマップ ファイルの順序は、インポートされた順序を示します。 インポート用のデータマップの作成についての詳細
cmtdatafiles インポートするローカライズ済みの構成データ ファイルを含む 1 つ以上の cmtdatafile要素が含まれます。

configsolutionfile 要素

configdatastorage.solutions 要素にインポートするソリューションについて説明します。

configsolutionfile 属性

件名 プロパティ
solutionpackagefilename 必須 ソリューションの .zip ファイル名を指定します。
overwriteunmanagedcustomizations オプション 環境にすでに存在するソリューションをインポートするときに、アンマネージド カスタマイズをすべて上書きするかをどうかを指定します。 この属性を指定しない場合、既存のソリューションのアンマネージド カスタマイズは対象の環境でメンテ七スされます。
publishworkflowsandactivateplugins オプション ワークフローを公開するか、ソリューションがインポートされた後にターゲット環境をアクティブ化するかどうかを指定します。この動作を指定しない場合、ワークフローは公開され、プラグインはアクティブ化されます。

configimportfile 要素

configdatastorage.filestoimport 要素にインポートするファイルについて説明します。

configimportfile 属性

件名 プロパティ
filename インポート データを格納しているファイルの名前。
filetype この値はcsv、xml、または zip に設定できます。 ファイルが.zip ファイルの場合、 zipimportdetails 要素は、.zip ファイル内の各ファイル用の zipimportdetail要素 と共にあります。
associatedmap このファイルで使用するDataverseインポート データ マップの名前。 空白の場合、Dataverse はこのファイルにシステムが決定したインポート データ マップ名を使用しようとします。
importtoentity プロセスの最後に呼び出すリンクを提供する zip ファイル内の exe ファイル、URL、または .msi ファイルの名前になります。
datadelimiter インポート ファイルで使用される、データ区切り文字の名前。 有効な値は、単一引用符または二重引用符です。
fielddelimiter インポート ファイルで使用される、フィールド区切り文字の名前。 有効な値は、comma または colon、または single quote です。
enableduplicatedetection データのインポート時に重複データ検出ルールを有効にするかどうかを示します。 有効な値は、true または false。
isfirstrowheader インポート ファイルの最初の行にフィールド名が含まれていることを示します。 有効な値は、true または false。
isrecordownerateam インポート時のレコードの所有者をチームにするかどうかを示します。 有効な値は、true または false。
owneruser レコードを所有するユーザー ID を示します。 既定値は、現在ログオンしているユーザーです。
waitforimporttocomplete true の場合、システムは続行する前にインポートの完了を待ちます。 false の場合、ジョブをキューして次に進みます。

zipimportdetails 要素

configimportfile.filetype 要素が zip の場合に、 configdatastorage.filestoimport 要素にインポートする zip ファイルについて説明します。

configimportfile要素 で指定されている、.zip ファイル内の個々のファイルに関する情報を提供する 1 つ以上の zipimportdetail要素 を含みます。

zipimportdetail 要素

configimportfile要素 で指定されている、.zip ファイル内の個々のファイルに関する情報を提供します。

zipimportdetail 属性

件名 プロパティ
filename インポート データを格納しているファイルの名前。
filetype この値は、csv または xml に設定できます。
importtoentity プロセスの最後に呼び出すリンクを提供する、.zip ファイル内の exe ファイル、URL、または .msi ファイルの名前になります。

configimportmapfile 要素

Dataverse にインポートする個々のマップファイルに関する情報が含まれています。

configimportmapfile 属性

件名 プロパティ
filename マッピング データを含むファイルの名前。

cmtdatafile 要素

ロケール ID (必須) およびユーザー情報マップ ファイル (オプション) と共にローカライズ済みの構成データ ファイルを指定します。

cmtdatafile の例

<cmtdatafiles>
   <cmtdatafile filename="data_1033.zip"
      lcid="1033"
      usermapfilename="UserMap.xml" />
   <cmtdatafile filename="data_1041.zip"
      lcid="1041"
      usermapfilename="" />
</cmtdatafiles>

cmtdatafile 属性

件名 プロパティ
filename マッピング データを含むファイルの名前。
lcid LCID 言語コード識別子の文字列表現。
usermapfilename Dynamics 365 (on-premises) のみ。 プロジェクト内の構成移行ツールを使用して生成されたユーザー マップ ファイル (.xml) が含まれます。 このファイルでは、ユーザー情報を別のドメイン上の Dynamics 365 (on-premises) インスタンスにインポートする必要があります。