Criar e editar relacionamentos entre entidades

Publicado: fevereiro de 2017

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

Os relacionamentos de entidade definem como os registros podem ser relacionados entre si no banco de dados. No nível mais simples, adicionar um campo de pesquisa em uma entidade um novo relacionamento 1:N (um-para-muitos) entre duas entidades e que permite inserir esse campo de pesquisa em um formulário. Com o campo de pesquisa, os usuários podem associar vários registros “secundários” da entidade para um único registro de entidade "primário”.

Além de apenas definir como os registros podem estar relacionados a outros registros, o relacionamento de entidade 1:N também fornecem dados para abordar as seguintes perguntas:

• Quando excluo um registro, qualquer registro relacionado ao registro também será excluído?

• Ao atribuir um registro, também preciso atribuir todos os registros relacionados ao registro para o novo proprietário?

• Como posso simplificar o processo de entrada de dados ao criar um novo registro relacionado no contexto de um registro existente?

• Como as pessoas exibindo um registro podem exibir os registros associados?

As entidades podem também participar de um relacionamento N:N (muitos-para-muitos) onde qualquer quantidade de registros para duas entidades podem ser associada um com os outros.

Neste tópico

Decidir se deve usar relacionamentos de entidades ou conexões

Tipos de relacionamentos de entidade

Criar e editar relacionamentos 1:N

Campos de entidades de mapa

Criar e editar relações N:N (muitos para muitos)

Definir propriedades gerenciadas para relacionamentos

Decidir se deve usar relacionamentos de entidades ou conexões

Os relacionamentos de entidades são metadados que fazem alterações no banco de dados. Esses relacionamentos permitem que as consultas recuperem dados relacionados de forma muito eficaz. Use relacionamentos de entidades para definir relacionamentos formais que definem a entidade ou que a maioria dos registros pode usar. Por exemplo, uma oportunidade sem um cliente potencial não seria muito útil. A entidade Oportunidade também tem um relacionamento N:N com a entidade Concorrente. Isso permite que vários concorrentes sejam adicionados à oportunidade. Convém capturar esses dados e criar um relatório que mostre os concorrentes.

Há outros tipos menos formais de relacionamentos entre registros que são chamados de conexões. Por exemplo, pode ser útil saber se dois contatos são casados ou talvez que sejam amigos fora do trabalho ou talvez que um contato é usado para trabalhar para outra conta. A maioria dos negócios não gerará relatórios usando esse tipo de informação ou exigirá que seja inserido, portanto, provavelmente não vale a pena criar relacionamentos de entidades.

Tipos de relacionamentos de entidade

Ao consultar o gerenciador de soluções, você pode pensar que há três tipos de relacionamentos de entidades. Realmente há somente dois, conforme mostrado na seguinte tabela.

O tipo de relacionamento N:1 (muitos-para-um) existe na interface do usuário do gerenciador de soluções porque o gerenciador de soluções mostra uma exibição agrupada por entidades. Os relacionamentos 1:N realmente existem entre entidades e referem-se a cada entidade como Entidade Primária ou Entidade Relacionada. A entidade relacionada, às vezes chamada de entidade secundária, tem um campo de pesquisa que permite armazenar uma referência a um registro da entidade primária, às vezes chamada de entidade principal. Um relacionamento N:1 é apenas um relacionamento 1:N exibido na perspectiva da entidade relacionada.

Criar e editar relacionamentos 1:N

A maneira mais fácil de criar um relacionamento 1:N é criar um novo campo de pesquisa para uma entidade. Isso permite definir os valores do campo comum para o campo de pesquisa, assim como duas opções adicionais ao definir Tipo para Pesquisa. Esses campos são Tipo de Registro de Destino e Nome do Relacionamento.

Tipo de Registro de Destino seleciona a Entidade Primária no relacionamento 1:N. O Nome do Relacionamento é gerado automaticamente com base nas duas entidades que participam do relacionamento. Você normalmente não precisa editar, mas pode se desejar. O nome do relacionamento de entidades contém o prefixo de personalização do fornecedor da solução para a solução que você está trabalhando no momento.

