Partilhar via

Referência ImportConfig

O ficheiro ImportConfig.xml utilizado com o Package Deployer contém informações sobre as soluções e os dados a importar. Segue-se um exemplo:

<?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 secções a seguir fornecem detalhes sobre os atributos e elementos XML válidos para este documento.

configdatastorage elemento

configdatastorage é o elemento raiz.

Atributos configdatastorage

Todos estes atributos são opcionais.

Nome Descrição
installsampledata Se instalar dados de amostra. Estes são os mesmos dados de amostra instalados através destes 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 estiver definido como true, aguarde a instalação dos dados de amostra antes de implementar o pacote. Não defina isto como true quando installsampledata é false.
agentdesktopzipfile O nome de ficheiro do ficheiro zip a descompactar. Se especificar um nome de ficheiro .zip aqui, adiciona um ecrã durante o processo de implementação do pacote que lhe pede para selecionar uma localização onde pretende desempacotar o conteúdo do ficheiro.

Este atributo é utilizado frequentemente para criar pacotes para o Unified Service Desk para Dynamics 365.
agentdesktopexename Nome do ficheiro .exe ou .msi no ficheiro zip ou um URL para ser invocado no final do processo de implementação.

Este atributo é utilizado frequentemente para criar pacotes para o Unified Service Desk para Dynamics 365.
crmmigdataimportfile Nome de ficheiro do ficheiro de dados de configuração predefinido (.zip) exportado através da Ferramenta de Migração da Configuração.

Elementos configdatastorage

Estes são os elementos subordinados válidos:

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

configsolutionfile elemento

Descreve soluções a para importar no elemento configdatastorage.solutions.

Atributos configsolutionfile

Nome Descrição
solutionpackagefilename Obrigatório Especifique o nome de arquivo .zip da sua solução.
overwriteunmanagedcustomizations Opcional Substituir quaisquer personalizações não gerenciadas ao importar uma solução que já existe no ambiente de destino. Se não especificar este comportamento, as personalizações não geridas na solução existente são mantidas no ambiente de destino.
publishworkflowsandactivateplugins Opcional: publicar fluxos de trabalho e ativar plug-ins 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 ficheiros a para importar no elemento configdatastorage.filestoimport.

Atributos configimportfile

Nome Descrição
filename Nome do ficheiro que contém os dados de importação.
filetype Este valor pode ser csv, xml ou zip. Se o ficheiro for um ficheiro .zip, tem de estar presente um elemento zipimportdetails com um elemento zipimportdetail para cada ficheiro no ficheiro .zip.
associatedmap Nome do mapa de dados de importação do Dataverse a utilizar com este ficheiro. Se estiver em branco, o Dataverse tenta utilizar o nome do mapa de dados de importação determinado pelo sistema para este ficheiro.
importtoentity Pode ser o nome do exe no ficheiro zip, um URL ou um ficheiro .msi para fornecer uma ligação para invocar no final do processo.
datadelimiter Nome do delimitador de dados utilizado no ficheiro de importação. Os valores válidos são plica ou aspas.
fielddelimiter Nome do delimitador de campos utilizado no ficheiro de importação. Os valores válidos são vírgula ou dois pontos, ou plica.
enableduplicatedetection Se são ativadas as regras de deteções de duplicados na importação de dados. Os valores válidos são true ou false.
isfirstrowheader Se a primeira linha do ficheiro de importação contém os nomes de campos. Os valores válidos são true ou false.
isrecordownerateam Se o proprietário do registo na importação deve ser uma equipa. Os valores válidos são true ou false.
owneruser Se o ID de utilizador que deve ser proprietário dos registos. O valor predefinido é o utilizador com sessão atualmente iniciada.
waitforimporttocomplete Se true, o sistema aguarda a conclusão da importação antes de prosseguir. Se false, coloca as tarefas em fila e prossegue.

zipimportdetails elemento

Descreve os ficheiros zip a importar no elemento configdatastorage.filestoimport quando o configimportfile.filetype é zip.

Contém 1 ou mais elementos zipimportdetail que fornecem informações sobre um ficheiro individual no ficheiro .zip especificado no elemento configimportfile.

zipimportdetail elemento

Forneça informações sobre um ficheiro individual no ficheiro .zip especificado no elemento configimportfile.

Atributos zipimportdetail

Nome Descrição
filename Nome do ficheiro que contém os dados de importação.
filetype Este valor pode ser csv ou xml.
importtoentity Pode ser o nome do exe no ficheiro zip, um url ou um ficheiro .msi para fornecer uma ligação para invocar no final do processo.

configimportmapfile elemento

Contém informações sobre um ficheiro de mapa individual para importar no Dataverse.

Atributos configimportmapfile

Nome Descrição
filename O nome do ficheiro que contém os dados de mapeamento.

cmtdatafile elemento

Especifica os ficheiros de dados de configuração localizados, juntamente com o ID de região (obrigatório) e o ficheiro do mapa de informações do utilizador (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 cmtdatafile

Nome Descrição
filename O nome do ficheiro que contém os dados de mapeamento.
lcid A representação da cadeia do identificador de código de idioma LCID.
usermapfilename Apenas para o Dynamics 365 (on-premises). Contém o ficheiro de mapa de utilizador (.xml) gerado utilizando a Configuration Migration Tool no seu projeto. Este ficheiro é necessário para importar informações de utilizador para uma instância do Dynamics 365 (on-premises) num outro domínio.
  • Last updated on