Créer un package de composant de code

  • Article

Cet article explique comment importer des composants de code dans Microsoft Dataverse. Après avoir implémenté les composants du code à l’aide de Microsoft Power Platform CLI, l’étape suivante consiste à regrouper tous les éléments du composant de code dans un fichier de solution et à importer le fichier de solution dans Dataverse afin que vous puissiez voir les composants du code au moment de l’exécution.

Pour créer et importer un fichier de solution :

  1. Créez un nouveau dossier dans le dossier de l’exemple de composant et nommez-le comme Solutions (ou tout nom de votre choix) en utilisant la commande mkdir Solutions. Accédez au répertoire à l’aide de la commande cd Solutions.

  2. Créez un projet de solutions à l’aide de la commande pac solution init. Le projet de solution est utilisé pour regrouper le composant de code dans un fichier zip de solution (compressé) utilisé pour l’importation dans Dataverse.

    pac solution init --publisher-name developer --publisher-prefix dev

    Notes

    Les valeurs publisher-name et publisher-prefix doivent être uniques à votre environnement.

  3. Une fois le projet de solution créé, vous devez faire référence au dossier Solutions à l’emplacement où l’exemple de composant créé est situé. Vous pouvez ajouter la référence à l’aide de la commande pac solution add-reference. Cette référence informe le projet de solution dont les composants de code doivent être ajoutés au cours de la création. Vous pouvez ajouter des références à plusieurs composants dans un projet simple de solution.

     pac solution add-reference --path c:\downloads\mysamplecomponent

  4. Pour générer un fichier zip du projet de solution, accédez à votre répertoire de projet de solution, puis générer le projet à l’aide de la commande suivante. Cette commande utilise MSBuild pour générer votre projet de solution en explorant les dépendances NuGet dans le cadre de la restauration. Utilisez /restore uniquement pour la première fois lorsque le projet de solution est créé. Pour chaque build après cela, vous pouvez exécuter la commande msbuild.

    msbuild /t:build /restore

    Conseil

    • Si msbuild 15.9.* ne se trouve pas dans le chemin d’accès, ouvrez l’invite de commandes de développeur pour VS 2017 pour exécuter les commandes msbuild.
    • La génération de la solution dans la configuration de débogage génère un package de solution non gérée. Un package de solution non gérée est généré lors de la création de la solution dans la configuration de version. Ces paramètres peuvent être remplacés en spécifiant la propriété SolutionPackageType dans le fichier cdsproj.
    • Vous pouvez définir la configuration de msbuild vers Release pour publier une build de production. Exemple : msbuild /p:configuration=Release
    • Si vous rencontrez une erreur indiquant Nom du projet ambigu lors de l’exécution de la commande msbuild sur votre solution, veillez à ce que le nom de votre solution et le nom du projet ne soient pas identiques.

  5. Les fichiers générés à partir de solution se trouvent dans le dossier \bin\debug\ une fois la génération aboutie.

  6. Importez manuellement la solution dans Dataverse en utilisant le portail web ou en utilisant automatiquement Microsoft Power Platform Build Tools.

Connexion à votre environnement

Vous pouvez déployer les composants de code directement depuis Microsoft Power Platform CLI en se connectant à l’environnement Dataverse, puis en poussant les composants mis à jour.

Suivez les étapes ci-dessous pour créer le profil d’authentification, vous connecter à Dataverse et envoyer les composants mis à jour.

  1. Créez votre profil d’authentification à l’aide de la commande pac auth create :

    pac auth create --url https://xyz.crm.dynamics.com

  2. Si vous avez déjà créé un profil d’authentification, vous pouvez afficher tous les profils existants à l’aide de la commande pac auth list :

     pac auth list

  3. Pour basculer d’un profil d’authentification à l’autre précédemment créés, utilisez la commande pac auth select :

     pac auth select --index <index of the active profile>

  4. Pour obtenir les informations de base sur l’environnement, utilisez la commande pac org who. Le rapport est créé à l’aide du profil d’authentification par défaut.

    pac org who

  5. Pour supprimer un profil d’authentification spécifique, utilisez la commande pac auth delete pac auth delete --index <index of the profile>.

  6. Si vous souhaitez effacer tous les profils d’authentification de votre ordinateur local, utilisez la commande pac auth clear. Cette action est irréversible, car elle entraîne la suppression complète du fichier authprofile.json et du fichier cache de jeton de votre ordinateur local.

Déploiement des composants de code

Une fois que vous avez créé un profil d’authentification avec succès, vous pouvez commencer à pousser les composants de code vers l’instance Dataverse avec toutes les dernières modifications.

La fonctionnalité push accélère le développement du cycle de développeur interne, car elle transmet les exigences de version du composant de code et n’exige pas que vous définissiez votre solution (cdsproj) pour importer le composant de code.

Pour utiliser la fonctionnalité push, procédez comme suit :

  1. Vérifiez que vous avez créé un profil d’authentification valide.

  2. Accédez au répertoire dans lequel se trouve le fichier d’exemple de composant.

  3. Exécutez la commande pac pcf push.

    pac pcf push --publisher-prefix <your publisher prefix>

    Notes

    Le préfixe d’éditeur qui est utilisée avec la commande push doit correspondre au préfixe de l’éditeur de votre solution dans lequel les composants sont inclus.

Supprimer des composants d’une solution

Pour supprimer un composant de code à partir d’un fichier de solution :

  1. Modifiez le fichier cdsproj dans le répertoire de projet de solution et supprimez les références au composant. Voici trouverez ici un exemple de référence de composant :

    <ItemGroup>
    <Projectreference Include="..\pcf_component\pcf_component.pcfproj">
      <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project>
      <Name>pcf_component</Name>
      <Targets>Build</Targets>
      <referenceOutputAssembly>false</referenceOutputAssembly>
      <OutputItemType>Content</OutputItemType>
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </Projectreference>
</ItemGroup>

  2. Effectuez une régénération (ou un nettoyage) en exécutant la commande suivante :

    msbuild /t:rebuild

Voir aussi

Ajouter des composants de code à une colonne ou une table dans des applications pilotées par modèle
Ajouter des composants à une application canevas
Référence d’API Power Apps component framework
Vue d’ensemble de Power Apps component framework
Groupes de commandes Microsoft Power Platform CLI

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).