Partager via


Décrire une relation entre des tables 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 qui peuvent être appliqués aux deux enregistrements dans la connexion.
  • Appliquez un rôle à l’enregistrement source ou à l’enregistrement cible, mais pas aux deux. Un rôle de « vendeur » dans la conversion d'un contact en opportunité est un exemple typique de ce type de 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 « médecin » 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 la ConnectionRole.Name méthode pour spécifier un nom de rôle.

  • Utilisez la ConnectionRole.Description commande pour ajouter une description de rôle.

  • Utilisez le ConnectionRole.Category pour spécifier une catégorie de rôle. Les valeurs possibles pour cela sont définies dans les connectionrole_category choix.

  • Lorsque vous créez un rôle de connexion, vous pouvez spécifier un type de table auquel le rôle sera appliqué, tel que prospect, compte ou concurrent. Si vous ne spécifiez pas de type de table particulier, vous pouvez appliquer un rôle de connexion à toutes les tables Microsoft Dataverse. Pour spécifier le type de table, utilisez le ConnectionRoleObjectTypeCode.AssociatedObjectTypeCode. Pour lier le rôle de connexion à un type de table particulier, utilisez le 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 tables Dataverse.

    Conseil / Astuce

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

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 Associate message et le Disassociate message, consultez Associer et dissocier les lignes de table à l’aide du Kit de développement logiciel (SDK) pour .NET et Associer et dissocier les lignes de table à l’aide de l’API web.

Voir aussi

Tables de connexion
Table de connexion
Exemple : Créer une connexion
Exemple : Créer un rôle de connexion
Exemple : Créer un rôle de connexion réciproque
Exemple : interroger des connexions par un enregistrement (liaison anticipée)
Exemple : interroger les rôles de connexion par code de type d’entité (liaison anticipée)
Exemple : interroger des connexions par rôles réciproques (liaison anticipée)
Exemple : Mettre à jour un rôle de connexion (liaison précoce)