Compartilhar via


Criar ou editar mapeamentos entre campos da entidade

Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Mapear colunas da tabela

É 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. Vamos dizer que você deseja adicionar um novo registro de contato para uma pessoa que seja um funcionário de uma conta específica. É possível fazer isso de duas maneiras diferentes.

Você pode simplesmente navegar no aplicativo para criar um novo registro de contato do zero. Mas quando você precisa definir a conta principal e inserir vários itens de informações (como informações de endereço e telefone), que é provavelmente igual à conta principal. Isso pode ser demorado e introduz oportunidades de erros.

A maneira mais fácil é começar com a entidade de conta e, usando a subgrade Contatos no formulário, selecionar + para adicionar um contato. Conduzirá primeiro para pesquisar todos os contatos relacionados existentes para que não acidentalmente crie um registro duplicado. Se você não encontrar um registro existente, poderá selecionar Novo e criar um novo registro de contato. A diferença é que determinados itens de dados do registro da conta serão copiados para o novo formulário de contato para definir determinados valores padrão que você pode editar antes de salvar. Isso pode economizar bastante tempo quando ao inserir dados e ajudar a reduzir erros.

Observação

Esses mapeamentos não são aplicados aos registros relacionados criados usando um fluxo de trabalho ou processo de caixa de diálogo. Eles não são aplicados automaticamente a novos registros criados usando o código, embora os desenvolvedores possam usar uma mensagem especial chamada InitializeFrom para criar um novo registro usando os mapeamentos disponíveis.

Esses mapeamentos definem somente os valores padrão para um registro antes de salvar. As pessoas podem editar valores antes de salvar. Os dados transferidos são os dados nesse momento. Não serão sincronizados. Se as informações no registro de entidade principal forem alteradas, os dados do registro de entidade relacionado transferidos quando foram criados quando não serão alterados.

Os valores padrão definidos ao criar um novo registro em uma lista não são definidos em um relacionamento de entidades, mas são expostos na interface do usuário de relacionamento. Nem todos os relacionamentos de entidade 1:N os possui. Ao exibir uma lista de relacionamentos de entidade 1:N (ou N:1) para uma entidade, você pode filtrar os relacionamentos exibidos por tipo. Você pode selecionar Todos, Personalizado, Personalizável ou Mapeável. Os relacionamentos de entidades mapeáveis oferecem acesso para permitir o mapeamento dos campos da entidade.

As seguintes regras mostram que tipos de dados podem ser mapeados.

  • Os dois campos devem ser do mesmo tipo e ter o mesmo formato.

  • O tamanho do campo de destino deve ser igual a ou maior que o campo de origem.

  • Ainda não é possível mapear o campo de destino para outro campo.

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

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

  • Se os campos forem conjuntos de opções, os valores inteiros de cada opção deverão ser idênticos.

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

Observação

Se for necessário mapear campos do conjunto de opções, recomendamos configurar ambos os campos para usar o mesmo conjunto de opções globais. Caso contrário, pode ser difícil manter dois conjuntos separados de opções sincronizados manualmente. Se os valores inteiros de cada opção não são mapeados corretamente, você poderá ter problemas nos seus dados. Mais informações: Criar e editar conjuntos de opções globais

Criar ou editar mapeamento de campo

  1. Abra o gerenciador de soluções.

  2. Em Componentes, expanda Entidades e depois expanda a entidade desejada.

  3. Selecione Relacionamentos 1:N ou Relacionamentos N:1.

  4. No painel principal, na lista Tipo, selecione Mapeável.

  5. Selecione um relacionamento que possa ser mapeado. Em seguida, na barra de ferramentas Ações, selecione Ações e Editar.

  6. Em Relacionado, selecione Mapeamentos.

  7. Para cada novo mapeamento, na barra de ferramentas Ações, selecione Novo.

  8. Na caixa de diálogo Criar Mapeamento de Campos, selecione o campo de origem em Campos da Entidade de Origem. Selecione o campo de destino em Campos da Entidade de Destino.

  9. Selecione OK.

  10. Selecione Salvar e Fechar para fechar o formulário Relacionamento.

  11. Quando suas personalizações estiverem concluídas, publique-as

Observação

  • Após a publicação das personalizações, esses mapeamentos ficarão disponíveis para todos os usuários. Se você redefinir o IIS (Serviços de Informações da Internet) antes de publicar as personalizações, esses mapeamentos ficarão disponíveis para todos os usuários, mesmo que outras personalizações não estejam disponíveis.
  • Se você mapear de/para um campo não exibido em um formulário, o mapeamento não poderá ser feito enquanto o campo não for adicionado a um formulário.

Gerar mapeamentos do campo automaticamente

Você também pode gerar mapeamentos automaticamente, mas deve ter cuidado ao fazer isso com entidades do sistema. Use isso ao criar entidades personalizadas e quando desejar aproveitar o mapeamento. Ao exibir a lista de mapeamentos, no menu Mais Ações, selecione Gerar Mapeamentos. Isso remove todos os mapeamentos existentes e substitui com os mapeamentos sugeridos com base somente nos campos com nomes e tipos de dados semelhantes. Se você usar isso em uma entidade do sistema, é possível perder alguns mapeamentos esperados. Para entidades personalizadas, ajuda a economizar tempo porque você excluir mais facilmente qualquer mapeamento que não deseja e adicionar outros que a ação de geração de mapeamentos não criou.

Criar relacionamentos 1:N (um para muitos) ou N:1 (muitos para um)
Criar relacionamentos N:N (muitos para muitos)