Lier les données aux Générateur d'IU pages à l’aide de contrôleurs (fonctionnalité avancée)

Les contrôleurs simplifient la liaison des données et de la logique d’événement pour activer les paramètres prédéfinis des composants dans Générateur d'IU.

Les contrôleurs permettent aux constructeurs de pages de connecter facilement des données et des scripts à leurs pages dans Générateur d'IU. Un contrôleur est un type de ressource de données que les paramètres prédéfinis de composant utilisent pour lier les données aux composants. Les contrôleurs diffèrent des autres ressources de données en ce qu’ils contiennent une logique de données et d’événements qui active les paramètres prédéfinis pour les composants. Un contrôleur apporte les données du serveur à un composant et ramène les données mises à jour au serveur en fonction des interactions avec le composant. Pour plus d’informations sur les préréglages de composants, reportez-vous à la section Configurer automatiquement les composants à l'aide de paramètres prédéfinis.

Remarque :

La création de contrôleurs n’est pas prise en charge dans Yokohama.

Les contrôleurs sont ajoutés par défaut lorsque vous utilisez un modèle de Générateur d'IU page. Vous pouvez ajouter des contrôleurs à Générateur d'IU des pages sans contrôleur dans le tiroir des ressources de données ou en sélectionnant un composant prédéfini après avoir ajouté un composant à une page. Vous pouvez afficher quels contrôleurs sont configurés sur votre page en ouvrant le tiroir des ressources de données.

Figure 1. Contrôleur dans le tiroir des ressources de données

Types de contrôleurs de données dans Générateur d'IU

Contrôleurs de données

Les contrôleurs de données décident quelles informations doivent être affichées sur Générateur d'IU les pages. Les contrôleurs de données utilisent des ressources de données pour synchroniser les informations en temps réel et mettre à jour les données/tables lorsqu’un utilisateur saisit des informations. Vous pouvez ajouter manuellement des contrôleurs de données à une page.

Contrôleurs d’interface utilisateur

Les contrôleurs d’interface utilisateur sont ajoutés aux pages lors de l’utilisation de Générateur d'IU modèles de page et ne peuvent pas être ajoutés manuellement.

Utilisation de contrôleurs avec des paramètres prédéfinis dans Générateur d'IU

Vous pouvez ajouter plusieurs contrôleurs à une Générateur d'IU page, mais vous ne pouvez pas utiliser le même deux fois. Si vous essayez d’utiliser un composant prédéfini qui nécessite un contrôleur, Générateur d'IU il vous invite à l’ajouter.

Tous les composants ne fonctionnent pas avec les contrôleurs, mais vous pouvez facilement voir lesquels le font dans la bibliothèque de composants. Si vous avez un contrôleur configuré sur votre Générateur d'IU page, vous pouvez ouvrir la bibliothèque de composants pour afficher quels composants ont des paramètres prédéfinis. Les composants avec des paramètres prédéfinis disponibles sont mis en surbrillance dans la bibliothèque de composants.

Figure 2. Composants avec paramètres prédéfinis

Ajouter un contrôleur

Ajoutez un contrôleur de données à votre page pour utiliser les paramètres prédéfinis des composants.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Le contrôleur d’enregistrement est le seul contrôleur que vous pouvez ajouter à une page dans Yokohama.

Procédure

1. Accédez à la Tout > Cadre de travail Now Experience > Générateur d'IU.
2. Ouvrez une expérience pour y travailler ou créez une expérience en sélectionnant Créer > Expérience.
   Pour plus d'informations, consultez Configurer la façon dont les utilisateurs interagissent avec vos applications dans Générateur d'IU.
3. Créez ou ouvrez une page ou une variante de page.
   Pour plus d’informations sur la création d’une page dans Générateur d'IU, consultez Créer une page dans le générateur d’IU.
4. Sélectionnez l’icône + dans le tiroir des ressources de données.
5. Sélectionnez une ressource de données.
   
6. Entrez dans le champ de recherche.
7. Sélectionnez le contrôleur que vous souhaitez ajouter à votre page.
8. Sélectionnez Ajouter.
   
9. Renseignez les champs pour configurer le contrôleur.
   

Résultats

Le contrôleur de formulaire s’affiche dans la section Ressources de données .

Modifier un contrôleur

