Jaa

ImportConfig-viite

  • Artikkeli

Package Deployerin kanssa käytettävä ImportConfig.xml-tiedosto sisältää tietoja tuotavista ratkaisuista ja tiedoista. Seuraavassa on esimerkki:

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

Seuraavissa osissa on tietoja tämän asiakirjan kelvollisista XML-elementeistä ja -määritteistä.

configdatastorage alkuaine

configdatastorage on juurielementti.

configdatastorage-määritteet

Kaikki nämä määritteet ovat valinnaisia.

Name Description
installsampledata Asennetaanko näytetiedot. Nämä ovat samat näytetiedot, jotka asennetaan käyttäen seuraavia muita menetelmiä:
- Mallitietojen lisääminen tai poistaminen
- Mallitietojen lisääminen ja poistaminen koodilla
waitforsampledatatoinstall Jos true ja jos myös installsampledata on true, odotetaan esimerkkitiedostojen asentamista ennen paketin käyttöönottoa. Älä aseta tämän arvoksi true, kun installsampledata on false.
agentdesktopzipfile Avattavan zip-tiedoston tiedostonimi. Jos määrität .zip-tiedoston nimen tässä, lisätään paketin käyttöönottoprosessin aikana näkyviin tuleva ruutu, joka kehottaa valitsemaan sijainnin, johon haluat purkaa tiedoston sisällön.

Tätä määritettä käytetään yleisesti luotaessa paketteja Unified Service Desk for Dynamics 365:lle.
agentdesktopexename Zip-tiedostossa olevan .exe- tai .msi-tiedoston nimi tai URL-osoite, jota käytetään käyttöönottoprosessin lopussa.

Tätä määritettä käytetään yleisesti luotaessa paketteja Unified Service Desk for Dynamics 365:lle.
crmmigdataimportfile Määrityksen siirtotyökalulla viedyn oletusmääritystiedoston (.zip) tiedostonimi.

configdatastorage-elementit

Nämä ovat kelvollisia alielementtejä:

Elementti Kuvaukset
solutions Sisältää 0 tai useita configsolutionfile-elementtiä, jotka kuvaavat tuotavia ratkaisuja.
filestoimport Sisältö
- 1 tai useita configimportfile-elementtiä
– 0 tai monta zipimportdetails-elementtiä, jotka kuvaavat tuotavia yksittäisiä tiedostoja ja zip-tiedostoja.
filesmapstoimport Sisältää 1 tai monta configimportmapfile-elementtiä. Tämän elementin karttatiedostojen järjestys ilmaisee niiden tuomisjärjestyksen. Lue lisää tietokarttojen luomisesta tuontia varten
cmtdatafiles Sisältää 1 tai monta cmtdatafile-elementtiä, jotka sisältävät lokalisoidun version tuotavasta määritystiedostosta.

configsolutionfile alkuaine

Kuvaa configdatastorage.solutions-elementtiin tuotavia ratkaisuja.

configsolutionfile-määritteet

Name Description
solutionpackagefilename Pakollinen Määritä ratkaisun .zip tiedostonimi.
overwriteunmanagedcustomizations Valinnainen Korvataanko hallitsemattomat mukautukset, kun tuodaan kohdeympäristössä jo oleva ratkaisu. Jos et määritä tätä toimintatapaa, aiemmin luodun ratkaisun hallitsemattomia mukautuksia ylläpidetään kohdeympäristössä.
publishworkflowsandactivateplugins Valinnainen Julkaistaanko työnkulut ja aktivoidaanko laajennukset kohdeympäristössä ratkaisun tuonnin jälkeen. Jos et määritä tätä toimintoa, työnkulku julkaistaan ja laajennukset aktivoidaan.

configimportfile alkuaine

Kuvaa configdatastorage.filestoimport-elementtiin tuotavia tiedostoja.

configimportfile-määritteet

