Del via

ImportConfig-reference

  • Artikel

Den ImportConfig.xml-fil, der bruges sammen med package deployer, indeholder oplysninger om de løsninger og data, der skal importeres. Følgende er et eksempel:

<?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ølgende afsnit finder du oplysninger om de gyldige XML-elementer og -attributter for dette dokument.

configdatastorage element

configdatastorage er grundelementet.

Attributter i configdatastorage

Alle disse attributter er valgfrie.

Name Description
installsampledata Således installeres eksempeldata. Det er de samme eksempeldata, der installeres ved hjælp af disse andre metoder:
- Tilføje eller fjerne eksempeldata
- Tilføj og fjern eksempeldata med kode
waitforsampledatatoinstall Hvis true, og hvis installsampledata også er indstillet til true, skal du vente på, at eksempeldataene installeres, før du installerer pakken. Angiv ikke denne til true hvornår installsampledata er false.
agentdesktopzipfile Filnavnet på zip-fil til at pakke ud. Hvis du angiver et .zip-filnavn her, tilføjes en skærm under pakkeinstallationsprocessen, der beder dig om at vælge en placering, hvor du vil udpakke indholdet af filen.

Denne attribut bruges normalt til at oprette pakker til Unified Service Desk for Dynamics 365.
agentdesktopexename Navnet på .exe- eller .msi-filen i zip-filen eller en URL-adresse, der skal aktiveres i slutningen af installationen.

Denne attribut bruges normalt til at oprette pakker til Unified Service Desk for Dynamics 365.
crmmigdataimportfile Filnavnet på standardkonfigurationsdatafilen (.zip), der eksporteres ved hjælp af Configuration Migration tool.

Elementer i configdatastorage

Disse er gyldige underordnede elementer:

Element Beskrivelser
solutions Indeholder 0 eller mange configsolutionfile-elementer, der beskriver løsninger til import.
filestoimport Indeholder
- 1 eller mange configimportfile elementer
- 0 eller mange zipimportdetails elementer, der beskriver de enkelte filer og zip-filer, der skal importeres.
filesmapstoimport Indeholder 1 eller mange configimportmapfile elementer. Rækkefølgen af filerne i dette element angiver den rækkefølge, hvori de er importeret. Få mere at vide om oprettelse af datatilknytninger til import
cmtdatafiles Indeholder 1 eller mange cmtdatafile elementer, der indeholder den oversatte version af den konfigurationsdatafil, der skal importeres.

configsolutionfile element

Beskriver løsninger, der skal importeres i configdatastorage.solutions elementet.

Konfigurationsfilattributter

Name Description
solutionpackagefilename Påkrævet Angiv det .zip filnavn på din løsning.
overwriteunmanagedcustomizations Valgfrit : Om du vil overskrive ikke-administrerede tilpasninger, når du importerer en løsning, der allerede findes i destinationsmiljøet. Hvis du ikke angiver denne funktionsmåde, bevares de ikke-administrerede tilpasninger i den eksisterende løsning i destinationsmiljøet.
publishworkflowsandactivateplugins Valgfrit : Om du vil publicere arbejdsprocesser og aktivere plug-ins i destinationsmiljøet, når løsningen er importeret. Hvis du ikke angiver denne funktionsmåde, udgives arbejdsprocessen, og ekstramoduler aktiveres.

configimportfile element

Beskriver filer, der skal importeres i configdatastorage.filestoimport elementet.

attributter til konfigurationsimportfilen

Name Description
filename Navn på den fil, der indeholder importdataene.
filetype Denne værdi kan være csv, xml eller zip. Hvis filen er en .zip-fil, skal zipimportdetails elementet være til stede med et zipimportdetail element for hver fil i .zip-filen.
associatedmap Navnet på den Dataverse importdatatilknytning, der skal bruges sammen med denne fil. Hvis feltet er tomt, knyttes Dataverse-forsøg på at bruge systemet, der har fastsat navnet på importdatatilknytningen for denne fil.
importtoentity Navnet på .exe-filen i .zip-filen kan være en URL-adresse eller en .msi-fil, der indeholder et hyperlink, der kan aktiveres ved afslutningen af processen.
datadelimiter Navn på den dataafgrænser, der bruges i importfilen. De gyldige værdier er enkelt anførselstegn eller dobbelt anførselstegn.
fielddelimiter Navn på den feltafgrænser, der bruges i importfilen. Gyldige værdier er komma, kolon eller enkelt anførselstegn.
enableduplicatedetection Angiver, om der skal aktiveres regler for registrering af dubletter ved import af data. Gyldige værdier er true eller false.
isfirstrowheader Bruges til at angive, at den første række i den importerede fil indeholder feltnavnene. Gyldige værdier er true eller false.
isrecordownerateam Angiver, om ejeren af post ved import skal være et team. Gyldige værdier er true eller false.
owneruser Den bruger-ID, der skal eje poster. Standardværdien er den bruger, der aktuelt er logget på.
waitforimporttocomplete Hvis true, venter systemet på, at importen skal afsluttes, før du fortsætter. Hvis false, bliver jobbet sat i kø og fortsætter.

zipimportdetails element

Beskriver de zip-filer, der skal importeres i configdatastorage.filestoimport elementet, når elementet configimportfile.filetype er. zip

Indeholder 1 eller flere zipimportdetail elementer, der giver oplysninger om en individuel fil fra en enkelt fil i en zip-fil, der er angivet i configimportfile-elementet.

zipimportdetail element

Indeholder oplysninger om en individuel fil fra en zip-fil, der er angivet i configimportfile-elementet.

zipimportdetail-attributter

Name Description
filename Navn på den fil, der indeholder importdataene.
filetype Denne værdi kan være csv eller xml.
importtoentity Navnet på exe-filen i zip-filen kan være en url-adresse eller en .msi-fil, der indeholder et hyperlink til at starte i slutningen af processen.

configimportmapfile element

Indeholder oplysninger om en enkelt tilknytningsfil, der skal importeres i Dataverse.

configimportmapfile-attributter

Name Description
filename Navn på den fil, der indeholder tilknytningsdata.

cmtdatafile element

Angiver de oversatte konfigurationsdatafiler sammen med landestandard-id'et (obligatorisk) og tilknytningsfilen med brugeroplysninger (valgfrit).

Eksempel på cmtdatafil

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

cmtdatafile-attributter

Name Description
filename Navn på den fil, der indeholder tilknytningsdata.
lcid Strengrepræsentationen af LCID-sprogkode-id'et.
usermapfilename Kun til Dynamics 365 (on-premises). Indeholder den brugertilknytningsfil (.xml), der oprettes ved hjælp af Configuration Migration tool i projektet. Denne fil kræves for at kunne importere brugeroplysninger til en Dynamics 365 (on-premises)-forekomst på et andet domæne.