Configurez un contrôleur pour extraire les données d’une table.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tout > Cadre de travail Now Experience > Générateur d'IU.
2. Ouvrez une expérience pour y travailler ou créez une expérience en sélectionnant Créer > Expérience.
   Pour plus d'informations, consultez Configurer la façon dont les utilisateurs interagissent avec vos applications dans Générateur d'IU.
3. Créez ou ouvrez une page.
   Pour plus d’informations sur la création d’une page dans Générateur d'IU, consultez Créer une page dans le générateur d’IU.
4. Sélectionnez le contrôleur que vous souhaitez modifier dans le tiroir Données et scripts .
   
5. Renseignez les champs du formulaire.

   Tableau 1. Formulaire du contrôleur de formulaire

   Champ	Description
   Type	Le type de contrôleur est prédéfini pour tous les contrôleurs.
   Table	Ajoutez une table à partir de laquelle vous souhaitez que le contrôleur extrait les données.
   ID système	Entrez l’identificateur unique d’un enregistrement, fournissez une valeur ou utilisez -1 pour générer une nouvelle valeur.

6. Fermez le modal de modification du contrôleur.
7. Sélectionnez Enregistrer.

Supprimer un contrôleur

Supprimez un contrôleur dont vous n’avez plus besoin dans Générateur d'IU.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Les contrôleurs ne peuvent pas être supprimés des pages créées avec un modèle de page.

Procédure

1. Accédez à la Tout > Cadre de travail Now Experience > Générateur d'IU.
2. Ouvrez une expérience pour y travailler ou créez une expérience en sélectionnant Créer > Expérience.
   Pour plus d'informations, consultez Configurer la façon dont les utilisateurs interagissent avec vos applications dans Générateur d'IU.
3. Ouvrez la page contenant le contrôleur que vous souhaitez supprimer.
4. Sélectionnez l’icône Menu (icône ) en regard du contrôleur que vous souhaitez supprimer.
   
5. Sélectionnez Supprimer.
   
   Le contrôleur est supprimé des instances de ressources de données locales.

Afficher les propriétés et les événements dans l’API du contrôleur

L’API publique du contrôleur définit les données de sortie qu’un contrôleur fournit à un paramètre prédéfini. Cela inclut les valeurs de propriété et les événements gérés utilisés par un composant lorsqu’un paramètre prédéfini est sélectionné. Des informations sur la propriété et l’événement peuvent être affichées dans Générateur d’IU.

Les valeurs des propriétés de composant dans un paramètre prédéfini peuvent être des valeurs statiques ou des chemins d’accès aux données de sortie du contrôleur. Vous pouvez utiliser l’inspecteur de ressource de données dans le générateur d’IU pour afficher les valeurs de la structure de données du contrôleur utilisée par un paramètre prédéfini. Pour afficher la charge utile transportée par un événement dans le paramètre prédéfini, vous pouvez rechercher cet événement dans le sélecteur du gestionnaire d’événements.

Affichage des propriétés dans l’API du contrôleur

Vous pouvez afficher les propriétés prédéfinies dans l’inspecteur de données UIB. Connaître les valeurs disponibles vous aide à comprendre comment un composant se comportera dans votre conception et vous aide à identifier toutes les propriétés du paramètre prédéfini que vous souhaitez peut-être remplacer.

Cette procédure suppose que vous avez placé un composant avec un paramètre prédéfini sur la page et que vous avez configuré un contrôleur. Pour obtenir des instructions, consultez Ajouter un contrôleur.

L’onglet Configuration affiche les valeurs de propriété prédéfinies comme chemin d’accès à la sortie du contrôleur. Le chemin d’accès aux données de base est exprimé par @data.<controller_name>. Le reste du chemin est construit à l’aide du contenu des catégories de la hiérarchie des données du contrôleur. Vous pouvez utiliser ce chemin d’accès pour afficher les valeurs actuelles de l’enregistrement pour lequel le contrôleur a été configuré.

1. Pour afficher les ressources de données d’un composant, sélectionnez l’icône de données dans la barre latérale inférieure gauche.

   

   L’inspecteur de données UIB à trois colonnes s’affiche.

