démarrage rapide : Créer un projet Power Platform Tools

Comme avec n’importe quelle solution Visual Studio, vous commencez par créer un nouveau projet. Dans la boîte de dialogue du nouveau projet, saisissez « Power Platform » dans le champ de recherche. Une liste des modèles de projet C# Power Platform Tools disponibles est décrite dans la section Modèles de projet disponibles.

Conditions préalables

• Visual Studio 2019 ou 2022
• Power Platform Tools pour Visual Studio
• Langage C#
• .NET Framework 4.6.2 ou versions supérieures ; le développement de plug-in et d’activité de workflow personnalisé nécessite la version 4.6.2
• Abonnement ou environnement de test Power Apps
• Windows Workflow Foundation (uniquement pour le développement d’activités de workflow personnalisé)

Si vous n’avez pas installé Power Platform Tools pour Visual Studio, installez-le en suivant les instructions fournies sous Power Platform Tools

Vous pouvez installer Windows Workflow Foundation à partir de l’application d’installation de Visual Studio en sélectionnant Modifier et en choisissant le composant individuel, comme indiqué dans la figure suivante. Une autre approche consiste à installer une charge de travail qui contient ce composant.

Modèles de projet disponibles

Le tableau suivant présente les modèles de projet Power Platform Tools disponibles.

Modèle de projet C#	Description
Modèle de solution Power Platform	Modèle de solution pour créer une solution Power Platform. Ce modèle concerne une solution Visual Studio et non une solution Microsoft Dataverse.
Bibliothèque de plug-ins Power Platform	Modèle de projet pour la création d’une bibliothèque de classes de plug-in et d’un assembly (DLL) Power Platform.
Package Power Platform	Modèle de projet pour créer un package Power Platform (CrmPackage). Le package est utilisé pour déployer la solution et les bibliothèques de code personnalisé dans un environnement Dataverse.
Bibliothèque d’activités de workflow Power Platform	Modèle de projet pour la création d’une bibliothèque de classes d’activités de workflow personnalisé et d’un assembly (DLL) Power Platform.
Projet de personnalisation	Modèle de projet pour toutes les personnalisations d’une solution Power Platform (Dataverse).

Utiliser le modèle de solution Power Platform

Le modèle de solution Power Platform est un bon point de départ pour toute nouvelle solution. Vous pouvez ajouter et supprimer des projets de la solution. Cependant, vous ne devez pas supprimer le projet CrmPackage. Si vous le faites, cela entraîne l’échec du déploiement de la solution Power Platform dans l’environnement cible.

Important

Une solution Power Platform doit contenir un seul projet CRMPackage. Sinon, le déploiement de la solution Dataverse échouera.

Les modèles de projet de la bibliothèque de plug-ins et de la bibliothèque de workflows sont généralement utilisés pour des scénarios plus avancés. Par exemple, si vous souhaitez éventuellement ajouter plusieurs assemblys de code personnalisé à une Power Platform solution ou si vous souhaitez uniquement développer ce composant de code personnalisé spécifique. Avant de pouvoir déployer une solution qui ne contient qu’un projet de ces types, vous devez ajouter un projet CrmPackage à la solution Visual Studio.

Le moyen le plus simple de créer une solution Power Platform contenant un projet CrmPackage, et éventuellement un projet de plug-in et/ou d’activité de workflow consiste à utiliser le modèle de solution Power Platform. Pour créer cette solution, procédez comme suit.

1. Dans la boîte de dialogue de nouveau projet Visual Studio, recherchez et choisissez le Modèle de solution Power Platform, puis sélectionnez Suivant.

2. Entrez les informations de projet demandées, choisissez une version de .NET Framework et sélectionnez Créer.

   À ce stade, vous devriez voir soit une boîte de dialogue de connexion Dataverse soit une boîte de dialogue visant à réutiliser votre dernière connexion Dataverse. Faites le nécessaire pour vous connecter à votre environnement de développement Dataverse. Ne développez jamais de code dans un environnement de production.

3. Dans la boîte de dialogue Configurer la solution Microsoft Power Platform, choisissez soit d’utiliser une solution Dataverse, soit de créer une nouvelle solution.

   Selon ce que vous avez choisi, vous serez invité soit à saisir des informations sur la nouvelle solution, soit à sélectionner la solution existante dans une liste déroulante. L'étape 3 Sélectionner une solution s’affiche, mais n'est pas active tant que vous n’êtes pas connecté et que vous n’avez pas sélectionné Suivant à l’étape 2.

