Exemple : Utiliser des solutions

Cet exemple montre comment effectuer les actions suivantes avec les solutions :

• Créer un éditeur.
• Récupérer l’éditeur par défaut.
• Créer une solution.
• Récupérer une solution.
• Ajouter un composant de solution existant.
• Supprimer un composant de solution.
• Exporter ou empaqueter une solution.
• Installer ou mettre à niveau une solution.
• Supprimer une solution.

Comment exécuter cet exemple

1. Téléchargez ou clonez le référentiel Exemples pour 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 Microsoft Dataverse à 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 Dataverse à 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.

Les exemples de ce référentiel qui nécessitent une connexion à une instance Dataverse pour s’exécuter incluent une référence liée au fichier dataverse/App.config.

En quoi consiste cet exemple

Cet exemple explique comment utiliser des solutions. Il décrit comment créer un éditeur, créer une solution, exporter et importer la solution, et également comment supprimer la solution.

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. La méthode Publisher définit un nouvel éditeur.
3. La méthode Solution crée un solution.
4. La méthode OptionSetMetadata ajoute un composant de solution.
5. La méthode ExportSolutionRequest exporte la solution créée dans Installation.
6. La méthode DeleteSolutionRequest supprime la solution et ses composants.

Démontrer

1. La méthode querySDKSamplePublisher vérifie si l’éditeur est déjà dans le système.
2. La méthode querySampleSolutionResults vérifie si la solution est déjà dans le système.
3. La méthode ExportSolutionRequest exporte la solution.
4. La méthode ImportSolutionRequest importe la solution.

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.