Condividi tramite

Riferimento ImportConfig

  • Articolo

Il file ImportConfig.xml utilizzato con il programma di distribuzione del pacchetto contiene informazioni sulle soluzioni e sui dati da importare. Di seguito è riportato un esempio:

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

Le sezioni seguenti forniscono dettagli sugli elementi e sugli attributi XML validi per questo documento.

Elemento configdatastorage

configdatastorage è l'elemento radice.

attributi configdatastorage

Tutti questi attributi sono facoltativi.

Name Descrzione
installsampledata Se installare i dati di esempio. Questi sono gli stessi dati di esempio installati attraverso questi altri metodi:
- Aggiungere o rimuovere dati di esempio
- Aggiungere e rimuovere dati di esempio
waitforsampledatatoinstall Se restituisce true e, se anche installsampledata è impostata su true, attende l'installazione dei dati di esempio prima di distribuire il pacchetto. Non impostarlo su true quando installsampledata è false.
agentdesktopzipfile Nome del file ZIP da decomprimere. Se si specifica un nome del file ZIP in questa posizione, viene aggiunge una schermata durante il processo di distribuzione del pacchetto in cui viene richiesto di selezionare la posizione desiderata per decomprimere il contenuto del file.

Questo attributo è comunemente usato per creare pacchetti per Unified Service Desk per Dynamics 365.
agentdesktopexename Nome del file .exe o .msi nel file ZIP o un URL da richiamare al termine del processo di distribuzione.

Questo attributo è comunemente usato per creare pacchetti per Unified Service Desk per Dynamics 365.
crmmigdataimportfile Nome del file di dati di configurazione predefinito (.zip) esportato utilizzando lo strumento di migrazione della configurazione.

elementi configdatastorage

Questi sono gli elementi figlio validi:

Elemento Descrizione
solutions Contiene 0 o molti elementi configsolutionfile che descrivono le soluzioni da importare.
filestoimport Contiene
- 1 o troppi elementi configimportfile
- 0 o molti elementi zipimportdetails che descrivono i singoli file e i file zip da importare.
filesmapstoimport Contiene 1 o molti elementi configimportmapfile. L'ordine dei file di mapping in questo elemento indica l'ordine in cui vengono importati. Ulteriori informazioni sulla creazione di mappe dati per l'importazione
cmtdatafiles Contiene 1 o più elementi cmtdatafile che contengono una versione localizzata del file di dati di configurazione da importare.

Elemento configsolutionfile

Descrive le soluzioni da importare nell'elemento configdatastorage.solutions.

attributi configsolutionfile

Name Descrzione
solutionpackagefilename Necessario: specifica il nome del file con estensione zip della soluzione.
overwriteunmanagedcustomizations Opzionale: se sovrascrivere eventuali personalizzazioni non gestite durante l'importazione di una soluzione già esistente nell'ambiente di destinazione. Se non si specifica questo comportamento, le personalizzazioni non gestite nella soluzione esistente vengono mantenute nell'ambiente di destinazione.
publishworkflowsandactivateplugins Opzionale: se pubblicare flussi di lavoro e attivare i plug-in nell'ambiente di destinazione dopo l'importazione della soluzione. Se non si specifica questo comportamento, il flusso di lavoro viene pubblicato e i plug-in attivati.

Elemento configimportfile

Descrive file da importare nell'elemento configdatastorage.filestoimport.

attributi configimportfile

Name Descrzione
filename Nome del file contenente i dati di importazione.
filetype Questo valore può essere csv, xml o zip. Se si tratta di un file .zip, un elemento zipimportdetails deve essere presente con un elemento zipimportdetail per ciascun file nel file .zip.
associatedmap Nome del mapping dei dati di importazione di Dataverse da utilizzare con questo file. Se è vuoto, Dataverse tenta di utilizzare il nome del mapping dei dati di importazione determinato dal sistema per il file.
importtoentity Può essere il nome del file EXE nel file ZIP, un URL o un file MSI utilizzato per fornire un collegamento da richiamare al termine del processo.
datadelimiter Nome del delimitatore dei dati utilizzato nel file di importazione. I valori validi sono virgoletta singola o virgolette doppie.
fielddelimiter Nome del delimitatore dei campi utilizzato nel file di importazione. I valori validi sono virgola o due punti o virgoletta singola.
enableduplicatedetection Se abilitare le regole di rilevamento dei duplicati sull'importazione dei dati. I valori validi sono true o false.
isfirstrowheader Se la prima riga del file di importazione contiene i nomi dei campi. I valori validi sono true o false.
isrecordownerateam Se il proprietario del record nell'importazione deve essere un team. I valori validi sono true o false.
owneruser L'ID utente che dovrà essere proprietario dei record. Il valore predefinito è l'utente attualmente connesso.
waitforimporttocomplete Se true, il sistema attende il completamento dell'importazione prima di procedere. Se false, aggiunge i processi alla coda e continua.

Elemento zipimportdetails

Descrive i file zip da importare nell'elemento configdatastorage.filestoimport quando configimportfile.filetype è zip.

Contiene 1 o più elementi zipimportdetail che forniscono informazioni sul singolo file all'interno del file zip specificato nell'elemento configimportfile.

Elemento zipimportdetail

Forniscono informazioni sul singolo file all'interno del file zip specificato nell'elemento configimportfile.

attributi zipimportdetail

Name Descrzione
filename Nome del file contenente i dati di importazione.
filetype Questo valore può essere csv o xml.
importtoentity Può essere il nome del file EXE nel file ZIP, un URL o un file MSI utilizzato per fornire un collegamento da richiamare al termine del processo.

Elemento configimportmapfile

Contiene informazioni su un singolo file di mappa da importare in Dataverse.

attributi configimportmapfile

Name Descrzione
filename Il nome del file contenente i dati di mapping.

Elemento cmtdatafile

Specifica i file di dati di configurazione localizzati e l'ID delle impostazioni locali (obbligatorio) e il file di mapping delle informazioni utente (facoltativo).

Esempio di cmtdatafile

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

attributi cmtdatafile

Name Descrzione
filename Il nome del file contenente i dati di mapping.
lcid La rappresentazione della stringa dell'identificatore del codice della lingua LCID.
usermapfilename Solo per Dynamics 365 (on-premises). Contiene il file di mapping utente (.xml) generato utilizzando lo strumento di migrazione della configurazione nel progetto. Questo file è necessario per importare le informazioni dell'utente in un'istanza di Dynamics 365 (on-premises) su un dominio diverso.