Créer et enregistrer un package de plug-ins avec Visual Studio

Dans cet article, vous apprendrez à créer un package de plug-ins, puis à le télécharger et à l’enregistrer sur le serveur Dataverse. Vous utiliserez Visual Studio avec l'extension Power Platform Tools pour créer le package de plug-ins, télécharger et enregistrer le package et effectuer d’autres tâches de gestion de packages.

Cet article vous permet de :

• Créer un projet de plug-in Visual Studio
• Ajouter un assembly dépendant au projet et le générer
• Utiliser Visual Studio pour télécharger et enregistrer votre package
• Utiliser Visual Studio pour mettre à jour et supprimer un package

Pour plus d’informations : Générer et créer un package de plug-ins.

Conditions préalables

• Accès à un environnement Dataverse
• Un compte d’utilisateur système, avec un rôle Administrateur système ou Personnalisateur du système, dans l’environnement cible
• Visual Studio 2019 avec l'extension Power Platform Tools installée

Consultez ces articles relatifs à l’installation et à l’utilisation de Power Platform Tools pour Visual Studio.

• À quoi servent les outils Power Platform Visual Studio
• Créer un projet Power Platform Tools
• Créer un plug-in à l’aide des outils Power Platform

Activer les packages de plug-ins pour Power Platform Tools

Power Platform Tools pour Visual Studio fournit plusieurs options de configuration comme décrit dans Power Platform Tools.

1. Dans Visual Studio, accédez à Outils>Options et cherchez Power Platform Tools.

2. Sélectionnez Utiliser un package NuGet pour déployer des plug-ins dans Dataverse.

   

Note

Lorsque cette option est sélectionnée, tous vos projets de plug-ins seront déployés sous forme de packages de plug-ins.

Ajouter un assembly dépendant à votre projet

Vous pouvez ajouter un package NuGet pour satisfaire les références requises à votre projet Visual Studio comme vous le faites habituellement. Après avoir généré le projet, vous devriez trouver votre assembly de plug-in dans le package NuGet généré, situé dans le dossier bin\outputPackages.

Vous pouvez utiliser l'Explorateur de package NuGet pour examiner le package NuGet généré.

Ajouter un assembly dépendant sans utiliser NuGet

Si un assembly n’est pas distribué en tant que package NuGet, vous pouvez l’ajouter à votre projet comme vous le faites normalement. Dans Explorateur de solution, clic-droit Dépendances et choisissez Ajouter une référence d’assembly.... Sélectionnez l’assembly à ajouter.

Déployer des packages de plug-ins

Pour déployer (télécharger et enregistrer) votre package de plug-ins, dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet de plug-in et sélectionnez Déployer dans le menu contextuel.

Pour tout premier déploiement, vous devez voir un message dans la fenêtre de sortie qui vous informe de la création du package de plug-in :

6/22/2022 3:03:17 PM : registration of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins, 
at E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful. 
ID allotted was 06a20e15-77f2-ec11-bb3c-000d3a892245.

Pour chaque déploiement ultérieur, vous verrez un message dans la fenêtre de sortie qui vous informe que le package de plug-in a été mis à jour.

6/22/2022 3:20:14 PM : update of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins, at
E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful.

Important

Si votre mise à jour supprime des assemblys de plug-in ou des types utilisés dans les enregistrements d’étape de plug-in, la mise à jour sera rejetée. Vous devez supprimer manuellement tous les enregistrements d’étape qui utilisent des assemblys de plug-in ou des types de plug-ins que vous souhaitez supprimer avec votre mise à jour.

La version du package de plug-in ou de l’assemblage de plug-in n’est pas un facteur dans les comportements de mise à niveau. Vous pouvez mettre à jour les versions de ces éléments selon vos besoins.

Gestion des packages de plug-ins

Dans Visual Studio, vous pouvez effectuer des opérations supplémentaires sur les packages de plug-ins, comme décrit dans les sections suivantes.

Afficher les packages de plug-ins avec Power Platform Tools

Au sein de Power Platform Explorer, vous pouvez afficher les packages de plug-in disponibles.

Créer un package de plug-ins, méthode alternative

Comme mentionné dans Déployer des packages de plug-ins, vous n’aurez généralement pas besoin de créer un package de plug-ins dans le flux habituel de création d’un plug-in. Il sera créé automatiquement la première fois que vous déploierez le plug-in alors que l’option Utiliser un package NuGet pour déployer des plug-ins dans Dataverse est définie dans Visual Studio. Cependant, vous pouvez créer un nouveau package de plug-ins à partir d’un package NuGet en procédant comme suit.

1. Au sein de Power Platform Explorer, sélectionnez Packages de plug-in et sélectionnez Créer depuis le menu contextuel.

   

2. Cette commande ouvre la boîte de dialogue Importer un nouveau package de plug-ins.

   

3. Sélectionnez le package NuGet et choisissez la solution à laquelle il doit être ajouté, ou créez une solution.

Supprimer un package de plug-ins

Dans l'explorateur de Power Platform, sélectionnez un package de plug-ins, puis sélectionnez Supprimer dans le menu contextuel.

Important

La suppression d’un package supprimera le package, tous les assemblys qu’il contient, tous les plug-ins de l’assembly et tous les enregistrements d’étape de plug-in pour les plug-ins.

Mettre à jour un package de plug-ins, méthode alternative

Comme mentionné dans Déployer des packages de plug-ins, vous n’aurez généralement pas besoin de mettre à jour un package de plug-ins dans le flux habituel de création d’un plug-in. Il sera mis à jour automatiquement chaque fois que vous déploierez le plug-in alors que l’option Utiliser un package NuGet pour déployer des plug-ins dans Dataverse est définie dans Visual Studio. Cependant, vous pouvez mettre à jour un nouveau package de plug-in à partir d’un package Nuget en suivant les étapes ci-dessous.

Au sein de Power Platform Explorer, sélectionnez un package de plug-in, puis sélectionnez Mettre à jour depuis le menu contextuel.

Cette commande ouvre une boîte de dialogue vous permettant de sélectionner un package NuGet pour mettre à jour le package de plug-in.