Exemple : installer ou supprimer des exemples de données
Cet exemple indique comment installer ou désinstaller les exemples de données d’une organisation à l’aide du message InstallSampleDataRequest. 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 :
- Télécharger ou cloner le référentiel Exemples pour en avoir une copie locale.
- (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.
- 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 InstallSampleDataRequest
est destiné à un usage dans un scénario où il contient les données nécessaires pour installer des exemples de données.
Utiliser cet exemple
Afin de simuler le scénario décrit dans En quoi consiste cet exemple, l’exemple procède comme suit :
Configurer
- Vérifie la version actuelle de l’organisation.
Démontrer
- Invite les utilisateurs à installer ou supprimer des exemples de données.
- Si l’utilisateur choisit d’installer des exemples de données, le message
InstallSampleDataRequest
installe les exemples de données. - Si l’utilisateur choisit de désinstaller des exemples de données, le message
UninstallSampleDataRequest
supprime les exemples de données.
Nettoyer
Affichez une option pour supprimer les enregistrements 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.