Compartilhar via

Referência ImportConfig

  • Artigo

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.

Elemento configdatastorage

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 exemplo
- Adicionar e remover dados de exemplo 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.

Elemento configsolutionfile

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

Atributos configsolutionfile

Name Description
solutionpackagefilename Obrigatório especifique o nome de arquivo .zip da sua solução.
overwriteunmanagedcustomizations Opcional especifique se as personalizações não gerenciadas devem ser substituídas ao importar uma solução já existente 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 se os plug-ins devem ser 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.

Elemento configimportfile

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.

Elemento zipimportdetails

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.

Elemento zipimportdetail

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.

Elemento configimportmapfile

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.

Elemento cmtdatafile

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.