Actions dans Générateur d'IU

Les actions d’interface utilisateur indiquent Générateur d'IU ce qu’il faut faire lorsqu’un événement est déclenché. Un événement est une action effectuée par un utilisateur ou une occurrence qui se produit sur une page. Utilisez les actions d’interface utilisateur pour créer des interfaces interactives et conviviales qui aident vos utilisateurs à accomplir des tâches. Chaque composant a ses propres événements qui lui sont associés. Les événements comprennent :

Événements dans Générateur d'IU

Utilisez un événement pour ajouter des actions à vos composants, pages et ressources de données.

• Un événement de composant est une action que vous configurez pour un composant. Vous configurez un gestionnaire d’événements pour configurer l’action de ce composant. Par exemple, vous pouvez ajouter un composant de bouton à votre Générateur d'IU page. Ensuite, vous pouvez ajouter un gestionnaire d’événements pour appliquer une action à ce bouton, par exemple en accédant à une page Web.
• Les événements de page effectuent des actions pour l’ensemble de la page. Vous pouvez configurer les événements de page suivants :
  • Mappages d’événements de page. Ajoutez, supprimez ou désactivez les notifications d’alerte sur votre page.
  • Mappages d’événements de variantes. Ajoutez, supprimez ou désactivez les notifications d’alerte sur votre variante de page.
  • Événements expédiés. Créez des événements répartis pour que votre page crée des mappages d’événements relayés qui modélisent les événements après un gestionnaire d’événements parent. Sélectionnez un gestionnaire d’événements parent cible pour modéliser les champs de charge utile après celui-ci.
  • Événements traités. Un événement géré est un événement qui est exposé et disponible pour utilisation par d’autres utilisateurs. Une fois que vous avez créé un événement géré, il est disponible sous et peut être utilisé par Page event mappings d’autres utilisateurs. Vous pouvez également configurer des champs de charge utile que vous créez manuellement ou choisir un modèle pour votre événement géré, comme une boîte de dialogue modale d’ouverture ou de fermeture.
• Les événements des ressources de données mappent les ressources de données pour notifier des informations sur le moment où les données sont extraites.
• Les événements d’une page ou d’un composant ne font rien tant que l’événement n’est pas mappé à un ou plusieurs gestionnaires d’événements.

Mappage d’événements dans Générateur d'IU

Mappez les actions sur des événements tels que le clic sur un bouton ou le remplissage d’un champ. Un mappage d’événements est le processus qui vous permet de mapper la charge utile ou les valeurs contextuelles d’un événement à l’objet ou au gestionnaire qui agit sur cet événement.

Pour en savoir plus sur le mappage d’événements, reportez-vous à Définir des événements de carte.

Gestionnaires d’événements dans Générateur d'IU

Lorsque vous ajoutez un gestionnaire d’événements à une page ou à un Générateur d'IU composant, vous pouvez choisir différents types de gestionnaires d’événements. Par exemple, un composant de bouton peut avoir les types suivants de gestionnaires d’événements :

• Gestionnaires d’événements hérités. Un gestionnaire d’événements hérité est exposé à partir de la page dans laquelle vous travaillez. Si vous êtes sur la page parente Générateur d'IU , un gestionnaire d’événements hérité peut être exposé à partir de l’interpréteur de commandes de l’application. La table suivante répertorie les différents types de gestionnaires d’événements hérités que vous pouvez utiliser et ce que vous pouvez en faire.

  Tableau 1. Gestionnaires d'événements hérités

  Gestionnaire d'événements	Description
  URL du fil d’Ariane modifiée
  Lien vers destination	Naviguez jusqu’à une destination. Routages d’applications : lien vers une autre page d’une application, comme un écran d’accueil. URL externe : Lien vers un site Web ou toute autre URL externe. Exemple de script return { route: null, /* Page route, e.g. 'record' */ fields: null, /* Required params, e.g. {"table":"incident","sysId":"X"} */ params: null, /* Optional params, e.g. {"selectedIndex" : 1} */ ☑️redirect: null, /* ??? True/false? */ ☑️passiveNavigation: null, /* Load in background, e.g. 'false' */ title: null, multiInstField: null, ☑️targetRoute: null, /* ??? */ ☑️external: null /* ??? True/false? */ };
  Ajouter des paramètres à l'URL	Ajoutez des paramètres supplémentaires à une URL. Exemple de script { “selectedTabIndex” : 0 }
  Ouvrir ou fermer la boîte de dialogue modale	Après avoir créé un modal, utilisez-le Open or close modal dialog pour déclencher le modal.

