Справочник по 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) в другом домене.