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.