ImportConfig-naslag

Het bestand ImportConfig.xml dat wordt gebruikt met Package Deployer bevat informatie over de oplossingen en gegevens die moeten worden geïmporteerd. Hier volgt een voorbeeld:

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

In de onderstaande secties vindt u details over de geldige XML-elementen en -kenmerken voor dit document.

configdatastorage element

configdatastorage is het wortelelement.

configdatastorage-kenmerken

Al deze kenmerken zijn optioneel.

Meting	Omschrijving
installsampledata	Of u voorbeeldgegevens moet installeren. Dit zijn dezelfde voorbeeldgegevens die met deze andere methoden worden geïnstalleerd: - Voorbeeldgegevens toevoegen of verwijderen - Voorbeeldgegevens toevoegen en verwijderen met code
waitforsampledatatoinstall	Als true en als installsampledata ook is ingesteld op true, wacht u tot de voorbeeldgegevens zijn geïnstalleerd alvorens het pakket te distribueren. Stel dit niet in op true wanneer installsampledata is false.
agentdesktopzipfile	Bestandsnaam of zip-bestand om uit te pakken. Als u een zip-bestand en bestandsnaam hier opgeeft, wordt er een scherm tijdens het installatieproces van het pakket toegevoegd, waarin u wordt voorgesteld om een locatie te selecteren waar u de inhoud van het bestand uit wilt pakken. Dit kenmerk wordt vaak gebruikt voor het maken van pakketten voor Unified Service Desk voor Dynamics 365.
agentdesktopexename	Naam van het EXE- of MSI-bestand in het zipbestand of een URL die aan het einde van de installatieprocedure moet worden aangehaald. Dit kenmerk wordt vaak gebruikt voor het maken van pakketten voor Unified Service Desk voor Dynamics 365.
crmmigdataimportfile	Bestandsnaam van het standaardconfiguratiegegevensbestand (.zip) dat is geëxporteerd met het hulpprogramma voor configuratiemigratie.

configdatastorage-elementen

Dit zijn de geldige onderliggende elementen:

Element	Descriptions
solutions	Bevat 0 of veel configsolutionfile- elementen die te importeren oplossingen beschrijven.
filestoimport	Bevat - 1 of veel configimportfile-elementen - 0 of veel zipimportdetails-element dat afzonderlijke bestanden en zip-bestanden beschrijft die moeten worden geïmporteerd.
filesmapstoimport	Bevat 1 of veel configimportmapfile-element. De volgorde van de toegewezen bestanden in dit element geeft de volgorde waarin ze worden geïmporteerd. Meer informatie over het maken van datakaarten voor import
cmtdatafiles	Bevat 1 of veel cmtdatafile-elementen die de gelokaliseerde versie van het te importeren configuratiegegevensbestanden bevatten.

configsolutionfile element

Beschrijft oplossingen die moeten worden geïmporteerd in het configdatastorage.solutions-element.

configsolutionfile-kenmerken

Meting	Omschrijving
solutionpackagefilename	Vereist Geef de .zip-bestandsnaam van uw oplossing op.
overwriteunmanagedcustomizations	Optioneel Of onbeheerde aanpassingen moeten worden overschreven bij het importeren van een oplossing die al bestaat in het doel omgeving. Als u dit gedrag niet opgeeft, blijven de onbeheerde aanpassingen in de bestaande oplossing behouden in de doelomgeving.
publishworkflowsandactivateplugins	Optioneel Of workflows moeten worden gepubliceerd en plug-ins moeten worden geactiveerd in het doel omgeving nadat de oplossing is geïmporteerd. Als u dit gedrag niet opgeeft, worden de workflows gepubliceerd en de plug-ins geactiveerd.

configimportfile element

Beschrijft bestanden die moeten worden geïmporteerd in het configdatastorage.filestoimport-element.

configimportfile-kenmerken

Meting	Omschrijving
filename	De naam van het bestand dat de importgegevens bevat.
filetype	Deze waarde kan csv, xml of zip zijn. Als het bestand een zip-bestand is, moet een zipimportdetails-element aanwezig zijn met een zipimportdetail-element voor elk bestand in het zip-bestand.
associatedmap	Naam van de Dataverse importgegevenstoewijzing om met dit bestand te gebruiken. Indien leeg, probeert Dataverse de door het systeem bepaalde naam van de importgegevenstoewijzing te gebruiken.
importtoentity	Kan de naam van het uitvoeringsbestand in het ZIP-bestand, een URL of een MSI-bestand zijn om een koppeling te bieden om aan het einde van het proces aan te roepen.
datadelimiter	Naam van het gegevensscheidingsteken dat in het importbestand wordt gebruikt. Geldige waarden zijn enkele aanhalingstekens of dubbele aanhalingstekens.
fielddelimiter	Naam van het veldscheidingsteken dat in het importbestand wordt gebruikt. Geldige waarden zijn komma's, dubbele punten of enkele aanhalingstekens.
enableduplicatedetection	Of duplicaatdetectieregels tijdens gegevensimport moeten worden ingeschakeld. Geldige waarden zijn true of false.
isfirstrowheader	Of de eerste rij in het importbestand de veldnamen bevat. Geldige waarden zijn true of false.
isrecordownerateam	Of de eigenaar van de record bij importeren een team moet zijn. Geldige waarden zijn true of false.
owneruser	De gebruikers-id die eigenaar van de records moet zijn. De standaardwaarde is de momenteel aangemelde gebruiker.
waitforimporttocomplete	Als true, dan wacht het systeem tot de voltooiing van de import alvorens verder te gaan. Als false, dan plaatst het de taken in de wachtrij en gaat het verder.

zipimportdetails element

Beschrijft zip-bestanden die moeten worden geïmporteerd in het configdatastorage.filestoimport-element wanneer de configimportfile.filetype is zip.

Bevat 1 of meer zipimportdetail-elementen die informatie bieden over een afzonderlijke bestand binnen het zip-bestand dat is opgegeven in het configimportfile-element.

zipimportdetail element

Geef informatie over een afzonderlijke bestand binnen het zip-bestand dat is opgegeven in het configimportfile-element.

zipimportdetail-kenmerken

Meting	Omschrijving
filename	De naam van het bestand dat de importgegevens bevat.
filetype	Deze waarde kan csv of xml zijn.
importtoentity	Kan de naam van het exe in het zip-bestand, een URL, of een .msi-bestand zijn om een koppeling te bieden om aan het einde van het proces aan te roepen.

configimportmapfile element

Bevat informatie over een afzonderlijk toewijzingsbestand dat u wilt importeren in Dataverse.

configimportmapfile-kenmerken

Meting	Omschrijving
filename	De naam van het bestand dat de toewijzingsgegevens bevat.

cmtdatafile element

Specificeert de gelokaliseerde configuratiegegevensbestanden, de landinstellingen-id (vereist) en het toewijzingsbestand met de gebruikersgegevens (optioneel).

Voorbeeld van cmtdatafile

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

cmtdatafile-kenmerken

Meting	Omschrijving
filename	De naam van het bestand dat de toewijzingsgegevens bevat.
lcid	De tekenreeksweergave van de LCID-taalcode-id.
usermapfilename	Alleen voor Dynamics 365 (on-premises). Bevat het gebruikerstoewijzingsbestand (.xml) dat is gegenereerd met behulp van de Configuration Migration Tool in uw project. Dit bestand is vereist om gebruikersgegevens te importeren naar een Dynamics 365 (on-premises)-exemplaar op een ander domein.