Descreva um relacionamento entre entidades com funções de conexão

Publicado: janeiro de 2017

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

É possível descrever a relação entre registros por meio das funções que você atribui a eles.

Há várias maneiras de usar as funções de conexão em uma conexão:

Aplique a mesma função ao registro de origem e ao registro de destino. Um "amigo", um "membro da equipe” ou um "colega" são exemplos das funções que podem ser aplicadas aos dois registros na conexão.
Aplique uma função ao registro de origem ou ao registro de destino, mas não a ambos. A função de um “vendedor” em um contato com a conexão da oportunidade é um exemplo de tal função. Os registros, como oportunidade, fatura ou pedidos de venda, geralmente contêm informações sobre o que eles representam e não exigem uma função atribuída a eles.
Aplicar duas funções correspondentes (às vezes chamadas de funções recíprocas). Uma função se aplica a um registro de origem e outra função se aplica a um registro de destino. Um "médico" e um "paciente, um "pai" e um "filho" são exemplos de funções correspondentes.

Categorias da função de conexão

Ao criar funções de conexão, é possível especificar a qual categoria elas pertencem. Por exemplo, você pode usar as categorias a seguir:

A lista de categorias pode ser personalizada. Você pode adicionar as categorias que atendem melhor ao seu modelo de negócios.

Para criar uma função de conexão, especifique as seguintes informações:

Utilize o atributo ConnectionRole.Name para especificar o nome de uma função.
Utilize o atributo ConnectionRole.Description para adicionar a descrição de uma função.
Utilize o atributo ConnectionRole.Category para especificar a categoria de uma função. Os valores possíveis desse atributo são definidos no conjunto de opções global Categoria (connectionrole_category).
Ao criar uma função de conexão, você pode especificar um tipo de entidade ao qual a função será aplicada, como cliente potencial (lead), conta ou concorrente. Se não especificar um tipo específico de entidade, você poderá aplicar uma função de conexão a todas as entidades do Microsoft Dynamics 365. Para especificar o tipo de entidade, utilize o atributo ConnectionRoleObjectTypeCode.AssociatedObjectTypeCode. Para vincular a função de conexão a um tipo específico de entidade, utilize o atributo ConnectionRoleObjectTypeCode.ConnectionRoleId. Um registro da função de conexão pode ser referenciado por diversos registros de código do tipo do objeto da função. Se remover todas as referências do registro da função de conexão, você poderá aplicar essa função de conexão a todas as entidades do Microsoft Dynamics 365.

Dica

Para localizar as funções de conexão de uma entidade de conta, especifique na consulta todas as funções vinculadas à entidade de conta (código do tipo de entidade = 1) ou a todas as entidades (código do tipo de entidade = 0).

Para associar as funções na conexão, utilize o método de Associate. Para desassociar as funções, utilize o método de Disassociate. Para obter mais informações sobre as mensagens Associate e Disassociate, consulte Introdução às entidades no Microsoft Dynamics 365.

Microsoft Dynamics 365