Partager via


Composants de code pour les applications de type canevas

Les développeurs professionnels peuvent utiliser le framework de composants Power Apps pour créer des composants de code qu’ils peuvent utiliser dans leurs applications canvas. Pour plus d’informations, consultez Power Apps vue d’ensemble de l’infrastructure de composants.

Les créateurs d’applications peuvent utiliser Power Apps composant framework pour créer, importer et ajouter des composants de code aux applications de canevas à l’aide de Microsoft Power Platform CLI. Certaines API pourraient ne pas être disponibles dans les applications Canvas. Vérifiez chaque API pour déterminer où elle est disponible.

Considérations de sécurité

Avertissement 

Les composants de code contiennent du code que Microsoft n'a pas généré et peut potentiellement accéder aux jetons de sécurité et aux données lors du rendu dans Power Apps Studio. Lors de l’ajout de composants de code à une application canevas, assurez-vous d’obtenir les solutions de composants de code à partir d’une source approuvée. Cette vulnérabilité n’existe pas lors de l’utilisation de l’application canvas.

Lorsque vous ouvrez une application canevas qui contient des composants de code dans Power Apps Studio, un message d’avertissement sur le code potentiellement dangereux s’affiche. Les composants de code de l’environnement Power Apps Studio ont accès aux jetons de sécurité, donc n'ouvrez que des composants provenant de sources fiables. Les administrateurs et les personnalisateurs de système doivent examiner et valider tous les composants de code avant de les importer dans un environnement et de les rendre disponibles aux créateurs pour une utilisation dans leurs applications. L’éditeur Default s’affiche lorsque vous importez des composants de code à l’aide d’une solution non managée ou lorsque vous utilisez pac pcf push pour installer votre composant de code.

Avertissement de sécurité.

Prérequis

  • Une licence Power Apps est requise. Pour plus d’informations, consultez licences du framework de composants Power Apps.
  • Les privilèges d’administrateur système sont requis pour activer la fonctionnalité d’infrastructure de composants Power Apps dans l’environnement.

Activer la fonctionnalité d’infrastructure de composants Power Apps

Pour ajouter des composants de code à une application, vous devez activer la fonctionnalité d’infrastructure de composants Power Apps dans chaque environnement où vous souhaitez les utiliser. Par défaut, la fonctionnalité du composant Power Apps est activée pour les applications basées sur des modèles. Pour autoriser un environnement à utiliser des composants de code à l’intérieur de ses applications :

  1. Connectez-vous à Power Apps.

  2. Sélectionnez ParamètresParamètres., puis sélectionnez Centre d′administration.

    Paramètres et Centre d’administration.

  3. Dans le volet de gauche, sélectionnez Environnements, sélectionnez l’environnement dans lequel vous souhaitez activer cette fonctionnalité, puis sélectionnez Paramètres.

  4. Développez Produit et sélectionnez Fonctionnalités.

  5. Dans la liste des fonctionnalités disponibles, activez Power Apps framework de composants pour les applications de canevas, puis sélectionnez Save.

    Activer le framework de composants Power Apps

Mise en œuvre des composants de code

Après avoir activé la fonctionnalité d’infrastructure de composants Power Apps dans votre environnement, vous pouvez commencer à implémenter la logique des composants de code. Pour obtenir un didacticiel pas à pas, consultez Créer votre premier composant de code.

Vérifiez les limitations des composants de code dans les applications de canevas avant de commencer l’implémentation.

Ajouter des composants à une application canevas

  1. Accédez à Power Apps Studio.

  2. Créez une application canevas ou modifiez une application existante à laquelle vous souhaitez ajouter le composant de code.

    Important

    Veillez à importer le fichier .zip de la solution contenant les composants de code dans Microsoft Dataverse.

  3. Dans le volet de gauche, sélectionnez Ajouter (+), puis sélectionnez Obtenir plus de composants.

    Insérer des composants.

  4. Sélectionnez l’onglet Code, sélectionnez un composant dans la liste, puis sélectionnez Importer.

    Importer un composant.

  5. Dans le volet de gauche, sélectionnez +, développez Composants de code, puis sélectionnez le composant pour l′ajouter à l′application.

    Ajoutez un composant.

    Note

    Vous pouvez également ajouter des composants en sélectionnant Insérer>Personnalisé>Composant d’importation. Cette option est déconseillée et sera supprimée dans une prochaine version. Utilisez donc le flux décrit précédemment.

Sous l’onglet Propriétés , vous voyez les propriétés du composant de code.

Volet des propriétés du composant de code par défaut.

Note

Pour réimporter les composants de code existants et rendre les propriétés disponibles dans l’onglet Propriétés par défaut, mettez à jour la version du manifeste du composant de code. Les propriétés restent disponibles sous l’onglet Propriétés avancées .

Supprimer un composant de code d’une application canevas

  1. Ouvrez l’application où vous avez ajouté le composant de code.

  2. Dans le volet gauche, sélectionnez Arborescence, puis sélectionnez l’écran où vous avez ajouté le composant de code.

  3. En regard du composant, sélectionnez Plus (...), puis sélectionnez Supprimer.

    Supprimer un composant de code.

  4. Enregistrez l’application pour voir les modifications.

Mettre à jour des composants de code existants

Pour afficher les modifications du runtime après la mise à jour des composants de code, modifiez la version propriété dans le fichier manifeste. Modifiez la version du composant chaque fois que vous apportez des modifications.

Note

Power Apps Studio met à jour les composants de code existants uniquement lorsque vous fermez ou rouvrez l’application. Lorsque vous rouvrez l’application, vous êtes invité à mettre à jour les composants de code. La suppression ou l’ajout de composants de code dans l’application ne met pas à jour les composants. Publiez toutes les personnalisations de la solution mise à jour en premier, sinon les mises à jour apportées au composant de code n’apparaissent pas.

Voir aussi

Vue d’ensemble de l’infrastructure de composants Power Apps
Création de votre premier composant de code
Apprendre le framework de composants Power Apps