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) インスタンスにインポートする必要があります。 |