Criar mapas de dados para importação

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Para importar dados no Microsoft Dynamics 365, você deve fornecer os mapas de dados adequados.

Os exemplos dos mapas de dados podem ser encontrados no seguinte local no SDK: SDK\Resources\DataImportMaps\.Baixe o pacote do SDK do Microsoft Dynamics CRM.

Você usa mapas de dados para mapear os dados contidos no arquivo de origem para atributos da entidade de Microsoft Dynamics 365. Você deve mapear cada coluna no arquivo de origem para um atributo apropriado. Os dados nas colunas não mapeadas não são importados durante a operação de importação de dados.

O mapa de dados é representado pela entidade mapa de importação (mapa de dados). Você pode criar um novo mapa usando a mensagem de CreateRequest ou atualizar um mapa existente usando o método IOrganizationServiceUpdate. O mapa tem um nome exclusivo que é contido no atributo de ImportMap.Name. Você pode especificar o nome da fonte de importação para a qual esse mapa de dados é criado usando o atributo ImportMap.Source.

Neste tópico

Coluna, valor de lista e mapeamentos de pesquisa

Mapeamento de Proprietário

Anotações e anexos

Importe e exporte mapas de dados

Coluna, valor de lista e mapeamentos de pesquisa

Para mapear uma coluna, um valor de lista, ou valor de pesquisa no arquivo fonte para um atributo de Microsoft Dynamics 365, use os seguintes mapeamentos:

Mapeamento de Colunas

Mapeia uma coluna em um arquivo fonte para um atributo da entidade de Microsoft Dynamics 365. Para mapeamento de colunas, use a entidade do mapeamento de colunas (ColumnMapping). Você pode usar os relacionamentos 1:1 (um a um) ou 1:N (um para muitos) entre os atributos fonte e destino. Por exemplo, é possível mapear as informações de endereço de uma conta para endereços de cobrança e de entrega de um pedido.

Mapeamento de Valores da Lista

Mapeia um valor de lista em um arquivo fonte para um atributo de Microsoft Dynamics 365 do tipo OptionSetValue. Para mapeamento de valor de lista, use a entidade (PicklistMapping) de mapeamento de lista de seleções.

Se um valor especificado na coluna do arquivo fonte for um valor de lista, tal como um OptionSetValue, Status, Estado e Booleano, você deve fornecer um mapeamento de valor de lista para um mapeamento de colunas. Por exemplo, mapeie os valores na lista de "conta" e "entrega" no arquivo fonte para os valores de cobrança e entrega do tipo OptionSetValue.

Mapeamento de Consulta

Mapeia um valor de pesquisa em um arquivo fonte para um atributo de Microsoft Dynamics 365 do tipo EntityReference. Para mapeamento de pesquisa, use a entidade de mapeamento de pesquisas (LookupMapping).

Se o valor especificado no arquivo fonte fizer referência a uma entidade, você deve fornecer mapeamento de pesquisa para esse valor. Use o atributo do LookupMapping.LookupSourceCode para especificar se a pesquisa deve ser feita por entidade referenciada dentro do arquivo fonte ou dentro do Microsoft Dynamics 365. Se você estiver usando tipos de associação precoce, use a enumeração LookupSourceType para definir os valores de pesquisa. Para pesquisar em um arquivo fonte, use o valor de LookupSourceType.Source. Para pesquisar no Microsoft Dynamics 365, use o valor do LookupSourceType.System. Para obter uma lista dos valores LookupSourceCode, consulte os valores da lista de seleção dessa entidade.Para exibir os metadados de entidade da sua organização, instale a solução Navegador dos Metadados descrita em Procurar os metadados da sua organização. Também é possível exibir os metadados de uma organização não personalizada no arquivo do Excel chamado EntityMetadata.xlsx, incluído na pasta de nível superior do download do SDK. Você pode fornecer vários mapeamentos de pesquisa. O trabalho de transformação assíncrono processa todos os mapeamentos disponíveis. Ele localiza os registros referenciados e atualiza a tabela de análise com os identificadores únicos de registro. Para obter mais informações, consulte Executar importação de dados.

Mapeamento de Proprietário

Use o mapeamento de proprietário para mapear um usuário especificado no arquivo fonte para um usuário no Microsoft Dynamics 365. Para registrar as informações, use o nome de logon do usuário do Microsoft Dynamics 365. Para mapeamento do proprietário, use a entidade de mapeamento de proprietário (OwnerMapping).

Anotações e anexos

O mapeamento de anotações e anexos é tratado de maneira diferente de outras entidades. Anotações e anexos são usados para acrescentar as informações adicionais a um registro no Microsoft Dynamics 365. As informações são armazenadas como texto e os anexos são armazenados como arquivos no banco de dados do Microsoft Dynamics 365.

Para criar uma anotação no Microsoft Dynamics 365, defina o atributo de Annotation.IsDocument na entidade anotação (anotação) para false. Para criar um anexo, defina o IsDocument para true.

Use as seguintes configurações para anotações e anexos de mapeamento:

• Defina o atributo de ColumnMapping.SourceAttributeName para “true” ou “false”. O valor de “true" indica um anexo. O valor de “false” indica uma anotação.

• Defina o atributo de ColumnMapping.TargetAttributeName para IsDocument.

• Defina o atributo do ColumnMapping.ProcessCode para o valor do ImportProcessCode.Internal da enumeração ImportProcessCode caso você esteja usando tipos associados precocemente. Para obter uma lista dos valores ProcessCode, consulte os valores de lista de seleção dessa entidade.

Se os dados de origem representarem uma anotação, mapeie o texto da anotação para o atributo Annotation.NoteText. Se você estiver trabalhando com arquivos da força de venda, eles são geralmente armazenados no disco com números únicos de identificação. Para importar um anexo, você deve mapear um número de identificação de um arquivo contido no arquivo de origem para o atributo de Annotation.DocumentBody. O atributo de DocumentBody armazena os conteúdos do anexo.

O trabalho assíncrono de importação verifica a existência de mapeamentos com o nome do atributo de origem definido como “true” e “false” para revelar anotações e anexos. Se ele localizar um mapeamento de anexo, ele procura os arquivos especificados no disco e sobe o conteúdo do arquivo como anexo no Microsoft Dynamics 365. Caso um arquivo não seja encontrado, um erro é retornado.

Se você não fornecer um mapeamento para uma entidade de anotação (anotação), o trabalho de importação gera um mapeamento padrão da anotação.

Observação

O tamanho máximo de arquivos que podem ser carregados é determinado pela propriedade Organization.MaxUploadFileSize. Essa propriedade é definida na guia Email de Configurações do Sistema no aplicativo CRM. Essa configuração limita o tamanho dos arquivos que podem ser anexados às mensagens de email, às anotações e aos recursos da Web. A configuração padrão é 5 MB. No entanto, o tamanho de um anexo não pode exceder o tamanho máximo solicitado do HTTP (o padrão é 16MB). Para que as alterações passem a valer, reinicie o Serviços de Informações da Internet (IIS). Para isso, clique em Iniciar, Executar, digie iisreset, depois clique em OK.

Importe e exporte mapas de dados

Você pode exportar um mapa de dados existente para um arquivo XML e importar mapeamentos de dados XML no Microsoft Dynamics 365. Para exportar um mapa de dados do Microsoft Dynamics 365, use a mensagem ExportMappingsImportMapRequest. Para importar mapeamentos de dados XML e criar um mapa de dados no Microsoft Dynamics 365, use a mensagem ImportMappingsImportMapRequest.

Confira Também

Importar dados
Adicionar mapeamentos de transformação para importação
Adicionar mapeamentos de transformação para importação

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais