Freigeben über

ImportConfig-Referenz

  • Artikel

Die mit Package Deployer verwendete Datei ImportConfig.xml enthält Informationen zu den zu importierenden Lösungen und Daten. Nachfolgend ein Beispiel:

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

Die folgenden Abschnitte enthalten Details zu den gültigen XML-Elementen und Attributen für dieses Dokument.

configdatastorage Element

configdatastorage ist das Stammelement.

configdatastorage-Attribute

Alle diese Attribute sind optional.

Name des Dataflows Beschreibung
installsampledata Ob die Beispieldaten installiert werden sollen. Dies sind dieselben Beispieldaten, die mit diesen anderen Methoden installiert wurden:
- Hinzufügen oder Entfernen von Beispieldaten
- Hinzufügen und Entfernen von Beispieldaten mit Code
waitforsampledatatoinstall Wenn true und wenn installsampledata ebenfalls auf true festgelegt ist, wird darauf gewartet, dass Beispieldaten installiert werden, bevor das Paket bereitgestellt wird. Setzen Sie dies nicht auf true, wenn installsampledata false lautet.
agentdesktopzipfile Dateiname der zu entpacken ZIP-Datei. Wenn Sie einen zip-Dateinamen angeben, wird während des Paketbereitstellungsprozesses ein Bildschirm hinzugefügt, der Sie aufgefordert, einen Speicherort auszuwählen, an dem Sie die Inhalte der Datei entpacken möchten.

Dieses Attribut wird allgemein für das Erstellen von Paketen für Unified Service Desk for Dynamics 365 verwendet.
agentdesktopexename Name der .exe oder .msi-Datei in der ZIP-Datei oder eine URL, die am Ende des Bereitstellungsprozesses aufgerufen wird.

Dieses Attribut wird allgemein für das Erstellen von Paketen für Unified Service Desk for Dynamics 365 verwendet.
crmmigdataimportfile Dateiname der Standardkonfigurationsdatendatei (ZIP-Datei), exportiert mithilfe des Konfigurationsmigrationstool.

ConfigDataStorage-Elemente

Dies sind die gültigen untergeordneten Elemente:

Element Beschreibungen
solutions Enthält 0 oder viele configsolutionfile Elemente, die zu importierende Lösungen beschreiben.
filestoimport Contains
– 1 oder viele configimportfile-Elemente
– 0 oder viele zipimportdetails-Elemente, die einzelne zu importierende Dateien und ZIP-Dateien beschreiben.
filesmapstoimport Enthält 1 oder mehrere configimportmapfile-Elemente. Die Reihenfolge der Zuordnungsdateien in diesem Elemente gibt die Reihenfolge an, in der sie importiert werden. Weitere Informationen zum Erstellen von Datenzuordnungen für den Import
cmtdatafiles Enthält 1 oder viele cmtdatafile-Elemente, die lokalisierte Versionen der Konfigurationsdatendatei enthalten, die importiert werden soll.

configsolutionfile Element

Beschreibt Lösungen zum Importieren in das configdatastorage.solutions-Element.

ConfigSolutionFile-Attribute

Name des Dataflows Beschreibung
solutionpackagefilename Erforderlich Geben Sie den ZIP-Dateinamen Ihrer Lösung an.
overwriteunmanagedcustomizations Optional Ob nicht verwaltete Anpassungen beim Importieren einer Lösung überschrieben werden sollen, die bereits im Ziel Umgebung vorhanden ist. Wenn Sie dieses Verhalten nicht angeben, werden die nicht verwalteten Anpassungen in der vorhandenen Lösung in der Zielumgebung aufrechterhalten.
publishworkflowsandactivateplugins Optional Ob Workflows veröffentlicht und Plug-Ins im Ziel Umgebung aktiviert werden sollen, nachdem die Lösung importiert wurde. Wenn Sie dieses Verhalten nicht angeben, werden die Workflows veröffentlicht und Plug-Ins aktiviert.

configimportfile Element