No entanto, ao criar um relacionamento 1:N criando um campo de pesquisa, determinados valores padrão são definidos para você. Se quiser editar algumas das opções disponíveis no relacionamento, você deverá localizar o relacionamento e editá-lo.

Relacionamentos 1:N personalizados não podem ser criados para todas as entidades. Quando isso for verdadeiro, não haverá nenhuma opção para criar um novo relacionamento de entidade personalizado usando o gerenciador de soluções. Se você usar o navegador de metadados, é possível filtrar a lista de entidades de acordo com as propriedades CanBePrimaryEntityInRelationship e CanBeRelatedEntityInRelationship . Consulte Usar o navegador de metadados para obter mais informações.

A definição do relacionamento 1:N tem quatro partes: Definição do Relacionamento, Campo de Pesquisa, Item do Painel de Navegação para a Entidade Principal e Comportamento do Relacionamento.

Criar ou editar relacionamentos 1:N entre entidades

1. Vá para Configurações > Personalizações.

2. Clique em Personalizar o Sistema.

3. Em Componentes, expanda Entidades e expanda a entidade com a qual você deseja trabalhar.

4. Clique em Relacionamentos 1:N.

5. Para editar um relacionamento ou exibir seus detalhes, selecione esse relacionamento e, em barra de ferramentas Ações, clique em Mais Ações e em Editar.

   - OU -

   Para adicionar um novo relacionamento, clique no botão Nova Relação Um-para-Muitos.

   Importante

   Se Novo Relacionamento 1-to-Many não aparecer na barra de ferramentas Ações, você não pode criar um relacionamento 1:N para a entidade.

6. Para um novo relacionamento, na seção Definição do Relacionamento, na lista Entidade Relacionada, selecione a entidade a ser relacionada.

   Dica

   Especificar conjuntos de entidade relacionados define um valor padrão do campo Nome. Se você alterar a entidade relacionada antes de salvar, o valor de Nome será alterado da mesma forma.

7. Selecione se isso será pesquisável.

8. Na seção Campo de Pesquisa, especifique um valor para o campo Nome para Exibição.

   Importante

   Especificar Nome de Exibição define um valor padrão para o campo Nome. Se você alterar o Nome de Exibição do campo de pesquisa antes de salvar, o valor no campo Nome não será alterado. Como resultado, certifique-se de que o Nome é significativo antes de salvar.

9. Na lista Requisito do Campo, escolha uma opção para especificar os requisitos de dados para o campo antes de salvar um registro.

10. Na seção Item do Painel de Navegação para Entidade Principal, na lista Opção de Exibição, escolha uma opção para mostrar exibições associadas ou uma etiqueta personalizada.

11. Na seção Comportamento do Relacionamento, na lista Tipo de Comportamento, escolha uma das seguintes opções:

    • Primário. Em um relacionamento primário entre duas entidades, todas as ações executadas em um registro da entidade primária também são executadas em todos os registros da entidade primária (ou pai) relacionados.

    • Referencial. Em um relacionamento referencial entre duas entidades, é possível navegar até qualquer entidade relacionada, mas as ações executadas em uma delas não afetarão a outra.

    • Referencial, Exclusão Restrita. Em um relacionamento de exclusão restrita, referencial entre duas entidades, você pode navegar até qualquer registro relacionado. As ações executadas no registro primário não serão aplicadas ao registro secundário, mas o registro primário não poderá ser excluído enquanto o registro secundário existir. Observe que não é possível excluir um registro quando há registros relacionados.

    • Cascata Configurável. Em um relacionamento em cascata configurável entre duas entidades, você seleciona o comportamento associado a cada de um conjunto de ações possíveis.

      Importante

      Se você definir os comportamentos para as ações para que eles correspondam os comportamentos das ações associadas com outro Tipo de Comportamento, ao salvar o relacionamento, o Tipo de Comportamento é definido automaticamente para o tipo correspondente.

    Para obter mais informações:MSDN: Configurar o comportamento do relacionamento entre entidades

