Справочник по ImportConfig
Файл ImportConfig.xml, используемый с Package Deployer, содержит информацию о решениях и данных для импорта. Ниже приведен пример:
<?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
Все эти атрибуты являются необязательными.
Полное имя | Description |
---|---|
installsampledata |
Требуется ли установка демонстрационных данных. Это тот же образец демонстрационных данных, установленный с использованием других методов: - Добавить или удалить образцы данных - Добавлять и удалять образцы данных с помощью кода |
waitforsampledatatoinstall |
Если true , и если параметр installsampledata также имеет значение true , ждет установки демонстрационных данных перед развертыванием пакета. Не устанавливайте для этого параметра значение true , когда installsampledata равно false . |
agentdesktopzipfile |
Имя ZIP-файла для распаковки. Если вы укажете здесь имя файла .zip, будет добавлен экран во время процесса развертывания пакета, который предложит вам выбрать место, куда вы хотите распаковать содержимое файла. Этот атрибут обычно используется для создания пакетов для Unified Service Desk для Dynamics 365. |
agentdesktopexename |
Имя файла .exe или .msi в ZIP-файле или URL-адрес, который будет вызван в конце процесса развертывания. Этот атрибут обычно используется для создания пакетов для Unified Service Desk для Dynamics 365. |
crmmigdataimportfile |
Имя файла данных конфигурации по умолчанию (.zip), экспортированного с помощью средства миграции конфигурации. |
Элементы configdatastorage
Это допустимые дочерние элементы:
Элемент | Descriptions |
---|---|
solutions |
Содержит 0 или несколько элементов configsolutionfile , описывающих решения для импорта. |
filestoimport |
содержит - 1 или много элементов configimportfile - 0 или много элементов zipimportdetails , описывающих отдельные файлы и ZIP-файлы, подлежащие импорту. |
filesmapstoimport |
Содержит 1 или много элементов configimportmapfile . Порядок файлов сопоставления в этом элементе указывает порядок, в котором они импортируются. Узнайте больше о создании карт данных для импорта |
cmtdatafiles |
Содержит 1 или много элементов cmtdatafile , которые содержат локализованную версию файла данных конфигурации для импорта. |
configsolutionfile
элемент
Описывает решения для импорта в элемент configdatastorage.solutions
.
Атрибуты configsolutionfile
Полное имя | Description |
---|---|
solutionpackagefilename |
Необходимый Укажите имя .zip-файла вашего решения. |
overwriteunmanagedcustomizations |
Необязательный Следует ли перезаписывать неуправляемые настройки при импорте решения, которое уже существует в целевой среде. Если вы не укажете это поведение, неуправляемые настройки существующего решения будут сохранены в целевой среде. |
publishworkflowsandactivateplugins |
Необязательный Следует ли публиковать рабочие процессы и активировать подключаемые модули в целевой среде после импорта решения. Если вы не укажете это поведение, рабочие процессы будут опубликованы, а подключаемые модули активированы. |
configimportfile
элемент
Описывает файлы для импорта в элемент configdatastorage.filestoimport
.
Атрибуты configimportfile
Полное имя | Description |
---|---|
filename |
Имя файла, который содержит данные импорта. |
filetype |
Это значение может быть csv , xml или zip . Если файл является ZIP-файлом, элемент zipimportdetails должен присутствовать с элементом zipimportdetail для каждого файла в ZIP-файле. |
associatedmap |
Имя сопоставления данных импорта Dataverse для использования с этим файлом. Если значение не задано, Dataverse пытается использовать определенное системой имя сопоставления данных импорта для этого файла. |
importtoentity |
Может быть именем файла EXE в ZIP-файле, URL-адресом или файлом .msi для предоставления ссылки для вызова в конце процесса. |
datadelimiter |
Имя разделителя данных, используемого в файле импорта. Допустимые значения: одинарная кавычка или двойные кавычки. |
fielddelimiter |
Имя разделителя полей, используемого в файле импорта. Допустимые значения: запятая, двоеточие или одинарная кавычка. |
enableduplicatedetection |
Указывает, требуется ли включить правила обнаружения повторяющихся записей при импорте данных. Допустимые значения — true или false . |
isfirstrowheader |
Используется для обозначения того, что первая строка файла импорта содержит имена полей. Допустимые значения — true или false . |
isrecordownerateam |
Указывает, должен ли владелец записи при импорте быть рабочей группой. Допустимые значения — true или false . |
owneruser |
Указывает идентификатор пользователя, которому должны принадлежать записи. Значением по умолчанию является текущий вошедший пользователь. |
waitforimporttocomplete |
Если true , система ожидает завершения импорта, прежде чем продолжить. Если false , она ставит задания в очередь и движется дальше. |
zipimportdetails
элемент
Описывает ZIP-файлы для импорта в элементе configdatastorage.filestoimport
, когда configimportfile.filetype
имеет значение zip
.
Содержит 1 или много элементов zipimportdetail
, предоставляющих информацию об отдельном файле в ZIP-файле, указанном в элементе configimportfile
.
zipimportdetail
элемент
Предоставляет информацию об отдельном файле в ZIP-файле, указанном в элементе configimportfile
.
Атрибуты zipimportdetail
Полное имя | Description |
---|---|
filename |
Имя файла, который содержит данные импорта. |
filetype |
Это значение может быть csv или xml . |
importtoentity |
Может быть именем файла EXE в ZIP-файле, URL-адресом или файлом .msi для предоставления ссылки для вызова в конце процесса. |
configimportmapfile
элемент
Содержит информацию об отдельном файле сопоставления для импорта в Dataverse.
Атрибуты configimportmapfile
Полное имя | Description |
---|---|
filename |
Имя файла, который содержит данные сопоставления. |
cmtdatafile
элемент
Указывает локализованные файлы данных конфигурации вместе с кодом языка (обязательно) и файлом сопоставления информации о пользователе (необязательно).
Пример cmtdatafile
<cmtdatafiles>
<cmtdatafile filename="data_1033.zip"
lcid="1033"
usermapfilename="UserMap.xml" />
<cmtdatafile filename="data_1041.zip"
lcid="1041"
usermapfilename="" />
</cmtdatafiles>
Атрибуты cmtdatafile
Полное имя | Description |
---|---|
filename |
Имя файла, который содержит данные сопоставления. |
lcid |
Строковое представление кода языка (LCID). |
usermapfilename |
Только для Dynamics 365 (on-premises). Содержит файл сопоставления пользователя (.xml), созданный с помощью инструмента Configuration Migration Tool в вашем проекте. Этот файл необходим для импорта информации о пользователе в экземпляр Dynamics 365 (on-premises) в другом домене. |