Exemple : attribuer un enregistrement à un nouveau propriétaire

Cet exemple indique comment attribuer un compte à un autre utilisateur à l′aide du message IOrganizationService.Update.

Cet exemple utilise la méthode IOrganization.Update au lieu de la méthode AssignRequest, afin de supprimer les messages spécialisés. Pour plus d’informations : Effectuer des opérations spécialisées à l’aide de la fonction de mise à jour

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

Le message IOrganizationService.Update est destiné à un usage dans un scénario où il contient les données nécessaires pour mettre à jour ou insérer un enregistrement existant.

Utiliser cet exemple

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

Configurer

1. Vérifie la version actuelle de l’organisation.
2. Crée les données requises dont cet exemple a besoin.

Privilèges et droits d’accès

Pour exécuter cet exemple, l’appelant doit disposer des privilèges sur l’entité spécifiée et des droits d’accès sur l’enregistrement spécifié. Par exemple, si l’appelant ne dispose que des privilèges d’écriture ou d’attribution sur l’entité et tente d’attribuer l’enregistrement à un autre utilisateur, la demande échoue. L’appelant doit disposer des privilèges d’écriture et d’attribution sur l’entité afin d’attribuer l’enregistrement à un autre utilisateur.

Démontrer

1. La méthode Retrieve récupère les enregistrements de compte créés lors de l’installation (#setup).
2. Le message Update met à jour l’attribut ownerid pour l’utilisateur dont vous souhaitez posséder l’enregistrement.

Nettoyer

Affiche une option pour supprimer toutes les données créées dans l’exemple. La suppression est facultative si vous souhaitez vérifier les données créées par l’exemple. Vous pouvez supprimer manuellement les données pour obtenir les mêmes résultats.