Referência ImportConfig

O arquivo ImportConfig.xml usado com o Package Deployer contém informações sobre as soluções e os dados a serem importados. Veja o exemplo a seguir:

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

As seções a seguir fornecem detalhes sobre os elementos e atributos XML válidos para este documento.

configdatastorage elemento

configdatastorage é o elemento raiz.

Atributos configdatastorage

Todos esses atributos são opcionais.

Name	Description
installsampledata	Se deve instalar dados de exemplo. Esses são os mesmos dados de exemplo instalados usando esses outros métodos: - Adicionar ou remover dados de amostra - Adicionar e remover dados de amostra com código
waitforsampledatatoinstall	Se true e se installsampledata também forem definidos como true, aguarda a instalação dos dados de exemplo antes da implantação do pacote. Não defina isso como true quando installsampledata for false.
agentdesktopzipfile	Nome do arquivo .zip que será desempacotado. Se você especificar um nome de arquivo .zip aqui, ele adiciona uma tela durante o processo de implantação do pacote que solicita a seleção de um local onde você deseja desempacotar o conteúdo do arquivo. Esse atributo é comumente usado para criar pacotes para o Unified Service Desk para Dynamics 365.
agentdesktopexename	Nome do .exe ou .msi do arquivo .zip ou uma URL que será invocada no final do processo de implantação. Esse atributo é comumente usado para criar pacotes para o Unified Service Desk para Dynamics 365.
crmmigdataimportfile	Nome do arquivo do arquivo de dados de configuração padrão (.zip) exportado usando a ferramenta Migração de Configuração.

Elementos configdatastorage

Estes são os elementos filho válidos:

Elemento	Descrições
solutions	Contém 0 ou muitos elementos configsolutionfile que descrevem soluções a serem importadas.
filestoimport	Contém - 1 ou muitos configimportfile elementos - 0 ou muitos elementos zipimportdetails que descrevem arquivos individuais e arquivos zip a serem importados.
filesmapstoimport	Contém 1 ou muitos configimportmapfile elementos. A ordem dos arquivos do mapa neste elemento indica a ordem na qual eles são importados. Saiba mais sobre como criar mapas de dados para importação
cmtdatafiles	Contém 1 ou muitos cmtdatafile elementos que contêm versão localizada dos arquivos de dados de configuração a serem importados.

configsolutionfile elemento

Descreve as soluções para importação no elemento configdatastorage.solutions.

Atributos configsolutionfile

Name	Description
solutionpackagefilename	Obrigatório Especifique o nome do arquivo .zip da sua solução.
overwriteunmanagedcustomizations	Opcional Se deseja substituir quaisquer personalizações não gerenciadas ao importar uma solução que já existe no ambiente de destino. Se você não especificar esse comportamento, as personalizações não gerenciadas na solução existente serão mantidas no ambiente de destino.
publishworkflowsandactivateplugins	Opcional Se os fluxos de trabalho devem ser publicados e os plug-ins ativados no ambiente de destino após a importação da solução. Se você não especificar esse comportamento, o fluxo de trabalho será publicado e os plug-ins ativados.

configimportfile elemento

Descreve os arquivos para importação no elemento configdatastorage.filestoimport.

Atributos configimportfile

Name	Description
filename	Nome do arquivo que contém os dados de importação.
filetype	Este valor pode ser csv, xml ou zip. Se o arquivo for um arquivo .zip, um elemento zipimportdetails deve estar presente com um elemento zipimportdetail para cada arquivo no arquivo .zip.
associatedmap	Nome do mapa de dados de importação do Dataverse que será usado com este arquivo. Se estiver em branco, o Dataverse fará uma tentativa de usar o nome do mapa de dados de importação determinado pelo sistema para este arquivo.
importtoentity	Pode ser o nome do .exe no arquivo .zip, uma URL ou um arquivo .msi que fornece um link para invocar o final do processo.
datadelimiter	Nome do delimitador de dados usado no arquivo de importação. Os valores válidos são aspas simples ou duplas.
fielddelimiter	Nome do delimitador de campos usado no arquivo de importação. Os valores válidos são vírgula ou dois pontos, ou aspas simples.
enableduplicatedetection	Se as regras de detecção de duplicidades devem ser habilitadas durante a importação de dados. Os valores válidos são true ou false.
isfirstrowheader	Se a primeira linha do arquivo de importação contém os nomes dos campos. Os valores válidos são true ou false.
isrecordownerateam	Se o proprietário do registro da importação precisa ser uma equipe. Os valores válidos são true ou false.
owneruser	O ID de usuário que deve ser o proprietário dos registros. O valor padrão é o usuário atualmente conectado.
waitforimporttocomplete	Se true, o sistema aguarda a conclusão da importação antes de continuar. Se false, ele coloca os trabalhos na fila e continua.

zipimportdetails elemento

Descreve os arquivos zip a serem importados no elemento configdatastorage.filestoimport quando o configimportfile.filetype é zip.

Contem 1 ou mais elementos zipimportdetail elementos que fornecem informações sobre um arquivo individual dentro do arquivo zip especificado no configimportfile elemento.

zipimportdetail elemento

Fornece informações sobre um arquivo individual dentro do arquivo zip especificado no configimportfile elemento.

Atributos zipimportdetail

Name	Description
filename	Nome do arquivo que contém os dados de importação.
filetype	Este valor pode ser csv ou xml.
importtoentity	Pode ser o nome do .exe no arquivo .zip, uma URL ou um arquivo .msi que fornece um link para invocar o final do processo.

configimportmapfile elemento

Contém informações sobre um arquivo de mapa individual para importação no Dataverse.

Atributos configimportmapfile

Name	Description
filename	O nome do arquivo que contém os dados de mapeamento.

cmtdatafile elemento

Especifica os arquivos de dados de configuração localizados junto com o ID da localidade (necessário) e arquivo do mapa de informações do usuário (opcional).

Exemplo 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	O nome do arquivo que contém os dados de mapeamento.
lcid	A representação de cadeia de caracteres do identificador de código de idioma LCID.
usermapfilename	Somente para Dynamics 365 (on-premises). Contém o arquivo de mapa do usuário (.xml) gerado usando a Configuration Migration tool em seu projeto. Esse arquivo é necessário para importar as informações do usuário para uma instância do Dynamics 365 (on-premises) em um domínio diferente.