4. Une fois la solution Power Platform cible identifiée ou créée, vous spécifiez des éléments existants ou créez de nouveaux projets (étape 1) en utilisant l’un des modèles de projet Power Platform ci-dessus.

   Lorsque vous aurez choisi un nouvel élément, la boîte de dialogue se développera pour afficher l’étape 2 où vous pourrez choisir (seulement) un de chacun des projets disponibles à ajouter à votre solution. Choisissez (cochez) un ou plusieurs projets dans la liste et sélectionnez Suivant. L’étape 3 s’affiche mais n’est pas active tant que vous n’avez pas terminé l’étape 2 et sélectionné Suivant.

5. À l’étape 3 de la boîte de dialogue, entrez les noms des projets que vous avez choisis et sélectionnez Terminé.

   Choisissez les noms que vous voulez voir comme noms de projet dans l’Explorateur de solutions Visual Studio.

6. Vous êtes invité à enregistrer le fichier de solution. Sélectionnez Enregistrer pour enregistrer la solution Visual Studio.

Dans l’Explorateur de solutions, vous devriez maintenant voir une solution contenant un seul projet CrmPackage et un ou plusieurs projets basés sur les modèles de projet que vous avez choisis. Chaque projet de la bibliothèque de plug-ins ou de classes d’activité de workflow personnalisé génère un assembly. Vous pouvez ajouter d'autres classes à chaque bibliothèque de classes en ajoutant un élément nouveau ou existant, et vous pouvez ajouter d’autres projets à la solution en utilisant les modèles de projet Power Platform.

Gestion des projets

Les procédures suivantes décrivent certaines opérations courantes pour votre solution Visual Studio.

Ajouter un nouveau projet à une solution Power Platform

Seuls les projets créés avec un modèle Power Platform Tools doivent être ajoutés à une solution créée à l’aide du modèle de solution Power Platform Tools. Pour ajouter un nouveau projet à une solution, procédez comme suit.

1. Cliquez avec le bouton droit sur l’Explorateur de solutions, sélectionnez Ajouter, puis Nouveau projet.

2. Sélectionnez l’un des modèles Power Platform Tools installés, puis sélectionnez Suivant.

3. Fournissez toutes les informations nécessaires, puis sélectionnez Créer. Pour une bibliothèque de plug-ins ou d’activités de workflow, veillez à choisir .NET Framework 4.6.2.

Ajouter un projet existant à une solution Power Platform

Seuls les projets créés à partir de modèles Power Platform Tools doivent être ajoutés à une solution créée à l’aide du modèle de solution Power Platform Tools.

1. Cliquez avec le bouton droit sur l’Explorateur de solutions, sélectionnez Ajouter, puis Projet existant.

2. Accédez au fichier .csprog du projet cible, sélectionnez-le et choisissez Ouvrir.

3. Dans l’Explorateur de solutions, sous le projet CrmPackage, cliquez avec le bouton droit sur Références, puis sélectionnez Ajouter une référence.

4. Dans l’onglet Projets de la boîte de dialogue Ajouter une référence, sélectionnez les projets (à ajouter) dans la liste, puis sélectionnez Ajouter pour les ajouter à la liste des projets et composants sélectionnés.

5. Sélectionnez OK pour ajouter les projets à la solution et fermer la boîte de dialogue Ajouter une référence.

Supprimer un projet d’une solution Power Platform

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet et sélectionnez Supprimer. Le projet est automatiquement supprimé des références CrmPackage.

2. Modifiez le fichier XML RegisterFile.crmregister dans le projet CrmPackage et supprimez tout code d’inscription XML lié au projet supprimé.

3. Supprimez tous les assemblys déployés et toutes les étapes de votre projet de l’environnement et de la solution Dataverse.

   Si vous avez supprimé un projet de bibliothèque de plug-ins ou d’activités de workflow de la solution Visual Studio, vous pouvez également supprimer tous les assemblys et étapes associés de l’environnement et de la solution Dataverse. Vous pouvez supprimer ces composants dans l’Explorateur Power Platform en développant le nœud Assemblys de plug-in de votre arborescence d’environnements, en cliquant avec le bouton droit sur l’assembly cible et en sélectionnant Supprimer l’assembly. Cela supprime l’assembly et toutes les étapes enregistrées.

   Important

   Votre compte d’ouverture de session Dataverse doit posséder ou disposer d’un accès de suppression à l’assembly déployé pour que vous puissiez le supprimer de l’environnement.

Voir aussi

Démarrage rapide : créer un plug-in à l’aide de Power Platform Tools