Name Description
filename Tuotavat tiedot sisältävän tiedoston nimi.
filetype Arvo voi olla csv, xml tai zip. Jos tiedosto on .zip-tiedosto, zipimportdetails-elementin on oltava mukana ja siinä on oltava zipimportdetail-elementti jokaista .zip-tiedoston tiedostoa kohden.
associatedmap Tämän tiedoston kanssa käytettävän Dataverse tuontitietokartan nimi. Jos se on tyhjä, Dataverse yrittää käyttää järjestelmän tälle tiedostolle määrittämää tuontitietokarttaa.
importtoentity Se voi olla prosessin lopussa käytettävä zip-tiedostossa olevan exe-tiedoston nimi, URL-osoite tai .msi-tiedosto, jolla annetaan linkki.
datadelimiter Tuontitiedostossa käytetyn tietojen erottimen nimi. Kelvollisia arvoja ovat yksinkertaiset ja kaksinkertainen lainausmerkki.
fielddelimiter Tuontitiedostossa käytetyn kenttien erottimen nimi. Kelvollisia arvoja ovat pilkku, kaksoispiste ja yksinkertainen lainausmerkki.
enableduplicatedetection Otetaanko kaksoiskappaleiden tunnistussäännöt käyttöön tietojen tuonnissa. Kelvollisia arvoja ovat true ja false.
isfirstrowheader Ilmaisee, sisältääkö tuontitiedoston ensimmäinen rivi kenttien nimet. Kelvollisia arvoja ovat true ja false.
isrecordownerateam Pitäisikö tuotavan tiedoston omistajan olla ryhmä. Kelvollisia arvoja ovat true ja false.
owneruser Käyttäjätunnus, jonka pitäisi omistaa tietueet. Oletusarvona on kirjautuneena oleva käyttäjä.
waitforimporttocomplete Jos true, järjestelmä odottaa tuonnin valmistumista ennen jatkamista. Jos false, se asettaa tehtävät jonoon ja jatkaa.

zipimportdetails alkuaine

Kuvaa configdatastorage.filestoimport-elementtiin tuotavat zip-tiedostot, kun configimportfile.filetype on zip.

Sisältää 1 tai monta zipimportdetail-elementtiä, jossa on tietoja yksittäisestä tiedostosta zip-tiedostossa, joka määritetään configimportfile-elementissä.

zipimportdetail alkuaine

Anna tietoja yksittäisestä tiedostosta zip-tiedostossa, joka määritetään configimportfile-elementissä.

zipimportdetail-määritteet

Name Description
filename Tuotavat tiedot sisältävän tiedoston nimi.
filetype Arvo voi olla csv tai xml.
importtoentity Se voi olla prosessin lopussa käytettävä zip-tiedostossa olevan exe-tiedoston nimi, URL-osoite tai .msi-tiedosto, jolla annetaan linkki.

configimportmapfile alkuaine

Sisältää tietoja yksittäisestä Dataverseen tuotavasta yhdistämismääritystiedostosta.

configimportmapfile-määritteet

Name Description
filename Yhdistämistiedot sisältävän tiedoston nimi.

cmtdatafile alkuaine

Määritä lokalisoidut määritystiedostot yhdessä kielialueen tunnuksen (pakollinen) ja käyttäjätietojen karttatiedoston (valinnainen) kanssa.

cmtdatafile-esimerkki

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

cmtdatafile-määritteet

Name Description
filename Yhdistämistiedot sisältävän tiedoston nimi.
lcid LCID-kielikooditunnuksen merkkijonoesitys.
usermapfilename Vain Dynamics 365 (on-premises) -ratkaisulle. Sisältää projektin määritysten siirtotyökalulla luodun käyttäjän yhdistämistiedoston (.xml). Tämä tiedosto on pakollinen, kun käyttäjätietoja tuodaan toisen toimialueen Dynamics 365 (on-premises) -esiintymään.