2. Dans la première colonne où les ressources de données sont répertoriées, sélectionnez le contrôleur dont vous souhaitez afficher la sortie.
   Les données de configuration pour le contrôleur sélectionné apparaissent dans l’onglet Configuration de la deuxième colonne. Il s’agit des propriétés d’entrée que vous avez saisies lorsque vous avez configuré le contrôleur pour le premier composant avec un paramètre prédéfini que vous avez placé sur la page. Vous pouvez modifier ces valeurs de connexion ici si vous le souhaitez.

   Remarque :

   La configuration de -1 pour la valeur du champ ID système configure le contrôleur pour un nouvel enregistrement. Le contrôleur génère ensuite un GUID complet que vous pouvez utiliser pour stocker les données de l’enregistrement avant son enregistrement. Cela vous permet d’effectuer des actions dans un enregistrement nouvellement créé, telles que l’enregistrement de pièces jointes.
   
   
   
3. Sélectionnez les sorties de niveau supérieur dans la troisième colonne.

   Il s’agit du niveau parent de la hiérarchie des données du contrôleur, indiqué par le préfixe @data., suivi de l’ID du contrôleur. Cette combinaison constitue le chemin d’accès racine aux données. Les données contenues dans les sorties de niveau supérieur sont affichées dans le champ de code adjacent et sont disponibles pour les paramètres prédéfinis et les scripts à utiliser. D’autres propriétés de ce niveau sont des propriétés communes qui s’appliquent à tous les enregistrements.

   

   Lorsque le paramètre prédéfini mappe une propriété de composant à la sortie du contrôleur, le chemin vers la sortie est affiché à la place de la valeur. Les chemins d’accès sont notés @data.<ID du contrôleur>.<chemin d’accès du niveau supérieur à la propriété de sortie> et peuvent être utilisés comme valeurs ou dans le cadre d’expressions de formule.

   Dans cet exemple, le mappage dans le paramètre prédéfini entraîne un chemin d’accès à @data.gform.table.

   
   
   
4. Pour afficher les données sous le niveau supérieur, sélectionnez la catégorie enfant indiquée par le chemin d’accès dans la valeur de propriété prédéfinie.

   Le nom de la catégorie enfant apparaît dans le chemin d’accès sous la forme @data.<ID du contrôleur>.<category>. Les données de cette catégorie sont ensuite ajoutées à ce chemin. Le chemin d’accès racine au-dessus du champ de code indique la catégorie enfant utilisée. Dans cet exemple, le chemin d’accès à la propriété View dans la catégorie de formulaire est exprimé sous la forme @data.gform.form.view. Cette valeur prédéfinie affiche les formulaires dans la vue de l’espace de travail .

   
   
   

   Dans cet exemple, plusieurs propriétés de sortie de contrôleur sont utilisées dans une expression de formule pour construire un objet.

   
   
   
5. Pour afficher une valeur de propriété scriptée, sélectionnez l’icône de verrou en regard de la propriété.

   Cela met la propriété en mode d’édition et ouvre un modal pour modifier le script.

   

Afficher les événements dans l’API du contrôleur

Vous pouvez afficher les événements traités mappés à un composant par un paramètre prédéfini et leurs charges utiles dans l’onglet Événements du panneau de configuration du générateur d’IU. Si le mappage de données d’un événement n’est pas approprié pour votre cas d’utilisation, vous pouvez ajouter des gestionnaires de données supplémentaires.

Remarque :

Les mappages de gestionnaire de données fournis avec le paramètre prédéfini ne sont pas modifiables.

1. Sélectionnez l’onglet Événements dans le générateur d’IU.
2. Pour afficher le mappage d’un événement prédéfini, sélectionnez la vignette de l’événement.

   Une fenêtre modale s’affiche affichant les propriétés de charge utile pour l’événement prédéfini. Vous pouvez désactiver l’événement dans ce modal.

   
   
   
3. Pour ajouter un gestionnaire d’événements à l’événement, sélectionnez + Ajouter un gestionnaire d’événements sous la vignette de l’événement.
   
   
   

   Une fenêtre modale s’affiche, affichant une liste des événements disponibles et gérés. Vous pouvez sélectionner n’importe quelle action dans la liste, y compris un gestionnaire d’événements de l’un des contrôleurs répertoriés.

4. Sélectionnez un gestionnaire d’événements dans la liste et sélectionnez Ajouter.

   Le nouveau gestionnaire est répertorié sous la vignette de l’événement.