Beschreibt Dateien zum Importieren in das configdatastorage.filestoimport-Element.

configimportfile-Attribute

Name des Dataflows Beschreibung
filename Name der Datei, die die importierten Daten enthält.
filetype Dieser Wert kann csv, xml oder zip lauten. Wenn die Datei eine ZIP-Datei ist, muss ein zipimportdetails-Element mit einem zipimportdetail-Element für jede Datei in der ZIP-Datei vorhanden sein.
associatedmap Name der Dataverse Importdatenzuordnung, die mit dieser Datei verwendet werden soll. Wenn leer, versucht Dataverse, den vom System festgelegten Importdatenzuordnungsnamen dieser Datei zu verwenden.
importtoentity Dies kann der Name der EXE-Datei in der ZIP-Datei, eine URL oder eine MSI-Datei sein, um einen Link bereitzustellen, der am Ende des Vorgangs aufgerufen wird.
datadelimiter In der Importdatei verwendeter Name des Datentrennzeichens. Gültige Werte sind einfache oder doppelte Anführungszeichen.
fielddelimiter In der Importdatei verwendeter Name des Feldtrennzeichens. Gültige Werte sind Komma oder Doppelpunkt oder einfache Anführungszeichen.
enableduplicatedetection Ob beim Datenimport Duplikaterkennungsregeln aktiviert werden. Gültige Werte sind true oder false.
isfirstrowheader Ob die erste Zeile der Importdatei Feldnamen enthält. Gültige Werte sind true oder false.
isrecordownerateam Ob der Besitzende des Datensatzes beim Import ein Team sein soll. Gültige Werte sind true oder false.
owneruser Die Benutzer-ID, welche für die Datensätze zuständig sein soll. Der Standardwert ist der aktuell angemeldete Benutzer.
waitforimporttocomplete Wenn true, wartet das System auf den Abschluss des Importvorgangs, bevor fortgesetzt wird. Wenn false, werden die Aufträge in Warteschlangen gegeben und es wird fortgesetzt.

zipimportdetails Element

Beschreibt die in das configdatastorage.filestoimport-Element zu importierenden ZIP-Dateien, wenn der configimportfile.filetype zip lautet.

Enthält 1 oder mehrere zipimportdetail-Elemente, die Informationen über eine einzelne Datei in der ZIP-Datei bereitstellen, die im configimportfile-Element angegeben ist.

zipimportdetail Element

Stellt Informationen über eine einzelne Datei in der ZIP-Datei bereit, die im configimportfile-Element angegeben ist.

zipimportdetail-Attribute

Name des Dataflows Beschreibung
filename Name der Datei, die die importierten Daten enthält.
filetype Dieser Wert kann csv oder xml lauten.
importtoentity Dies kann der Name der EXE-Datei in der ZIP-Datei, eine URL oder eine MSI-Datei sein, um einen Link bereitzustellen, der am Ende des Vorgangs aufgerufen wird.

configimportmapfile Element

Enthält Informationen zu einer einzelnen Zuordnungsdatei, die in Dataverse importiert werden soll.

configimportmapfile-Attribute

Name des Dataflows Beschreibung
filename Der Name der Datei, welche die Zuordnungsdaten enthält.

cmtdatafile Element

Gibt die lokalisierten Konfigurationsdatendateien sowie die Gebietsschema-ID (erforderlich) und die Zuordnungsdatei für Benutzerinformationen (optional) an.

cmtdatafile-Beispiel

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

cmtdatafile-Attribute

Name des Dataflows Beschreibung
filename Der Name der Datei, welche die Zuordnungsdaten enthält.
lcid Die Zeichenfolgendarstellung der LCID-Sprachcode-ID.
usermapfilename Nur für Dynamics 365 (on-premises). Enthält die mit dem Konfigurationsmigrationstool in Ihrem Projekt generierte Benutzerzuordnungsdatei (.xml). Diese Datei wird benötigt, um Benutzerinformationen in eine Dynamics 365 (on-premises)-Instanz in einer anderen Domäne zu importieren.