12. Clique em Salvar e Fechar para fechar o formulário Relacionamento.

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

    • Para publicar personalizações somente para o componente que você está editando no momento, na barra de ferramentas Ações, clique em Publicar.

    • Para publicar personalizações de todos os componentes não publicados de uma vez, na barra de navegação ou no Painel de Navegação, clique em Entidades e, na barra de ferramentas Ações, clique em Publicar Todas as Personalizações.

Definição do relacionamento

Dependendo da escolha para criar um Novo Relacionamento 1-para-Muitos ou um Novo Relacionamento Muitos-para-1 no gerenciador de soluções, os campos Entidade Primária ou Entidade Relacionada serão preenchido previamente. É necessário apenas escolher outro. Um valor padrão para o campo Nome é preenchido previamente com base no prefixo de personalização do fornecedor de soluções e nos nomes das entidades que você optar por participar do relacionamento. Você poderá editar se desejar. Se você criar mais de um relacionamento personalizado entre duas entidades e usar o mesmo prefixo de personalização em ambos, o valor de nome gerado automaticamente não será exclusivo e não será possível salvar o novo relacionamento. É preciso editar o nome para diferenciá-lo de qualquer nome existente antes de salvar. Depois de salvo, não é possível alterá-lo.

Se você não deseja o relacionamento da entidade visível na Localização Avançada, defina o valor Pesquisável para Não.

Campos de pesquisa

Esses campos são propriedades comuns que todos os campos têm, exceto Pesquisável, Segurança do Campo e Auditoria. Para editar esses valores no campo de pesquisa criado com o relacionamento de entidades, é preciso localizar e editar o campo de pesquisa separadamente depois de criar o relacionamento de entidades.Para obter mais informações:Criar e editar campos

Como regra geral, o Nome de Exibição deve corresponder ao nome de exibição da entidade primária.

Item do painel de navegação para entidade principal

A entidade principal pode revelar uma lista de entidades relacionadas se você expandir o painel de navegação. As opções desse grupo controlam como ou onde exibir essa lista. Esses itens de navegação também podem ser editados usando o editor de formulários e, ao usar o JavaScript, um desenvolvedor pode aplicar alterações nos itens quando o formulário for exibido.

Comportamento de relacionamentos

Em um relacionamento 1:N, você pode controlar o modo como o relacionamento se comporta para oferecer suporte às regras de negócios da sua organização. Porque você deseja fazer isso? Vamos ver um exemplo.

Vamos dizer que você tenha um novo vendedor e deseja atribuir uma variedade de oportunidades existentes atualmente atribuídas a outro vendedor. Cada registro de oportunidade pode ter uma variedade de atividades de tarefa associadas a ele. É fácil localizar as oportunidades ativas que você deseja reatribuir e atribuir novamente ao novo vendedor. Mas o que deve ocorrer para qualquer atividade de tarefa associada às oportunidades? Deseja abrir cada tarefa e decidir se também devem ser atribuídas ao novo vendedor? Provavelmente não. Em vez disso, você pode permitir que o relacionamento aplique algumas regras padrão para você automaticamente. Essas regras são aplicáveis apenas para registros de tarefas associados às oportunidades que você está reatribuindo. O relacionamento de entidades é chamado Tarefas de Oportunidade. Suas opções são:

• Reatribuir todas as tarefas ativas.

• Reatribuir todas as tarefas. Esse é o comportamento padrão.

• Não reatribuir nenhuma das tarefas.

• Reatribua todas as tarefas atualmente atribuídas ao antigo proprietário da oportunidade.

O relacionamento pode controlar o modo como as ações executadas em um registro do registro da entidade principal são propagadas para todos os registros de entidade relacionadas. Os comportamentos e as ações possíveis são mostrados na seguinte tabela.

