Exemple : créer un rôle de connexion réciproque (à liaison anticipée)

Cet exemple montre comment créer des rôles de connexion réciproques. Il crée un rôle de connexion pour un compte et un rôle de connexion pour un contact, puis les rend réciproques en les associant l’un à l’autre. Vous pouvez télécharger l’exemple ici.

Note

Cet exemple s'applique à Dynamics 365 Customer Engagement (on-premises) et Dataverse.

Comment exécuter cet exemple

Pour obtenir une copie locale de tous les exemples et les générer, procédez comme suit :

1. Télécharger ou cloner le référentiel Exemples pour en avoir une copie locale.
2. (Facultatif) Modifiez le fichier dataverse/App.config pour définir une chaîne de connexion qui spécifie l'instance ou l'organisation à laquelle vous souhaitez vous connecter.
3. Ouvrez l’exemple de solution dans Visual Studio et appuyez sur F5 pour exécuter l’exemple. Après avoir spécifié une chaîne de connexion dans le fichier dataverse/App.config, tout exemple que vous exécutez utilise ces informations de connexion.

Si vous ne spécifiez pas de chaîne de connexion dans le fichier dataverse/App.config, une boîte de dialogue s'ouvre chaque fois que vous exécutez l'exemple et vous devez entrer des informations sur l'instance ou l'organisation à laquelle vous souhaitez vous connecter et sur les informations d'identification que vous souhaitez utiliser. Cette boîte de dialogue met en cache les connexions précédentes afin que vous puissiez choisir une connexion déjà utilisée.

En quoi consiste cet exemple

Les messages ConnectionRole et ConnectionRoleObjectTypeCode sont destinés à un usage dans un scénario contenant des données nécessaires pour créer un rôle de connexion et un type d’objet de rôle de connexion.

Utiliser cet exemple

Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l’exemple procède comme suit :

Installation

1. Vérifie la version actuelle de l’organisation.
2. Le message ConnectionRole crée des rôles de connexion requis pour l’exemple.
3. Le message ConnectionRoleObjectTypeCode crée l’enregistrement de code du type d’objet de rôle de connexion pour le compte.
4. Le message AssociateRequest associe les rôles de connexion les uns aux autres.

Démontrer

1. Exécutez la demande initiale et masquez les résultats, notamment le DataToken
2. Mettre à jour les enregistrements créés dans Installation
3. Effectuez une deuxième demande, cette fois en transmettant DataVersion avec la valeur DataToken extraite de la demande initiale.
4. Afficher les modifications d’entité renvoyées par la deuxième requête

Nettoyer

Présentez une option pour supprimer l’exemple de données créé dans Installation. La suppression est facultative si vous souhaitez vérifier les entités et les données créées par l’exemple. Vous pouvez supprimer manuellement l’enregistrement pour obtenir le même résultat.