• Gestionnaires d’événements au niveau de la page. Ce type de gestionnaire d’événements est commun à toutes les pages, et vous pouvez utiliser ce type de gestionnaire lorsque vous souhaitez ajouter ou supprimer des notifications d’alerte au niveau de la page. Le tableau suivant répertorie les différents types de gestionnaires d’événements au niveau de la page que vous pouvez utiliser et ce que vous pouvez en faire.

  Tableau 2. Gestionnaires d'événements au niveau de la page

  Gestionnaire d'événements	Description
  Ajouter des notifications d'alerte	Ajoutez un extrait de code pour envoyer une notification d’alerte. Par exemple : return { items: [{"type" : "info", "message" : "Info message", "id" : "optionalID"}] /* Types: info, warning, error */ };
  Supprimer la notification d’alerte	Ajoutez un code pour appeler les ID de notification d’alerte que vous souhaitez ignorer. Par exemple, cliquez sur un bouton pour supprimer une notification d’alerte de chargement de page.
  Effacer la notification d’alerte	Ajoutez un code pour appeler tous les ID de notification d’alerte que vous souhaitez ignorer. Par exemple, cliquez sur un bouton pour supprimer toutes les notifications d’alerte.
  Définir l'état de chargement	Activer/désactiver le chargement. Par exemple, vous pouvez activer le chargement pour charger la page lorsque vous cliquez sur un bouton ou désactiver le chargement pour ne pas charger la page lorsque vous cliquez sur un bouton.
  Mettre à jour le paramètre de l'état du client	Définissez de manière déclarative le paramètre de l’état du client. Supposons que vous ayez un paramètre d’état client que vous configurez avec une valeur. Vous pouvez configurer le gestionnaire d’événements Update client state parameter pour mettre à jour le paramètre d’état du client avec une nouvelle valeur. Par exemple, vous avez un paramètre d’état du client appelé Salutation qui est configuré avec Bonjour comme valeur initiale. Vous pouvez ajouter un gestionnaire d’événements Update client state parameter , sélectionner le paramètre d’état du client Message d’accueil , puis saisir une nouvelle valeur comme Au revoir. Lorsque vous cliquez sur le bouton, Goodbye remplace Hello sur la page.
  Chargement de la fenêtre du macroponent UXF demandé	Ajoutez à un composant, tel qu’un composant de bouton, pour ouvrir une fenêtre d’affichage. Pour plus d'informations, consultez Ajouter un composant Viewport à votre page.

• Gestionnaires des ressources de données. Ce type de gestionnaire d’événements déclenche la récupération ou l’écriture de données dans le serveur.
  Vous pouvez actualiser les données de source de données de l’interpréteur de commandes d’application sur votre Générateur d'IU page en cliquant sur un bouton. Par exemple, avec un gestionnaire de ressources de données, vous pouvez effectuer les actions suivantes :

  • Lier les données à la description d’un enregistrement d’incident.
  • Modifiez la valeur de la description de l’incident.
  • Ajoutez un composant de bouton à votre page.
  • Étiquetez le bouton comme Actualiser l’incident.
  • Ajoutez un Look Up Record gestionnaire d’événements pour le bouton.
  • Enregistrez votre page.
  • Si la description de l’enregistrement d’incident change, cliquez sur Actualiser pour mettre à jour la description sur votre page.
• Scripts clients. Scripts qui s’exécutent lorsqu’un événement est déclenché sur un composant. Vous créez ces scripts dans la section Scripts clients de .Générateur d'IU Pour plus d'informations, consultez Définir des scripts clients et les lier aux composants.

Liaison d’événements à des composants dans Générateur d'IU

Lier les gestionnaires d’événements aux événements d’un composant. Lorsque vous ajoutez des composants à votre Générateur d'IU page, ces composants ne sont pas configurés pour effectuer une action sur votre page. Par exemple, un composant de bouton est statique et ne fait rien tant que vous ne lui avez pas lié une action d’événement, comme la suppression d’un enregistrement. Certains composants ont plusieurs événements dans lesquels des gestionnaires d’événements peuvent être affectés. Par exemple, dans le composant de liste, vous pouvez affecter un gestionnaire de navigation à l’événement Row clicked . Vous pouvez également affecter une fenêtre modale ouverte à l’événement Data fetch failed . Pour plus d'informations, consultez Lier un événement à un composant.

Liaison d’événements à des pages du générateur d’IU

Lier un événement au niveau de la page pour exécuter des gestionnaires d’événements sur la page. Par exemple, utilisez des événements au niveau de la page pour les notifications de page, le chargement de la page ou lorsqu’une propriété de page change. L’affectation du gestionnaire d’événements à l’événement au niveau de la page est similaire à l’affectation de gestionnaires à des événements à partir de composants.

Liaison d’événements aux ressources de données dans Générateur d'IU

Liez les gestionnaires d’événements aux ressources de données individuelles de votre Générateur d'IU page. Par exemple, lorsqu’une ressource de données extrait avec succès de nouvelles données, elle exécute un gestionnaire d’événements, comme la navigation, pour amener un utilisateur à l’étape suivante d’un flux. Lorsqu’une ressource de données ajoute avec succès un enregistrement à une table, elle affiche un modal de réussite qui utilise le gestionnaire d’événements show modal. Pour plus d'informations, consultez Lier un événement à une ressource de données.

Lier des événements à des actions déclaratives dans Générateur d'IU

Liez des éléments de données pour ajouter des actions d’événements à une définition d’action déclarative dans Actions et composants du Now Platform®. Par exemple, vous pouvez lier un élément de données pour ajouter une action d’événement afin de terminer le travail sur une table.

Si vous ajoutez un composant à votre Générateur d'IU page qui a une action déclarative, vous devez le lier à un événement géré. L’événement géré crée une action qui est effectuée lorsqu’un utilisateur sélectionne le composant. En sélectionnant Configurer le mappage des événements de l’action déclarative, vous ajoutez un nouveau gestionnaire d’événements pour définir ce que l’action déclarative effectue sur la page.

Pour plus d'informations, consultez Lier un événement à une action déclarative.