Partajați prin

Referință ImportConfig

  • Articol

Fișierul ImportConfig.xml utilizat cu pachetul de implementare conține informații despre soluțiile și datele de importat. Următorul este un exemplu:

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

Următoarele secțiuni oferă detalii despre elementele și atributele XML valide pentru acest document.

configdatastorage element

configdatastorage este elementul rădăcină.

Atributele configdatastorage

Toate aceste atribute sunt opționale.

Nume Descriere
installsampledata Dacă se instalează date eșantion. Acestea sunt aceleași date eșantion instalate folosind aceste alte metode:
- Adăugați sau eliminați date mostre
- Adăugați și eliminați mostre de date cu cod
waitforsampledatatoinstall Dacă true și dacă installsampledata este, de asemenea, setat la true, așteaptă ca datele eșantion să se instaleze înainte de a implementa pachetul. Nu setați acest lucru la true când installsampledata este false.
agentdesktopzipfile Numele fișierului fișierului zip de dezarhivat. Dacă specificați aici un nume de fișier .zip, acesta adaugă un ecran în timpul procesului de implementare a pachetelor care vă solicită să selectați o locație în care doriți să dezarhivați conținuturile fișierului.

Acest atribut este folosit în mod obișnuit pentru a crea pachete pentru Unified Service Desk for Dynamics 365.
agentdesktopexename Numele fișierului .exe sau .msi din fișierul zip sau a unei adrese URL care trebuie invocată la sfârșitul procesului de implementare.

Acest atribut este folosit în mod obișnuit pentru a crea pachete pentru Unified Service Desk for Dynamics 365.
crmmigdataimportfile Numele fișierului fișierului de date implicit de configurare (.zip) exportat folosind instrumentul Migrare configurare.

Elemente de configdatastorage

Acestea sunt elementele descendent valide:

Element Descrieri
solutions Conține 0 sau mai multe configsolutionfile elemente care descriu soluții de import.
filestoimport Conține
- 1 sau mai multe configimportfile elemente
- 0 sau multe zipimportdetails element care descriu fișiere individuale și fișiere zip care urmează să fie importate.
filesmapstoimport Conține 1 sau mai multe configimportmapfile element. Ordinea fișierelor de hărți din acest element indică ordinea în care sunt importate. Aflați mai multe despre crearea hărților de date pentru import
cmtdatafiles Conține 1 sau mai multe cmtdatafile elemente care conțin versiunea localizată a fișierului de date de configurare care urmează să fie importat.

configsolutionfile element

Descrie soluții de import în elementul configdatastorage.solutions .

Atributele configsolutionfile

Nume Descriere
solutionpackagefilename Necesar Specificați numele fișierului .zip al soluției dvs.
overwriteunmanagedcustomizations Opțional Dacă trebuie să suprascrieți orice personalizări negestionate atunci când importați o soluție care există deja în mediul țintă. Dacă nu specificați acest comportament, personalizările negestionate din soluția existentă sunt menținute în mediul țintă.
publishworkflowsandactivateplugins Opțional Dacă se publică fluxuri de lucru și se activează plug-in-uri în mediul țintă după importarea soluției. Dacă nu specificați acest comportament, fluxul de lucru este publicat și plug-in-urile activate.

configimportfile element

Descrie fișierele de importat în elementul configdatastorage.filestoimport .

Atributele configimportfile

Nume Descriere
filename Numele fișierului care conține datele de import.
filetype Această valoare poate fi csv, xml sau zip. Dacă fișierul este un fișier .zip, un zipimportdetails element trebuie să fie prezent cu un zipimportdetail element pentru fiecare fișier din .fișier Zip.
associatedmap Numelemapării de date Dataverse de import pe care să o utilizați cu acest fișier. Dacă este necompletat, Dataverse încearcă să folosească numele hărții de date de import determinat de sistem pentru acest fișier.
importtoentity Poate numele fișierului exe din fișierul zip, un URL sau un fișier .msi să furnizeze un link de invocat la finalul procesului.
datadelimiter Numele delimitatorului de date utilizat în fișierul de import. Valorile valide sunt ghilimele simple sau duble.
fielddelimiter Numele delimitatorului de câmp utilizat în fișierul de import. Valorile valide sunt virgulă sau două puncte sau ghilimele simple.
enableduplicatedetection Dacă se activează regulile de detectare duplicat la importul de date. Valori valide sunt true sau false.
isfirstrowheader Dacă primul rând al fișierului de import conține numele câmpurilor. Valori valide sunt true sau false.
isrecordownerateam Dacă proprietarul înregistrării la import ar trebui să fie o echipă. Valori valide sunt true sau false.
owneruser ID-ul utilizatorului care ar trebui să dețină înregistrările. Valoarea implicită este utilizatorul conectat în prezent.
waitforimporttocomplete Dacă true, sistemul așteaptă completarea importului înainte de a continua. Dacă false, pune la coadă operațiunile și merge mai departe.

zipimportdetails element

Descrie fișiere zip de importat în elementul configdatastorage.filestoimport când configimportfile.filetype este zip.

Conține 1 sau mai multe zipimportdetail elemente care oferă informații despre un fișier individual din fișierul zip specificat în configimportfile elementul.

zipimportdetail element

Furnizați informații despre un fișier individual din fișierul zip specificat în elementul configimportfile.

Atributele zipimportdetail

Nume Descriere
filename Numele fișierului care conține datele de import.
filetype Această valoare poate fi csv sau xml.
importtoentity Poate numele fișierului exe din fișierul zip, un url sau un fișier .msi să furnizeze un link de invocat la finalul procesului.

configimportmapfile element

Conține informații despre un fișier de hartă individual în care să fie importat Dataverse.

Atributele configimportmapfile

Nume Descriere
filename Numele fișierului care conține datele mapare.

cmtdatafile element

Specifică fișierele de date de configurare localizate împreună cu ID-ul localului (obligatoriu) și fișierul de hartă cu informații despre utilizator (opțional).

Exemplu cmtdatafile

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

Atributele cmtdatafile

Nume Descriere
filename Numele fișierului care conține datele mapare.
lcid Reprezentarea șirului de identificare a codului de limbă LCID.
usermapfilename Numai pentru Dynamics 365 (on-premises) . Conține fișierul hartă utilizator (.xml) generat folosind instrumentul de migrare a configurației din proiectul dumneavoastră. Acest fișier este necesar pentru a importa informații despre utilizator într-o Dynamics 365 (on-premises) instanță de pe un alt domeniu.