Споделяне чрез

Справка за 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

Всички тези атрибути не са задължителни.

Име Описание
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), експортиран с помощта на Configuration Migration Tool.

Configdatastorage елементи

Това са валидните дъщерни елементи:

Елемент Описания
solutions Съдържа 0 или повече configsolutionfile елементи , които описват решения за импортиране.
filestoimport Съдържа
- 1 или много configimportfile елементи
- 0 или много zipimportdetails елементи , които описват отделни файлове и zip файлове за импортиране.
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 елемент с 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 атрибути

Име Описание
filename Име на файла, който съдържа импортираните данни.
filetype Тази стойност може да бъде csv или xml.
importtoentity Може да е името на exe в zip файла или URL адрес, или .msi файл за предоставяне на връзка за извикване в края на процеса.

configimportmapfile елемент

Съдържа информация за отделен файл на карта за импортиране Dataverse.

Атрибути на ConfigImportMapFile

Име Описание
filename Името на файла, съдържащ данните за съпоставяне.

cmtdatafile елемент

Указва локализираните файлове с конфигурационни данни заедно с ИД на езикова променлива (задължително) и файл с потребителска информация за картата (по избор).

Пример за 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) екземпляр в друг домейн.