Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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.
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 :
Connectez-vous à Power Apps.
Sélectionnez Paramètres
, puis sélectionnez Centre d′administration.
Dans le volet de gauche, sélectionnez Environnements, sélectionnez l’environnement dans lequel vous souhaitez activer cette fonctionnalité, puis sélectionnez Paramètres.
Développez Produit et sélectionnez Fonctionnalités.
Dans la liste des fonctionnalités disponibles, activez Power Apps framework de composants pour les applications de canevas, puis sélectionnez Save.
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
Accédez à Power Apps Studio.
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.
Dans le volet de gauche, sélectionnez Ajouter (+), puis sélectionnez Obtenir plus de composants.
Sélectionnez l’onglet Code, sélectionnez un composant dans la liste, puis sélectionnez Importer.
Dans le volet de gauche, sélectionnez +, développez Composants de code, puis sélectionnez le composant pour l′ajouter à l′application.
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.
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
Ouvrez l’application où vous avez ajouté le composant de code.
Dans le volet gauche, sélectionnez Arborescence, puis sélectionnez l’écran où vous avez ajouté le composant de code.
En regard du composant, sélectionnez Plus (...), puis sélectionnez Supprimer.
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