Utiliser des composants de code dans Power Pages

L’infrastructure de composants Power Apps permet aux développeurs professionnels et aux créateurs d’applications de créer des composants de code pour les applications pilotées par modèle et canevas. Ces composants de code peuvent fournir une expérience améliorée des utilisateurs travaillant avec des données sur des formulaires, des vues et des tableaux de bord. En savoir plus sur la vue d’ensemble de l’infrastructure de composants Power Apps.

Power Pages prend désormais en charge les contrôles créés pour les applications basées sur des modèles créées à l’aide de l’infrastructure de composants Power Apps. Pour utiliser des composants de code dans les pages web du site Power Pages :

Une fois ces étapes effectuées, les utilisateurs peuvent interagir avec le composant de code à l’aide de la page web qui possède le composant de formulaire respectif.

Conditions préalables

• Vous avez besoin de privilèges d’administrateur système pour activer la fonctionnalité de composant de code dans l’environnement.
• Votre version de site Power Pages doit être 9.3.3.x ou ultérieure.
• Votre package de site de démarrage doit être 9.2.2103.x ou version ultérieure.

Créer et empaqueter un composant de code

Pour en savoir plus sur la création et l’empaquetage de composants de code dans l’infrastructure de composants Power Apps, accédez à Créer votre premier composant.

Types et formats de champs pris en charge

Power Pages prend en charge des types et formats de champ restreints pour l’utilisation des composants de code. Le tableau suivant répertorie tous les types et formats de données de champ pris en charge :

Pour plus d’informations, consultez la liste et les descriptions des attributs.

Composants de code non pris en charge dans Power Pages

• Les API de composant de code suivantes ne sont pas prises en charge :
  • Device.captureAudio
  • Device.captureImage
  • Device.captureVideo
  • Device.getBarcodeValue
  • Device.getCurrentPosition
  • Device.pickFile
  • Utility
• L’élément uses-feature ne doit pas être défini sur vrai.
• Les Éléments de valeur ne sont pas pris en charge par Power Apps component framework.
• Les contrôles PCF (Power Apps Component Framework) liés à plusieurs champs d’un formulaire ne sont pas pris en charge.

Ajouter un composant de code à un champ dans une application pilotée par modèle

Pour savoir comment ajouter un composant de code à un champ dans une application pilotée par modèle, accédez à Ajouter un composant de code à un champ.

Vous pouvez également ajouter un composant de code à un formulaire à l’aide de l’espace de travail des données.

1. Lors de la modification d’un formulaire Dataverse dans le concepteur de formulaires de l’espace de travail des données, sélectionnez un champ.

2. Choisissez + Composant et sélectionnez un composant approprié pour le champ.

   

3. Sélectionnez Enregistrer et Publier le formulaire.

Configurer le site Power Pages pour le composant de code

Une fois le composant de code ajouté à un champ dans une application pilotée par modèle, vous pouvez configurer Power Pages pour utiliser le composant de code sur un formulaire de base.

Il existe deux méthodes pour activer le composant de code.

Activer le composant de code dans le studio de conception

Pour activer un composant de code sur un formulaire à l’aide du studio de conception.

1. Après avoir ajouté le formulaire à une page, sélectionnez le champ dans lequel vous avez ajouté le composant de code, puis sélectionnez Modifier le champ.

2. Sélectionnez le champ Activer le composant personnalisé.

   

3. Lorsque vous prévisualisez le site, vous devriez voir le composant personnalisé activé.

Activer le composant de code dans l’application de gestion des portails

Pour ajouter un composant de code à un formulaire de base à l’aide de l’application Gestion des portails :

1. Ouvrez l’application Gestion des portails.

2. Dans le volet de gauche, sélectionnez Formulaires de base.

3. Sélectionnez le formulaire sur lequel vous souhaitez ajouter le composant de code.

4. Sélectionnez Associé.

5. Sélectionnez Métadonnées de formulaire de base.

6. Sélectionnez Nouvelles métadonnées de formulaire de base.

7. Sélectionnez Type comme Attribut.

8. Sélectionnez Nom logique de l’attribut.

9. Entrez Étiquette.

10. Pour le Style de contrôle, sélectionnez Composant de code.

11. Enregistrer et fermer le formulaire.

Composants de code utilisant l’API Web du portail

Un composant de code peut être construit et ajouté à une page Web qui peut utiliser l’API Web du portail pour effectuer des actions de création, de récupération, de mise à jour et de suppression. Cette fonctionnalité permet de plus grandes options de personnalisation lors du développement de solutions de portail. Pour plus d’informations, consultez Implémenter un exemple de composant d’API web du portail.

Étapes suivantes

Didacticiel : Utiliser des composants de code dans les portails

Voir aussi

• Vue d'ensemble de Power Apps component framework
• Création de votre premier composant
• Ajouter des composants de code à une colonne ou une table dans des applications pilotées par modèle