Cada uma dessas ações poderá ser configurada para controlar o modo como as ações são propagadas para os registros relacionados ao registro de entidade principal através do relacionamento de entidade 1:N. As opções de comportamento são exibidas na tabela a seguir.

Como as ações são aplicadas em um relacionamento, pode ser categorizadas ou aplicadas usando os valores de campo Tipo de Comportamento descrito na seguinte tabela.

Limitações nos comportamentos que você pode definir

Há algumas limitações que você deve saber ao definir relacionamentos de entidades.

• Uma entidade personalizada não pode ser a entidade primária em um relacionamento com uma entidade do sistema relacionada disposta em cascata. Isso significa que não pode haver um relacionamento com nenhuma ação definida como Todos em Cascata, Ativos em Cascata ou Propriedade do Usuário em Cascata entre uma entidade principal personalizada e uma entidade do sistema relacionada.

• Nenhum novo relacionamento poderá ter ações definidas como Todos em cascata, Ativos em cascata ou Do usuário - cascatase a entidade relacionada nesse relacionamento já existir como entidade relacionada em outro relacionamento que tenha ações definidas como Todos em cascata, Ativos em cascata ou Do usuário - cascata. Isso evita relacionamentos que criam outros relacionamentos com vários níveis superiores.

Campos de entidades de mapa

É 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 navegar apenas para Vendas > Contatos e 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 usar a subgrade Contatos no formulário, clicando em + 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, é possível clicar em 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.

O Padronizar mapeamentos de entidade e atributos mostra todos os mapeamentos padrões definidos para o Microsoft Dynamics 365.

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.

Criar ou editar mapeamentos entre campos

1. Vá para Configurações > Personalizações.

2. Clique em Personalizar o Sistema.

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

4. Clique em Relacionamentos 1:N ou Relacionamentos N:1.

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

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

7. Em Associada, clique em Mapeamentos.

8. Para cada novo mapeamento, na barra de ferramentas Ações, clique em Novo.

9. 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.

10. Clique em OK.

11. Clique em Salvar e Fechar para fechar o formulário Relacionamento.

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

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 e editar relações N:N (muitos para muitos)

Os relacionamentos de entidade 1:N estabelecem uma hierarquia entre registros. Com relacionamentos N:N (muitos-para-muitos) não há nenhuma hierarquia explícita. Não há um campo de pesquisa ou comportamentos para configurar. Registros criados usando um relacionamento N:N podem ser consideradas pares e o relacionamento é recíproco.

Com relacionamentos N:N, uma entidade especial é criada chamada Relationship (ou entidade Intersect). A entidade tem um relacionamento com a cada uma das entidades relacionadas e armazena apenas os valores necessários para definir o relacionamento. Não é possível adicionar campos personalizados à entidade de relacionamento.

O procedimento para criar um relacionamento N:N é basicamente escolher as duas entidades que você deseja que participem do relacionamento e, para cada entidade, definir como você deseja que as respectivas listas estejam disponíveis no painel de navegação do formulário para cada entidade. Estas são as mesmas opções usadas para a entidade principal em relacionamentos de entidade 1:N.Para obter mais informações:Item do painel de navegação para entidade principal

Nem todas as entidades podem ser usadas com relacionamentos N:N. Se o botão Novo Relacionamento Muitos-para-Muitos não estiver presente, não é possível criar um novo relacionamento N:N com essa entidade. Se você usar o navegador de metadados, é possível filtrar as entidades com o valor de true definido para CanBeInManyToMany.Para obter mais informações:Usar o navegador de metadados

Criar ou editar relacionamentos N-N entre entidades

1. Vá para Configurações > Personalizações.

2. Clique em Personalizar o Sistema.

3. Em Componentes, expanda Entidades e expanda a entidade com a qual você deseja trabalhar.

4. Clique em Relacionamentos N:N.

