Referenční informace o souboru ImportConfig

Soubor ImportConfig.xml používaný s nástrojem Package Deployer obsahuje informace o řešeních a datech k importu. Zde je příklad:

<?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>

Následující části poskytují podrobnosti o platných prvcích a atributech XML pro tento dokument.

configdatastorage živel

configdatastorage je kořenový prvek.

Atributy configdatastorage

Všechny tyto atributy jsou volitelné.

Name	Description
installsampledata	Zda chcete instalovat ukázková data. Toto jsou stejná ukázková data nainstalovaná pomocí těchto dalších metod: - Přidejte nebo odeberte ukázková data - Přidejte a odeberte ukázková data pomocí kódu
waitforsampledatatoinstall	Je-li true, a pokud installsampledata je také true, před nasazením balíčku čeká na instalaci ukázkových dat. Atribut nenastavujte na true, když installsampledata je false.
agentdesktopzipfile	Název souboru .zip, který chcete rozbalit. Pokud zde zadáte název souboru .zip, přidá se během procesu nasazení balíčku obrazovka, která vás vyzve k výběru umístění, kam chcete rozbalit obsah souboru. Tento atribut se běžně používá při vytváření balíčků pro Unified Service Desk pro Dynamics 365.
agentdesktopexename	Název souboru .exe nebo .msi v souboru .zip nebo adresa URL, která má být vyvolána na konci procesu nasazení. Tento atribut se běžně používá při vytváření balíčků pro Unified Service Desk pro Dynamics 365.
crmmigdataimportfile	Název souboru výchozího konfiguračního datového souboru (.zip) exportovaného pomocí nástroje Configuration Migration Tool.

Prvky configdatastorage

Toto jsou platné podřízené prvky:

Element (Prvek)	Popisy
solutions	Obsahuje 0 nebo více prvků configsolutionfile, které popisují řešení pro import.
filestoimport	Obsahuje - 1 nebo více prvků configimportfile - 0 nebo více prvků zipimportdetails, které popisují jednotlivé soubory a soubory zip, které mají být importovány.
filesmapstoimport	Obsahuje 1 nebo více prvků configimportmapfile. Pořadí souborů mapování v tomto prvku označuje pořadí, v jakém jsou importovány. Přečtěte si další informace o vytváření datových map pro import
cmtdatafiles	Obsahuje 1 nebo více prvků cmtdatafile, které obsahují lokalizovanou verzi souboru konfiguračních dat, který má být importován.

configsolutionfile živel

Popisuje řešení k importu v prvku configdatastorage.solutions.

Atributy configsolutionfile

Name	Description
solutionpackagefilename	Požadovaný Zadejte název souboru .zip vašeho řešení.
overwriteunmanagedcustomizations	Volitelný Zda se mají přepsat všechna nespravovaná přizpůsobení při importu řešení, které již v cílovém prostředí existuje. Pokud toto chování neurčíte, nespravovaná vlastní nastavení ve stávajícím řešení budou zachována v cílovém prostředí.
publishworkflowsandactivateplugins	Volitelný Zda publikovat pracovní postupy a aktivovat zásuvné moduly v cílovém prostředí po importu řešení. Pokud toto chování neurčíte, pracovní postup se publikuje a zásuvné moduly se aktivují.

configimportfile živel

Popisuje soubory k importu v prvku configdatastorage.filestoimport.

Atributy configimportfile

Name	Description
filename	Název souboru obsahujícího data importu.
filetype	Tato hodnota může být csv, xml nebo zip. Pokud je soubor typu .zip, prvek zipimportdetails musí být dostupný s prvkem zipimportdetail pro každý soubor v souboru .zip.
associatedmap	Název mapování dat importu Dataverse, který se použije pro tento soubor. Pokud je prázdný, pro tento soubor se Dataverse pokusí použít název mapování dat importu určený systémem.
importtoentity	Může být název souboru exe v souboru .zip, adresa URL nebo soubor .msi pro poskytnutí odkazu pro vyvolání na konci procesu.
datadelimiter	Název oddělovače dat použitý v souboru importu. Platné hodnoty jsou jednoduché nebo dvojité uvozovky.
fielddelimiter	Název oddělovače polí použitý v souboru importu. Platné hodnoty jsou čárka nebo dvojtečka nebo jednoduchá uvozovka.
enableduplicatedetection	Zda povolit pravidla vyhledávání duplicit během importu dat. Platné hodnoty jsou true nebo false.
isfirstrowheader	Zda první řádek importovaného souboru obsahuje názvy polí. Platné hodnoty jsou true nebo false.
isrecordownerateam	Zda vlastník záznamu určeného k importu má být tým. Platné hodnoty jsou true nebo false.
owneruser	ID uživatele, který by měl tyto záznamy vlastnit. Výchozí hodnota je aktuálně přihlášený uživatel.
waitforimporttocomplete	Je-li true, systém před pokračováním čeká na dokončení importu. Je-li false, úlohy jsou zařazeny do fronty a pokračuje se.

zipimportdetails živel

Popisuje soubory zip k importu v prvku configdatastorage.filestoimport, když configimportfile.filetype je zip.

Obsahuje 1 nebo více prvků zipimportdetail, které poskytují informace o samostatném souboru v souboru zip zadaném v prvku configimportfile.

zipimportdetail živel

Poskytuje informace o samostatném souboru v souboru zip zadaném v prvku configimportfile.

Atributy zipimportdetail

Name	Description
filename	Název souboru obsahujícího data importu.
filetype	Tato hodnota může být csv nebo xml.
importtoentity	Může být název souboru exe v souboru .zip, adresa URL nebo soubor .msi pro poskytnutí odkazu pro vyvolání na konci procesu.

configimportmapfile živel

Obsahuje informace o samostatném souboru mapování k importu v Dataverse.

Atributy configimportmapfile

Name	Description
filename	Název souboru obsahujícího data mapování.

cmtdatafile živel

Udává lokalizované konfigurační datové soubory spolu s ID národního prostředí (povinné) a souborem informací o uživateli (volitelné).

Příklad cmtdatafile

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

Atributy cmtdatafile

Name	Description
filename	Název souboru obsahujícího data mapování.
lcid	Řetězcové vyjádření identifikátoru kódu jazyka LCID.
usermapfilename	Pouze pro Dynamics 365 (on-premises). Obsahuje uživatelský soubor mapování (.xml) vygenerovaný pomocí nástroje Configuration Migration Tool ve vašem projektu. Tento soubor je vyžadován k importu uživatelských informací do instance Dynamics 365 (on-premises) v jiné doméně.