Personalizar mapeamentos de entidade e atributos

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

É possível mapear atributos entre entidades que possuem um relacionamento de entidades. Isso permite que você defina valores padrão para um registro criado no contexto de outro registro. Use as ferramentas de personalização no aplicativo para mapear atributos. Consulte os tópicos TechNet: personalizar o seu sistema CRMTechNet: criar e editar relacionamentos de entidades: Mapeando campos de entidades. Consulte a seção Mapeando campos de entidades para obter mais informações.

Consulte TechNet: mapeamentos de entidades e atributos para ver uma tabela que mostra os mapeamentos padrão de entidades e campos do sistema.

Neste tópico

Comportamento no aplicativo

Usando dados de mapeamentos de entidade e atributos

Automapeamento de atributos entre entidades

Recuperar mapeamentos de entidade e atributos

Comportamento no aplicativo

O mapeamento em Microsoft Dynamics 365 simplifica a entrada de dados quando você cria novos registros associados a outro registro. Quando uma entidade tiver um relacionamento de entidades com outra entidade, você pode criar novos registros de entidade relacionados usando a guia ///Criar relacionado na faixa de opções. Quando você cria um novo registro desta maneira, os dados mapeados a partir do registro primário de entidade são copiados para o formulário para o novo registro de entidade relacionado. Mapeando os atributos da entidade, você controla quais dados são copiados adicionando novos mapeamentos no relacionamento entre as duas entidades. Se você criar um registro de qualquer maneira diferente da visão associada da entidade primária, os dados não serão mapeados.

Por exemplo, você pode querer configurar um mapeamento entre os campos de endereço nas contas e os campos de endereço nos contatos. Com esse mapeamento, quando um usuário adiciona um contato associado a uma conta específica, os campos de endereço do contato são preenchidos automaticamente.

Você pode mapear um atributo para vários atributos de destino. Por exemplo, é possível mapear as informações de endereço em uma conta para os endereços de cobrança e de entrega em um pedido.

O mapeamento é aplicado antes que um registro novo e relacionado seja criado. Os usuários podem fazer alterações antes de salvar o registro. As alterações posteriores nos dados do registro principal não são aplicadas ao registro relacionado.

Usando dados de mapeamentos de entidade e atributos

Ao criar novos registros no contexto de um registro existente no qual exista um mapeamento entre as entidades, você pode usar a mensagem InitializeFromRequest para configurar um novo registro que contenha os valores especificados no mapeamento. Você pode então usar o método IOrganizationService.Create para salvar o registro. Dessa forma, todos os mapeamentos que você definir são aplicados.

Mapas válidos de entidade são criados quando um relacionamento entre entidades é criado. Use o relacionamento de entidades entity_map_attribute_maps para recuperar os mapas de atributos das duas entidades especificadas no mapa de entidade.

Você pode criar ou atualizar registros do mapa do atributo. Os requisitos a seguir devem ser cumpridos para os mapas do atributo:

• O tipo AttributeMetadata deve coincidir.

• O tamanho do campo de destino não pode ser menor que o campo de origem.

• O formato deve coincidir.

• O campo de destino não deve ser usado em outro mapeamento.

• O campo de origem deve ficar visível no formulário da entidade.

• O campo de destino deve ser um campo no qual o usuário possa inserir dados.

• Os valores ID de Endereço não podem ser mapeados.

• Atributos PartyList, onde AttributeMetadata.AttributeType é AttributeTypeCode.PartyList não podem ser mapeados.

Automapeamento de atributos entre entidades

Você pode editar mapeamentos de atributos entre entidades para os relacionamentos de entidades que suportam mapeamento.

Além de criar cada mapa de atributo manualmente, você pode usar a mensagem AutoMapEntityRequest para gerar um novo conjunto de mapeamentos de atributo. Esta mensagem executa a ação localizada na opção de menu Gerenciar mapeamentos no menu Mais Ações na barra de ferramentas. Esta mensagem mapeia todos os atributos entre as duas entidades relacionadas onde os nomes e tipos do atributo são idênticos. A mensagem é fornecida como uma melhoria de produtividade para que você não precise adicionar manualmente todos os mapeamentos de atributo. Ao invés disso, você pode gerar um conjunto de mapeamentos prováveis e minimizar a quantidade de trabalho manual para adicionar ou remover mapeamentos individuais a fim de atender seus requisitos.

Observação

Gerar automaticamente mapeamentos dessa forma removerá todos os mapeamentos de atributo definidos anteriormente e pode incluir os mapeamentos que você não deseja.

Recuperar mapeamentos de entidade e atributos

Uma maneira fácil de ver os mapeamentos que foram criados é usar a consulta FetchXML a seguir. Para obter mais informações sobre como executar esta consulta, consulte Use FetchXML para criar uma consulta.

<fetch version='1.0' mapping='logical' distinct='false'>
   <entity name='entitymap'>
      <attribute name='sourceentityname'/>
      <attribute name='targetentityname'/>
      <link-entity name='attributemap' alias='attributemap' to='entitymapid' from='entitymapid' link-type='inner'>
         <attribute name='sourceattributename'/>
         <attribute name='targetattributename'/>
      </link-entity>
   </entity>
 </fetch>

Confira Também

Usar o serviço da Organização com metadados do Dynamics 365
Mensagens e métodos da entidade EntityMap
Mensagens e métodos da entidade AttributeMap
TechNet: criar e editar relacionamentos de entidades: Mapeando campos de entidades

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais