ImportConfig referencia

A package deployerrel használt ImportConfig.xml fájl információkat tartalmaz az importálandó megoldásokról és adatokról. Íme egy példa:

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

A következő szakaszok részletesen ismertetik a dokumentum érvényes XML-elemeit és attribútumait.

configdatastorage elem

configdatastorage a gyökérelem.

ConfigDataStorage attribútumok

Ezen attribútumok megadása nem kötelező.

Name	Description
installsampledata	Arra utal, hogy kell-e mintaadatokat telepíteni. Ezek ugyanazok a mintaadatok, amelyek az alábbi módszerekkel vannak telepítve: - Mintaadatok hozzáadása vagy eltávolítása - Mintaadatok hozzáadása és eltávolítása kóddal
waitforsampledatatoinstall	Ha true és ha installsampledata is be true van állítva, megvárja a mintaadatok telepítését a csomag központi telepítése előtt. Ne állítsa ezt a when true is installsampledata értékre false.
agentdesktopzipfile	A kicsomagolni kívánt zip-fájl neve. Ha itt megadja egy .zip-fájl nevét, azzal felvesz egy olyan képernyőt a csomag központi telepítési folyamatába, amely azt kéri, hogy adja meg a fájl tartalmának kibontásához használni kívánt helyet. Ezt az attribútumot általában a Unified Service Desk Dynamics 365 csomagok létrehozásához használják.
agentdesktopexename	A zip-fájlban lévő .exe- vagy .msi-fájl neve, vagy a központi telepítési folyamat végén meghívandó URL-cím. Ezt az attribútumot általában a Unified Service Desk Dynamics 365 csomagok létrehozásához használják.
crmmigdataimportfile	A Konfigurációáttelepítő eszközzel exportált alapértelmezett konfigurációs adatfájl (.zip) neve.

ConfigDataStorage elemek

Ezek az érvényes gyermek elemek:

Elem	Leírások
solutions	0 vagy sok configsolutionfile olyan elemet tartalmaz, amelyek leírják az importálandó megoldásokat.
filestoimport	Tartalmaz - 1 vagy több configimportfile elem - 0 vagy sok zipimportdetails elem , amely leírja az importálandó egyedi fájlokat és zip-fájlokat.
filesmapstoimport	1 vagy több configimportmapfile elemet tartalmaz. Az elemben található térképfájlok sorrendje jelzi az importálásuk sorrendjét. További információ az adattérképek importáláshoz való létrehozásáról
cmtdatafiles	1 vagy több cmtdatafile olyan elemet tartalmaz, amelyek az importálandó konfigurációs adatfájl honosított verzióját tartalmazzák.

configsolutionfile elem

Leírja a configdatastorage.solutions elembe importálandó megoldásokat.

ConfigSolutionFile attribútumok

Name	Description
solutionpackagefilename	Kötelező : Adja meg a megoldás .zip fájlnevét.
overwriteunmanagedcustomizations	Nem kötelező : Azt határozza meg, hogy felülírja-e a nem felügyelt testreszabásokat a célkörnyezetben már létező megoldás importálásakor. Ha nem adja meg ezt a viselkedést, a meglévő megoldás nem felügyelt testreszabásai megmaradnak a célkörnyezetben.
publishworkflowsandactivateplugins	Nem kötelező : Megadja-e a munkafolyamatok közzétételét és a beépülő modulok aktiválását a célkörnyezetben a megoldás importálása után. Ha nem adja meg ezt a viselkedést, a munkafolyamat közzé lesz téve, és a beépülő modulok aktiválódnak.

configimportfile elem

A elemben configdatastorage.filestoimport importálandó fájlok leírása.

Configimportfile attribútumok

Name	Description
filename	Az importálási adatokat tartalmazó fájl neve.
filetype	Ez az érték lehet csv, xml, vagy zip. Ha a fájl .zip fájl, akkor a zipimportdetails .zip fájl minden fájljához külön elemnek kell lennie zipimportdetail egy elemhez .
associatedmap	A fájllal használandó importálási Dataverse-adatleképezés neve. Ha üres, Dataverse megpróbálja használni a rendszer által meghatározott importálási adatleképezés nevét ehhez a fájlhoz.
importtoentity	Lehet a zip-fájlban lévő .exe neve, URL-cím vagy egy .msi-fájl a folyamat végén meghívandó hivatkozás biztosításához.
datadelimiter	Az adatok importálási fájlban használt elválasztó karakterének a neve. Az érvényes értékek egyszeres idézőjelek vagy dupla idézőjelek.
fielddelimiter	A mező importálási fájlban használt elválasztó karakterének a neve. Az érvényes értékek vessző, kettőspont vagy szimpla idézőjel.
enableduplicatedetection	Arra utal, hogy engedélyezi-e a duplikáltelem-észlelési szabályokat az adatimportáláskor. Érvényes értékek: true vagy false.
isfirstrowheader	Azt határozza meg, hogy az importfájl első sora tartalmazza-e a mezőneveket. Érvényes értékek: true vagy false.
isrecordownerateam	Azt határozza meg, hogy az importálási rekord tulajdonosának csapatnak kell-e lennie. Érvényes értékek: true vagy false.
owneruser	Az a felhasználói azonosító, amelynek a rekordok tulajdonosának kell lennie. Az alapértelmezett érték az aktuálisan bejelentkezett felhasználó.
waitforimporttocomplete	Ha true, a rendszer a folytatás előtt megvárja az importálás végét. Ha false, a feladatok várólistába kerülnek, és a rendszer továbblép.

zipimportdetails elem

Leírja a zip-fájlokat, amelyeket importálni kell a configdatastorage.filestoimport elembe, amikor a configimportfile.filetype is zip.

1 vagy több zipimportdetail elemet tartalmaz, amelyek információt nyújtanak a elemben configimportfile megadott zip-fájlonbelüli egyedi fájlról.

zipimportdetail elem

Adjon meg információkat egy adott fájlról a elemben configimportfile megadott zip-fájlonbelül.

Zipimportdetail attribútumok

Name	Description
filename	Az importálási adatokat tartalmazó fájl neve.
filetype	Ez az érték lehet csv vagy xml.
importtoentity	Lehet a zip-fájlban lévő .exe neve, URL-cím, vagy egy .msi-fájl a folyamat végén meghívandó hivatkozás biztosításához.

configimportmapfile elem

Információkat tartalmaz az importálandó egyedi térképfájlról Dataverse.

Configimportmapfile attribútumok

Name	Description
filename	A leképezés adatokat tartalmazó fájl neve.

cmtdatafile elem

Megadja a honosított konfigurációs adatfájlokat, valamint a területi azonosítót (kötelező) és a felhasználói információs térképfájlt (nem kötelező).

CMTDATAFILE példa

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

CMTDATAFILE attribútumok

Name	Description
filename	A leképezés adatokat tartalmazó fájl neve.
lcid	Az LCID nyelvi kódazonosító karakterlánc-ábrázolása.
usermapfilename	Csak azért Dynamics 365 (on-premises) . A projekt Configuration Migration eszközével létrehozott felhasználói leképezési fájlt (.xml) tartalmazza. Ez a fájl szükséges a felhasználói adatok másik tartományban lévő példányba Dynamics 365 (on-premises) történő importálásához.