Activer la configuration des composants avec des contrôleurs hérités dans le générateur de composants

Découvrez comment les composants peuvent hériter des ressources de page.

À l’aide du générateur de composants, les développeurs ajoutent des ressources de données de deux manières : directement dans le composant ou par héritage à partir de la page.

Configuration directe

Lorsque vous ajoutez des ressources de données directement à un composant, elles restent contenues dans ce composant. Ces ressources de données internes ne sont pas visibles ou accessibles lorsque le composant est placé sur une page.

Héritage

Vous pouvez configurer un composant pour hériter des ressources de données de la page où il est placé. Lorsque l’héritage est activé, le composant recherche les ressources de données du même type et s’y connecte automatiquement. Par exemple, un composant configuré pour hériter des contrôleurs de formulaire recherche des contrôleurs de formulaire sur la page. Cela permet au composant d’être utilisé dans différents contextes de page et d’exploiter à chaque fois les ressources de données existantes sans configuration manuelle.

Lorsque vous placez un composant configuré pour l’héritage sur une page, le comportement d’héritage fonctionne comme suit :

Ressources correspondantes trouvées	Comportement
Aucune correspondance trouvée	Crée une nouvelle ressource du même type à l’aide de la configuration initiale du composant
Un	Se connecte à cette ressource
Multiple	Se connecte à la première instance de cette ressource

Activer la configuration des composants avec les contrôleurs hérités

Configurez les composants pour qu’ils héritent automatiquement des contrôleurs et des ressources de données lorsqu’ils sont placés sur des pages.

Avant de commencer

Rôle requis : ui_builder_admin

Pourquoi et quand exécuter cette tâche

Dans cet exemple de générateur de composants, nous allons créer un composant de texte et le configurer pour hériter du contrôleur de liste. Nous le placerons ensuite sur une page de liste où le composant se connecte au contrôleur de liste et affiche le nom de table approprié.

Procédure

1. Accédez à la Tous > Cadre de travail Now Experience > Générateur d'IU.
2. Sélectionnez Create (Créer) dans la page d’accueil Générateur d'IU .
   
3. Sélectionnez un composant.
4. Dans le formulaire, saisissez les valeurs suivantes :

   Tableau 1. Propriétés des composants

   Champ	Valeur
   Nom	Référence de table
   Catégories	Contenu
   Description	Composant de texte qui affiche le nom de la table de la page actuelle
   Icône	(Par défaut)

5. Sélectionnez Créer.
6. Ajoutez une ressource de données au composant.
   1. Dans le tiroir des ressources de données, sélectionnez + Ajouter une ressource de données.
   2. Sur la gauche, sélectionnez Contrôleur de liste.
   3. Sur la droite, sélectionnez Configurations avancées pour développer la section.
   4. Sélectionnez l’option Hériter des configurations du parent pour activer la propriété.
   5. Sélectionnez Ajouter.
   
7. Créez le composant.
   1. Dans l’arborescence de contenu, sélectionnez + Ajouter du contenu.
   2. Sélectionner Colonne unique, puis Ajouter.
   3. Dans l’arborescence de contenu, sélectionnez + Ajouter du contenu dans la colonne 1.
   4. Sélectionnez un texte stylisé, puis sélectionnez Ajouter.
   5. Sélectionnez Annuler pour fermer la fenêtre prédéfinie.
8. Configurez le composant pour utiliser le contrôleur de liste.
   1. Dans le panneau de configuration, survolez Text ( Texte ) et sélectionnez l’icône de liaison des données .
   2. Sur la gauche, sélectionnez l’onglet Formules, puis double-cliquez sur CONCAT.
   3. Dans la section supérieure, double-cliquez sur value1 pour modifier le champ et saisissez « Liste affichant les enregistrements de ».
   4. Double-cliquez sur les valeurs pour modifier le champ et saisissez @data.list_controller_1.tableLabel.
   5. Sélectionnez Appliquer.
9. Sélectionnez Enregistrer pour enregistrer votre travail.
   Votre composant personnalisé est maintenant disponible dans la boîte à outils et prêt à l’emploi dans une page.
10. Placez le composant sur une page de liste pour qu’il hérite automatiquement du contrôleur de liste et affiche le nom de la table.