Describe a relationship between entities with connection roles
You can describe the relationship between records through the roles that you assign to them.
There are several ways you can use the connection roles in a connection:
Apply the same role to the source record and to the target record. A “friend”, a “team member”, or a “colleague” are examples of roles that could be applied to both records in the connection.
Apply a role to the source record or to the target record, but not to both. A “salesperson” role in a contact to opportunity connection is an example of such role. The records, such as opportunity, invoice, or sales order usually contain sufficient information about what they represent and do not require a role assigned to them.
Apply two matching roles (sometimes referred to as reciprocal roles). One role applies to a source record and the other role applies to a target record. A “doctor” and a “patient”, a “parent” and a “child” are examples of matching roles.
Connection Role Categories
When you create connection roles, you can specify what category they belong to. For example, you can use the following categories:
Business (supplier, buyer, competitor)
Family (father, sister, cousin)
Social (tennis partner, club member, friend)
The category list is customizable. You can add the categories that best fit your business model.
Create Connection Roles
To create a connection role you must specify the following information:
ConnectionRole.Nameattribute to specify a role name.
ConnectionRole.Descriptionattribute to add a role description.
ConnectionRole.Categoryattribute to specify a role category. The possible values for this attribute are defined in the
connectionrole_categoryglobal option set.
When you create a connection role, you can specify an entity type that the role will be applied to, such as lead, account, or competitor. If you do not specify a particular entity type, then you can apply a connection role to all Dynamics 365 for Customer Engagement entities. To specify the entity type, use the
ConnectionRoleObjectTypeCode.AssociatedObjectTypeCodeattribute. To link the connection role to a particular entity type, use the
ConnectionRoleObjectTypeCode.ConnectionRoleIdattribute. A connection role record can be referenced by multiple connection role object type code records. If you remove all references to the connection role record, you can apply this connection role to all Dynamics 365 for Customer Engagement entities.
To find the connection roles for an account entity, in the query, specify all roles that are linked to the account entity (Entity Type Code = 1) or to all entities (Entity Type Code = 0).
Associate and Disassociate Connection Roles
To associate the roles in the connection, use the Associate method. To disassociate the roles, use the Disassociate method. For more information about the
Associate message and the
Disassociate message, see Introduction to Entities in Dynamics 365 Customer Engagement (on-premises).