Décrire une relation entre des entités avec des rôles de connexion

Vous pouvez décrire la relation entre des enregistrements via les rôles que vous leur attribuez.

Vous pouvez utiliser les rôles de connexion dans une connexion de plusieurs façons :

• Appliquez le même rôle à l’enregistrement source et à l’enregistrement cible. Un « ami », un « membre de l’équipe » ou un « collègue » sont des exemples de rôles pouvant être appliqués aux deux enregistrements de la connexion.

• Appliquez un rôle à l’enregistrement source ou à l’enregistrement cible, mais pas aux deux. Le rôle « vendeur » dans une connexion de contact à opportunité est un exemple de ce rôle. Les enregistrements, tels qu’une opportunité, une facture ou une commande client, contiennent généralement des informations suffisantes sur ce qu’ils représentent et ne nécessitent pas qu’un rôle leur soit attribué.

• Appliquez deux rôles correspondants (parfois appelés rôles réciproques). Un rôle s’applique à un enregistrement source et l’autre rôle s’applique à un enregistrement cible. Un « docteur » et un « patient », un « parent » et un « enfant » sont des exemples de rôles correspondants.

Catégories de rôle de connexion

Lorsque vous créez des rôles de connexion, vous pouvez spécifier la catégorie d’appartenance. Par exemple, vous pouvez utiliser les catégories suivantes :

• Entreprise (fournisseur, acheteur, concurrent)

• Famille (parent, sœur, cousin)

• Social (partenaire de tennis, membre de club, ami)

  La liste des catégories est personnalisable. Vous pouvez ajouter les catégories qui correspondent le mieux à votre modèle d’entreprise.

Créer des rôles de connexion

Pour créer un rôle de connexion, vous devez spécifier les informations suivantes :

• Utilisez l’attribut ConnectionRole.Name pour spécifier un nom de rôle.

• Utilisez l’attribut ConnectionRole.Description pour ajouter une description de rôle.

• Utilisez l’attribut ConnectionRole.Category pour spécifier une catégorie de rôle. Les valeurs possibles pour cet attribut sont définies dans le groupe d’options global connectionrole_category.

• Lorsque vous créez un rôle de connexion, vous pouvez spécifier un type d’entité auquel le rôle est appliqué, par exemple un prospect, un compte ou un concurrent. Si vous ne spécifiez pas de type d’entité spécifique, vous pouvez appliquer un rôle de connexion à toutes les entités Dynamics 365 Customer Engagement (on-premises). Pour spécifier le type d’entité, utilisez l’attribut ConnectionRoleObjectTypeCode.AssociatedObjectTypeCode. Pour associer le rôle de connexion à un type d’entité spécifique, utilisez l’attribut ConnectionRoleObjectTypeCode.ConnectionRoleId. Un enregistrement de rôle de connexion peut être référencé par plusieurs enregistrements de code des types d’objets du rôle de connexion. Si vous supprimez toutes les références à l’enregistrement de rôle de connexion, vous pouvez appliquer ce rôle de connexion à toutes les entités Dynamics 365 Customer Engagement (on-premises).

  Astuce

  Pour rechercher les rôles de connexion pour une entité de compte, spécifiez tous les rôles liés à l’entité de compte (Code de type d’entité = 1) ou à toutes les entités (Code de type d’entité = 0) dans la requête.

Associer et dissocier des rôles de connexion

Pour associer les rôles dans la connexion, utilisez la méthode Associate. Pour dissocier les rôles, utilisez la méthode Disassociate. Pour plus d’informations sur le message Associate et le message Disassociate, voir Présentation des entités dans Dynamics 365 Customer Engagement (on-premises).

Voir aussi

Entités de connexion
Exemple de code pour les entités de connexion
Exemple : créer un rôle de connexion réciproque (à liaison anticipée)
Entité Connection