5. Para editar ou exibir os detalhes de um relacionamento existente, selecione o relacionamento e, na barra de ferramentas Ações, clique em Ações e em Editar.

   -OU-

   Para adicionar um novo relacionamento, clique em Novo Relacionamento Muitos-para-Muitos.

   Importante

   Se Novo Relacionamento Many-to-Many não aparecer na barra de ferramentas Ações, você não pode criar um relacionamento N:N para a entidade.

6. Para um novo relacionamento, na seção Entidade Atual, na lista Opção de Exibição, escolha uma das seguintes opções:

   • Não Exibir: a outra entidade não mostrará uma exibição associada para a entidade atual.

   • Usar Etiqueta Personalizada: essa etiqueta será usada para a exibição associada criada para a outra entidade. Certifique-se de inserir um valor correspondente no campo Etiqueta Personalizada.

   • Usar Nome no Plural: essa opção usará o nome no plural da entidade atual para a exibição associada.

   Dica

   Quando as opções Usar Nome no Plural ou Usar Etiqueta Personalizada estão selecionadas, você pode escolher na lista de opções Área de Exibição para especificar a área de exibição (por exemplo, Marketing ou Vendas) no formulário onde a etiqueta do relacionamento será exibido. Também é possível pode especificar Ordem de Exibição para controlar onde o rótulo será incluído na área de exibição selecionada.

   Importante

   O paradigma de navegação nos formulários associados às entidades atualizadas é significantemente diferente do que para entidades que ainda não foram atualizadas. Embora a mecânica para definir a Área de Exibição e a Ordem de Exibição seja comum, certifique-se de entender os vários paradigmas de navegação enquanto estabelece relacionamentos entre entidades.

7. Na seção Outra Entidade, selecione a outra entidade na lista Nome da entidade.

   Dica

   Ao especificar o nome da entidade, os valores padrão são definidos para os campos Nome e Nome da Entidade de Relacionamento na seção Definição do Relacionamento. Se você alterar o valor de Nome da Entidade antes de salvar, esses nomes não serão alterados. Portanto, certifique-se de que esses nomes sejam significativos antes de salvar.

8. Na seção Definição da Relação, confirme Nome. e Nome da Entidade do Relacionamento.

   Esses valores devem ser exclusivos entre os relacionamentos N:N.

9. Clique em Salvar e Fechar para fechar o formulário Relacionamento N:N.

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

    • Para publicar personalizações somente para o componente que você está editando no momento, na guia Início, no grupo Salvar, clique em Publicar.

    • Para publicar personalizações para todos os componentes não publicados de uma vez, clique em Publicar Todas as Personalizações.

    Dica

    A qualquer momento que você alterar elementos da interface do usuário ou implementar scripts de formulário de uma entidade, será necessário publicar as alterações para aplicá-las. Todas as personalizações que modificarem o esquema de dados do Microsoft Dynamics 365, como entidades, relacionamentos ou campos personalizados serão aplicadas imediatamente.

    A instalação de uma solução ou a publicação de personalizações pode interferir na operação normal do sistema. É recomendável que você agende uma importação de solução quando isso for menos prejudicial aos usuários.

Definir propriedades gerenciadas para relacionamentos

O Propriedades gerenciadas se aplica somente ao incluir um campo com uma solução gerenciada e importá-lo para outra organização. Essas configurações permitem que um desenvolvedor de soluções tenha algum controle sobre o nível de personalização que deseja para permitir que os usuários instalem sua solução gerenciada ao personalizar um relacionamento de entidade. Para definir as propriedades para um relacionamento, clique no botão Propriedades Gerenciadas na barra de menus.

Com relacionamentos, a única propriedade gerenciada é Pode ser Personalizado. Essa configuração única controla todas as alterações que podem ser feitas no relacionamento de entidades.

Confira Também

Criar e editar metadados
Criar e editar entidades
Criar e editar campos
Criar e editar conjuntos de opções globais
Relacionamentos primários entre entidades personalizáveis
Padronizar mapeamentos de entidade e atributos

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais