Compartir a través de

Referencia de importación de configuración

  • Artículo

El archivo ImportConfig.xml utilizado con Package Deployer contiene información sobre las soluciones y los datos que se importarán. A continuación viene un ejemplo:

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

Las siguientes secciones proporcionan detalles sobre los elementos y atributos XML válidos para este documento.

configdatastorage elemento

configdatastorage es el elemento raíz.

Atributos configdatastorage

Todos estos atributos son opcionales.

Name Description
installsampledata Si se instalan los datos de ejemplo. Estos son los mismos datos de ejemplo instalados usando estos otros métodos:
- Agregar o eliminar datos de muestra
- Agregar y eliminar datos de muestra con código
waitforsampledatatoinstall Si true y installsampledata también se establecen en true, espere los datos de ejemplo para instalar antes de implementar el paquete. No establezca esto en true cuando installsampledata es false.
agentdesktopzipfile Nombre del archivo zip para desempaquetar. Si especifica un nombre de archivo .zip aquí, este agrega una pantalla durante el proceso de implementación del paquete que le solicita que seleccione una ubicación donde desea desempaquetar el contenido del archivo.

Este atributo es de uso general para crear los paquetes para Unified Service Desk for Dynamics 365.
agentdesktopexename Nombre del archivo .exe o .msi del archivo zip o una dirección URL que se invocará al final del proceso de implementación.

Este atributo es de uso general para crear los paquetes para Unified Service Desk for Dynamics 365.
crmmigdataimportfile Nombre del archivo de datos de configuración predeterminada (.zip) exportado usando la herramienta de migración de la configuración.

Elementos de configdatastorage

Estos son los elementos secundarios válidos:

Elemento Descripciones
solutions Contiene 0 o muchos elementos configsolutionfile que describen soluciones para importar.
filestoimport Contiene
- 1 o muchos elementos configimportfile
- 0 o muchos elementos zipimportdetails que describen archivos individuales y archivos zip que se importarán.
filesmapstoimport Contiene 1 o muchos elementos configimportmapfile. El orden de los archivos de asignación de este elemento indica el orden en que se importan. Obtenga más información sobre cómo crear mapas de datos para importar
cmtdatafiles Contiene 1 o muchos elementos cmtdatafile que contienen la versión localizada del archivo de datos de configuración que se importará.

configsolutionfile elemento

Describe soluciones para importar en el elemento configdatastorage.solutions.

Atributos de configsolutionfile

Name Description
solutionpackagefilename Requerido Especifique el nombre del archivo .zip de su solución.
overwriteunmanagedcustomizations Opcional Si se debe sobrescribir cualquier personalización no administrada al importar una solución que ya existe en el destino ambiente. Si no especifica este comportamiento, las personalizaciones no gestionadas de la solución existente se mantienen en el entorno de destino.
publishworkflowsandactivateplugins Opcional Si se deben publicar flujos de trabajo y activar complementos en el destino ambiente después de importar la solución. Si no especifica este comportamiento, se publican los flujos de trabajo y se activan los complementos.

configimportfile elemento

Describe archivos para importar en el elemento configdatastorage.filestoimport.

Atributos de configimportfile

Name Description
filename Nombre del archivo que contiene los datos de importación.
filetype Este valor puede ser csv, xml o zip. Si el archivo es un archivo .zip, un elemento zipimportdetails debe estar presente con un elemento zipimportdetail para cada archivo del archivo .zip.
associatedmap Nombre de la asignación de datos de importación de Dataverse a usar con este archivo. Si se deja en blanco, Dataverse intenta usar el nombre de la asignación de datos de importación determinado por el sistema para este archivo.
importtoentity Puede ser el nombre del exe en el archivo zip, una dirección URL o un archivo .msi para proporcionar un vínculo para invocar al final del proceso.
datadelimiter Nombre del delimitador de datos usado en el archivo de importación. Los valores válidos son comillas simples o comillas dobles.
fielddelimiter Nombre del delimitador de campos usado en el archivo de importación. Los valores válidos son coma, dos puntos o comillas simples.
enableduplicatedetection Si desea habilitar reglas de detección de duplicados en la importación de datos. Los valores válidos son true o false.
isfirstrowheader Si la primera fila del archivo de importación contiene los nombres de campos. Los valores válidos son true o false.
isrecordownerateam Si el propietario del registro de importación debe ser un equipo. Los valores válidos son true o false.
owneruser El Id. de usuario que debe ser el propietario de los registros. El valor predeterminado es el usuario que ha iniciado sesión actualmente.
waitforimporttocomplete Si es true, el sistema espera que la importación termine antes de continuar. Si false, pone los trabajos en cola y continúa.

zipimportdetails elemento

Describe los archivos zip que se importarán en el elemento configdatastorage.filestoimport cuando configimportfile.filetype es zip.

Contiene 1 o más elementos zipimportdetail que proporcionan información sobre un archivo individual en el archivo ZIP especificado en el elemento configimportfile.

zipimportdetail elemento

Proporcione información sobre un archivo individual en el archivo ZIP especificado en el elemento configimportfile.

Atributos zipimportdetail

Name Description
filename Nombre del archivo que contiene los datos de importación.
filetype Este valor puede ser csv o xml.
importtoentity Puede ser el nombre del exe en el archivo zip, una dirección URL o un archivo .msi para proporcionar un vínculo para invocar al final del proceso.

configimportmapfile elemento

Contiene información sobre un archivo de mapa individual para importar en Dataverse.

Atributos configimportmapfile

Name Description
filename El nombre del archivo que contiene los datos de asignación.

cmtdatafile elemento

Especifica los archivos de datos de configuración localizados junto con el identificador de configuración regional (obligatorio) y el archivo de asignación de la información del usuario (opcional).

Ejemplo de cmtdatafile

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

Atributos de cmtdatafile

Name Description
filename El nombre del archivo que contiene los datos de asignación.
lcid La representación de cadena del identificador del código de idioma LCID.
usermapfilename Para Dynamics 365 (on-premises) solo. Contiene el archivo de mapa de usuario (.xml) generado utilizando Configuration Migration Tool en su proyecto. Este archivo es necesario para importar información de usuario a una instancia de Dynamics 365 (on-premises) en un dominio diferente.