Del via

ImportConfig-referanse

  • Artikkel

ImportConfig.xml-filen med Package Deployer inneholder informasjon om løsningene og dataene som skal importeres. Nedenfor finner du 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>

Avsnittene nedenfor inneholder detaljer om de gyldige XML-elementene og attributtene for dette dokumentet.

configdatastorage element

configdatastorage er rotelementet.

configdatastorage-attributter

Alle disse attributtene er valgfrie.

Name Description
installsampledata Om eksempeldata skal installeres. Dette er de samme eksempeldataene som installeres ved hjelp av disse andre metodene:
- Legge til eller fjerne eksempeldata
- Legge til og fjerne eksempeldata med kode
waitforsampledatatoinstall Hvis true, og hvis installsampledata også er satt til true, venter på at eksempeldata skal installeres før pakken distribueres. Ikke angi dette til true når installsampledata er false.
agentdesktopzipfile Filnavnet til zip-filen som skal pakkes ut. Hvis du angir et ZIP-filnavn her, legges det til et skjermbilde under pakkedistribusjonsprosessen der du blir bedt om å velge et sted der du vil pakke ut innholdet i filen.

Dette attributtet brukes vanligvis ved opprettelse av pakker for Unified Service Desk for Dynamics 365.
agentdesktopexename Navnet på exe-eller MSI-filen i zip-filen eller en URL-adresse som skal startes på slutten av distribusjons prosessen.

Dette attributtet brukes vanligvis ved opprettelse av pakker for Unified Service Desk for Dynamics 365.
crmmigdataimportfile Filnavnet på standard konfigurasjonsdatafilen (.zip) eksportert ved hjelp av verktøyet for konfigurasjonsoverføring.

configdatastorage-elementer

Dette er de gyldige underordnede elementene:

Element Descriptions
solutions Inneholder 0 eller mange configsolutionfile elementer som beskriver løsninger som skal importeres.
filestoimport Contains
- 1 eller mange configimportfile elementer
- 0 eller mange zipimportdetails element som beskriver enkeltfiler og zip-filer som skal importeres.
filesmapstoimport Inneholder 1 eller mange configimportmapfile element. Rekkefølgen på tilordningsfilene i dette elementet angir i hvilken rekkefølge de importeres. Finn ut mer om hvordan du oppretter datakart for import
cmtdatafiles Inneholder 1 eller mange cmtdatafile elementer som inneholder lokalisert versjon av konfigurasjonsdatafilen som skal importeres.

configsolutionfile element

Beskriver løsninger for import i configdatastorage.solutions-elementet.

configsolutionfile-attributter

Name Description
solutionpackagefilename Obligatorisk Angi det .zip filnavnet for løsningen.
overwriteunmanagedcustomizations Valgfritt : Om du vil overskrive uadministrerte tilpassinger når du importerer en løsning som allerede finnes i målmiljøet. Hvis du ikke angir denne virkemåten, beholdes de uadministrerte tilpassingene i den eksisterende løsningen i målmiljøet.
publishworkflowsandactivateplugins Valgfritt : Om du vil publisere arbeidsflyter og aktivere plugin-moduler i målmiljøet etter at løsningen er importert. Hvis du ikke angir denne virkemåten, publiseres arbeidsflyten og plugin-moduler aktiveres.

configimportfile element

Beskriver filer for import i configdatastorage.filestoimport-elementet.

configimportfile-attributter

Name Description
filename Navnet på filen som inneholder importdataene.
filetype Denne verdien kan være csv, xml eller zip. Hvis filen er en zip-fil, må et zipimportdetails-element vises med et zipimportdetail-element for hver fil i zip-filen.
associatedmap Navnet på Dataverse-datatilordningen for import som skal brukes med denne filen. Hvis tom, prøver Dataverse å bruke det systemgitte datatilordningsnavnet for import for denne filen.
importtoentity Kan være navnet på exe-filen i zip-filen, en URL-adresse eller en MSI-fil for å gi en kobling for å starte på filslutten av prosessen.
datadelimiter Navn på dataskilletegn brukt i importfilen. Gyldige verdier er enkle anførselstegn eller doble anførselstegn.
fielddelimiter Navn på feltskilletegnet brukt i importfilen. Gyldige verdier er komma eller kolon, eller enkle anførselstegn.
enableduplicatedetection Om duplikatregistreringsregler skal aktiveres for dataimport. Gyldige verdier er true eller false.
isfirstrowheader Om den første raden i importfilen inneholder feltnavnene. Gyldige verdier er true eller false.
isrecordownerateam Om eieren av oppføringen i import skal være et team. Gyldige verdier er true eller false.
owneruser Bruker-ID-en som skal eie oppføringene. Standardverdien er brukeren som for øyeblikket er logget på.
waitforimporttocomplete Hvis true, venter systemet på at importen skal fullføres før det fortsetter. Hvis false, setter det jobbene i kø og går videre.

zipimportdetails element

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

Inneholder 1 eller flere zipimportdetail-elementer som gir informasjon om en enkeltfil i zip-filen som er angitt i configimportfile-elementet.

zipimportdetail element

Oppgi informasjon om en enkeltfil i zip-filen som er angitt i configimportfile-elementet.

zipimportdetail-attributter

Name Description
filename Navnet på filen som inneholder importdataene.
filetype Denne verdien kan være csv eller xml.
importtoentity Kan være navnet på exe-filen i zip-filen, en URL-adresse eller en MSI-fil for å gi en kobling for å starte på filslutten av prosessen.

configimportmapfile element

Inneholder informasjon om én enkelt tilordningsfil som skal importeres i Dataverse.

configimportmapfile-attributter

Name Description
filename Navnet på filen som inneholder tilordningsdataene.

cmtdatafile element

Angir de lokaliserte konfigurasjonsdatafilene sammen med ID for nasjonale innstillinger (obligatorisk) og tilordningsfilen for brukerinformasjon (valgfritt).

cmtdatafile-eksempel

<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 Navnet på filen som inneholder tilordningsdataene.
lcid Strengrepresentasjonen av LCID-språkkodeidentifikatoren.
usermapfilename Bare for Dynamics 365 (on-premises). Inneholder brukertilordningsfilen (.xml) som genereres ved hjelp av Configuration Migration Tool i prosjektet. Denne filen kreves for å importere brukerinformasjon til en Dynamics 365 (on-premises)-forekomst i et annet domene.