ImportConfig-referens

Filen ImportConfig.xml med Package Deployer innehåller information om lösningarna och data som ska importeras. Följande utgör ett exempel:

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

I följande avsnitt finns information om giltiga XML-element och attribut för det här dokumentet.

configdatastorage element

configdatastorage är rotelementet.

configdatastorage-attribut

Alla de här attributen är valfria.

Namn	Beskrivning
installsampledata	Om du ska installera exempeldata eller inte. Detta är samma exempeldata som installeras med dessa andra metoder: - Lägga till eller ta bort exempeldata - Lägga till och ta bort exempeldata med kod
waitforsampledatatoinstall	Om true och installsampledata också är inställt på true, väntar på att exempeldata ska installeras innan paketet distribueras. Ställ inte in det här på true när installsampledata är false.
agentdesktopzipfile	Filnamn för den zip-fil som ska packas upp. Om du anger namnet på en zip-fil hör läggs en bild till under paketdistributionsprocessen där du uppmanas att välja en plats där du vill packa upp innehållet i filen. Detta attribut används vanligtvis för att skapa paket för Unified Service Desk för Dynamics 365.
agentdesktopexename	Namnet på exe- eller msi-filen i zip-filen eller en URL som ska anropas efter distributionsprocessens slut. Detta attribut används vanligtvis för att skapa paket för Unified Service Desk för Dynamics 365.
crmmigdataimportfile	Filnamn för den datafil för standardkonfiguration (.zip) som har exporterats med Configuration Migration Tool.

configdatastorage-element

Det här är de giltiga underordnade elementen:

Element	Beskrivningar
solutions	Innehåller 0 eller många configsolutionfile element som beskriver lösningar som ska importeras.
filestoimport	innehåller - 1 eller många configimportfile element - 0 eller många zipimportdetails element som beskriver enskilda filer och zip-filer som ska importeras.
filesmapstoimport	Innehåller 1 eller många configimportmapfile element. Ordningen på mappfilerna i den här element visar i vilken ordning de importeras. Läs mer om hur du skapar datamappningar för import
cmtdatafiles	Innehåller 1 eller många cmtdatafile element som innehåller en lokaliserad version av konfigurationsdatafilen som ska importeras.

configsolutionfile element

Beskriver lösningar som ska importeras i configdatastorage.solutions elementet.

configsolutionfile-attribut

Namn	Beskrivning
solutionpackagefilename	Obligatoriskt : Ange det .zip filnamnet för din lösning.
overwriteunmanagedcustomizations	Valfritt : Om du vill skriva över eventuella ohanterade anpassningar när du importerar en lösning som redan finns i målmiljön. Om du inte anger detta beteende bevaras de ohanterade anpassningarna i den befintliga lösningen i målmiljön.
publishworkflowsandactivateplugins	Valfritt : Om du vill publicera arbetsflöden och aktivera plugin-program i målmiljön efter att lösningen har importerats. Om du inte anger det här beteendet publiceras arbetsflödet och plugin-program aktiveras.

configimportfile element

Beskriver filer som ska importeras i configdatastorage.filestoimport elementet.

configimportfile-attribut

Namn	Beskrivning
filename	Namn på den fil som innehåller importdata.
filetype	Detta värde kan vara csv, xml, eller zip. Om filen är en zip-fil måste ett zipimportdetails element vara närvarande med ett zipimportdetail element för varje fil i .zip-filen.
associatedmap	Namn på den Dataverse-importdatamappning som ska användas med den här filen. Om det är tomt gör Dataverse försök att använda det systemdefinierade namnet för importdatamappning för filen.
importtoentity	Detta kan bestå av namnet på exe-filen i zip-filen, en URL eller en msi-fil som ska tillhandahålla en länk att anropa efter processens slut.
datadelimiter	Namnet på den dataavgränsare som används i importfilen. Giltiga värden är enkla eller dubbla citattecken.
fielddelimiter	Namnet på den fältavgränsare som används i importfilen. Giltiga värden är komma, kolon eller enkelt citattecken.
enableduplicatedetection	Om regler för dubblettidentifiering ska aktiveras vid dataimport. Giltig värden är true och false.
isfirstrowheader	Om den första raden i importfilen innehåller fältnamnen. Giltig värden är true och false.
isrecordownerateam	Om ägaren till posten som ska importeras ska vara ett team. Giltig värden är true och false.
owneruser	Användar-ID som posterna ska äga. Standardvärdet är den användare som för närvarande är inloggad.
waitforimporttocomplete	Om truesystemet väntar på att importen ska slutföras innan du fortsätter. Om false det köar jobben och fortsätter.

zipimportdetails element

Beskriver zip-filer som ska importeras i configdatastorage.filestoimport elementet när det configimportfile.filetype är zip.

Innehåller 1 eller fler zipimportdetail element som tillhandahåller information om en enskild fil i en zip-fil som anges i configimportfile element.

zipimportdetail element

Tillhandahåller information om en enskild fil i en zip-fil som anges i configimportfile element.

zipimportdetail-attribut

Namn	Beskrivning
filename	Namn på den fil som innehåller importdata.
filetype	Detta värde kan vara csv eller xml.
importtoentity	Detta kan bestå av namnet på exe-filen i zip-filen, en url eller en msi-fil som ska tillhandahålla en länk att anropa efter processens slut.

configimportmapfile element

Innehåller information om en enskild mappningsfil som ska importeras i Dataverse.

configimportmapfile-attribut

Namn	Beskrivning
filename	Namnet på filen som innehåller mappningsdata.

cmtdatafile element

Anger lokaliserade konfigurationsdatafiler tillsammans med språk-ID (obligatoriskt) och mappningsfilen för användarinformation (valfritt).

Exempel på cmtdatafile

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

Attribut för cmtdatafile

Namn	Beskrivning
filename	Namnet på filen som innehåller mappningsdata.
lcid	Strängrepresentationen av LCI (Language Code Identifier).
usermapfilename	Endast för Dynamics 365 (on-premises). Innehåller användarmappningsfilen (.xml) som genererats med Configuration Migration Tool i projektet. Den här filen krävs för att importera användarinformation till en Dynamics 365 (on-premises)-instans i en annan domän.