Ajouter des actions à des widgets

Vous pouvez effectuer les opérations suivantes pour créer des applications dynamiques et interactives avec Experience Builder :

  • connecter des widgets à des données et les configurer avec un contenu dynamique ;
  • configurer des interactions entre un widget et la structure (source de données) ;
  • configurer des interactions entre les widgets.

Vous pouvez ajouter deux types d’actions à des widgets : les actions Messages et les actions Données. Les actions Messages écoutent les déclencheurs et exécutent automatiquement des actions, telles que le filtrage d’une liste pour afficher uniquement les enregistrements de l’étendue actuelle d’une carte. Les actions Données fournissent un bouton Actions sur lequel les utilisateurs finaux peuvent cliquer dans les widgets au moment de l’exécution, afin de sélectionner les actions à effectuer dans une liste, telles que l’exportation d’enregistrements vers un fichier.

Actions Messages

Les applications Experience Builder sont axées sur les données, ce qui signifie que les données affichées par les widgets peuvent changer de manière universelle lors des mises à jour des données sous-jacentes. Vous pouvez définir des interactions entre un widget et les données en configurant des actions Messages en réponse à des déclencheurs. Il est ainsi possible de créer une interaction selon laquelle, à chaque changement de l’étendue du widget Map (Carte), les autres widgets (comme le widget List (Liste)) sont filtrés de manière à n’afficher que les entités comprises dans l’étendue actuelle. Pour ce faire, définissez Extent changes (Modifications d’étendue) dans le widget Map (Carte) en tant que déclencheur et Filter data records (Filtrer les enregistrements de données) dans la vue de données utilisée comme action par la liste. Étant donné que les widgets sont axés sur les données, l’action de filtre s’applique aux données au niveau de la structure et tous les widgets qui utilisent la même vue de données sont automatiquement synchronisés. Vous pouvez également définir des interactions entre les widgets. Les actions provenant d’un widget sont suivies d’effets uniquement dans ce widget. Par exemple, pour synchroniser l’étendue de deux widgets Map (Carte) lorsque les utilisateurs appliquent un zoom ou un déplacement sur l’un d’eux, vous devez définir Extent changes (Modifications d’étendue) d’un widget Map (Carte) comme déclencheur et le changement d’étendue de l’autre widget Map (Carte) comme action.

Ces interactions sont définies et gérées dans la fenêtre Action du widget source qui fournit les déclencheurs. Les configurations de type Message action (Action Messages) possèdent trois composants :

  • Les déclencheurs du widget source
  • Les cibles qui répondent au déclencheur (les widgets et la structure de l’application)
  • Les actions de la cible associée à son utilisation prévue

Le déclencheur du widget source ne peut être ajouté qu’une seule fois, mais vous pouvez ajouter plusieurs actions pour ce déclencheur spécifique à partir d’une même cible ou d’une cible différente.

Déclencheur

Les déclencheurs sont des événements générés par le widget source. Une fois qu’un déclencheur a été activé, les actions qui y sont ajoutées sont exécutées en réponse. Le tableau suivant décrit les quatre déclencheurs actuellement pris en charge :

DéclencheurDescription

Modifications de filtrage des données

Un déclencheur survient lorsqu’un filtre est appliqué à la source de données.

Modifications d’étendue

Un déclencheur est activé lorsque l’étendue de la carte est modifiée par l’intermédiaire d’un déplacement, d’un zoom, d’un redimensionnement, etc.

Modifications de sélection d’enregistrements

Un déclencheur est activé lorsqu’un enregistrement est sélectionné ou qu'un enregistrement sélectionné est effacé.

Enregistrements créés

Un déclencheur survient lorsque des enregistrements de résultat sont chargés dans le widget source.

Pour afficher les déclencheurs disponibles d’un widget, ouvrez ses paramètres et cliquez sur Add a trigger (Ajouter un déclencheur) dans l’onglet Action (Action). Le tableau suivant répertorie les widgets source et les déclencheurs qu’ils prennent en charge :

Widget sourceModifications de filtrage des donnéesModifications d’étendueModifications de sélection d’enregistrementsEnregistrements créés

Diagramme

Oui

Feature Info (Informations sur les entités)

Oui

Filtrer

Oui

Liste

Oui

Carte

Oui

Oui

Requête

Oui

Oui

Rechercher

Oui

Oui

Oui

Tableau

Oui

Cibles

Les cibles effectuent des actions. Une cible peut correspondre à un widget ou à la structure. Si vous choisissez la structure comme cible, l’action est effectuée globalement dans tous les widgets et pages pertinents de l’application.

Actions

Contrairement aux déclencheurs définis par la structure, les actions sont fournies par les cibles (en particulier les widgets) pour effectuer une logique métier spécifique. Certaines actions peuvent nécessiter une configuration supplémentaire suivant la manière dont la cible traite le message du déclencheur. Par exemple, si vous configurez une action de filtre pour une visualisation de données et que le déclencheur est basé sur des données différentes, vous pouvez filtrer la visualisation de données cibles en établissant une relation spatiale ou attributaire. Vous pouvez également définir des conditions SQL.

Des cibles différentes fournissent des actions différentes qui correspondent à des déclencheurs différents. Les actions disponibles apparaissent une fois que vous avez ajouté un déclencheur et que vous avez sélectionné la cible. Le tableau suivant répertorie les cibles et leurs actions correspondantes :

CibleAction*Déclencheur : modifications de filtrage des donnéesDéclencheur : modifications de sélection d’enregistrementsDéclencheur : modifications d’étendueDéclencheur : enregistrements créés

Structure

Filter Data Records (Filtrer les enregistrements de données) : ne conservez que les enregistrements de la visualisation de données qui remplissent les conditions d’un affichage ou d’un traitement supplémentaire dans l’application.

Oui

Oui

Select Data Records (Sélectionner des enregistrements de données)** : marquez les enregistrements comme sélectionnés et placez-les dans la vue Selected features (Entités sélectionnées).

Oui

Widget cartographique

Pan to (Déplacer sur) : conservez l’échelle actuelle et centrez l’écran sur une localisation spécifiée.

Oui

Oui

Oui

Oui

Zoom to (Zoom sur) : zoomez sur une localisation spécifiée.

Oui

Oui

Oui

Oui

Flash (Clignoter) : faites clignoter une entité sur la carte.

Oui

Filter (Filtrer) : ne conservez que les entités qui remplissent les conditions d’affichage dans le widget de carte.

Oui

Show on map (Afficher sur la carte) : affiche les enregistrements créés sur la carte en tant que nouvelle couche.

Oui

*Si les données d’action sont la vue par défaut, les actions de structure affectent tous les widgets qui utilisent les données et leurs vues. Si les données d’action sont une vue spécifique, les actions affectent uniquement les widgets qui utilisent cette vue. Les actions de widget visent uniquement le widget cible. (Par exemple, l’action de filtre de carte ne filtre que les enregistrements de la carte, sans incidence sur les autres widgets qui utilisent la même couche.)

**L’état sélectionné d’un enregistrement est synchronisé dans toute l’application, et les enregistrements sélectionnés sont enregistrés dans la vue Selected features (Entités sélectionnées) des données. La configuration des widgets peut différer pour l’affichage d’un enregistrement sélectionné.

Actions Données

Vous pouvez configurer les actions Données pour que les utilisateurs finaux traitent les données dans l’application au moment de l’exécution. Ils peuvent cliquer sur le bouton Actions dans les widgets source et choisir de transmettre un jeu de données à un widget spécifique (par exemple, pour afficher les résultats de la requête dans une table) ou à la structure de l’application (pour exporter des données).

Ces interactions sont définies et gérées dans la fenêtre Action du widget source qui fournit le jeu de données d’exécution. Les configurations d’action de données possèdent deux composants :

  • Les cibles qui reçoivent le jeu de données (les widgets et la structure de l’application)
  • Les actions Données fournies par la cible, qui sont exécutées uniquement lorsque les utilisateurs finaux le décident

Le jeu de données transmis à la cible varie en fonction du widget source. Par exemple, le widget List (Liste) peut uniquement transmettre les enregistrements sélectionnés au widget Table, tandis que le widget Chart (Diagramme) transmet toutes les données statistiques au widget Table, qu’une sélection ait été effectuée ou non. Le tableau suivant répertorie les widgets source disponibles, les cibles et les actions Données prises en charge (cible : action Données), ainsi que le jeu de données que chaque widget source transmet pour chaque action applicable.

Widget sourceStructure : ExporterCarte : Zoom surCarte : DéplacerCarte : Afficher sur la carteTable : Afficher dans la table

Diagramme

Tous les enregistrements ou enregistrements sélectionnés (données statistiques)

N/D

N/D

N/D

Tous les enregistrements (données statistiques)

Feature Info (Informations sur les entités)

Sélection

Sélection

Sélection

Sélection

Sélection

Liste

Tous les enregistrements ou enregistrements sélectionnés

Sélection

Sélection

Sélection

Sélection

Requête

Tous les enregistrements ou enregistrements sélectionnés (résultat de la requête)

Tous les enregistrements (résultat de la requête)

Tous les enregistrements (résultat de la requête)

Tous les enregistrements (résultat de la requête)

Tous les enregistrements (résultat de la requête)

Tableau

Tous les enregistrements ou enregistrements sélectionnés

Sélection

Sélection

Sélection

N/D

Lorqu’une action Données est effectuée sur un widget cible, ce dernier inclut un bouton pour l’effacer. Par exemple, lorsqu’un utilisateur final sélectionne des données dans un widget List (Liste) et choisit d’afficher la sélection dans un widget Table, un bouton apparaît en regard de la nouvelle feuille, qui permet de supprimer la feuille de la table. De même, lorsqu’ils choisit l’action Données Show on map (Afficher sur la carte), un bouton apparaît dans la carte pour l’effacer de cette dernière. (L’actualisation de la page efface tous les résultats de l’action Données.)

Configurer des interactions

Configurez des actions Messages et Données dans la fenêtre Action des widgets source.

Configurer des actions Messages

Les actions Messages sont configurées dans les paramètres des widgets source (les widgets qui fournissent des déclencheurs).

  1. Dans la fenêtre Action, sur l’onglet Message action (Action Messages), cliquez sur Add a trigger (Ajouter un déclencheur).
  2. Sélectionnez le déclencheur, sélectionnez la cible, puis ajoutez et sélectionnez les actions.

    Certaines actions, telles que Filter (Filtrer), Flash (Clignoter) et Select Data Records (Sélectionner des enregistrements de données), requièrent une configuration supplémentaire. Les options Action settings (Paramètres d’action) apparaissent lorsque vous sélectionnez l’action. Chaque déclencheur ne peut être ajouté qu’une seule fois.

  3. Pour ajouter plusieurs actions pour un même déclencheur, cliquez sur Add action (Ajouter une action).

    Les actions d’un même déclencheur sont effectuées dans l’ordre.

  4. Faites glisser les actions regroupées sous un déclencheur pour modifier l’ordre.
  5. Pour modifier ces paramètres configurés ultérieurement, cliquez sur le bouton Settings (Paramètres) Settings (Paramètres) de l’action.
  6. Pour modifier une action ou une cible une fois que vous avez ajouté une action, supprimez-la, puis ajoutez-en une nouvelle.

    La suppression d’un déclencheur supprime également toutes les actions qui y ont été ajoutées.

Configurer des actions Données

Les actions Données sont configurées dans les paramètres des widgets source, à l’exception de l’action Export (Exporter), qui est configurée pour la source de données dans la fenêtre Data (Données). Les actions Données sont activées par défaut, et le bouton Actions du widget inclut automatiquement toutes ses actions Données disponibles.

  1. Dans la fenêtre Action, sur l’onglet Data action (Action Données), décochez ou cochez les actions Données pour spécifier les options du menu d’actions du widget. Vous pouvez également désactiver Enable data action (Activer l’action Données) pour exclure le bouton Actions du widget.
  2. Pour chaque action Données cochée, sélectionnez les widgets cible avec lesquels le widget source doit interagir, comme un widget Map (Carte).

    Vous pouvez uniquement sélectionner des widgets cible qui se trouvent sur la même page que le widget source.

    Remarque :

    Lorsque vous ajoutez un widget cible à une page, ses actions Données correspondantes sont automatiquement ajoutées aux widgets source disponibles sur la même page.

    Conseil :

    Pour optimiser les résultats, positionnez le widget source à côté du widget cible car les actions Données n’atteignent pas l’emplacement cible dans l’application.

  3. Pour exclure l’action Données Export (Exporter), accédez à la fenêtre Data (Données) et désactivez Allow export (Autoriser l’exportation) pour la source de données.

Exemple d'utilisation

Ajoutez des actions Messages pour prendre en charge les exigences de conception d’application, telles que les suivantes :

  • Vous souhaitez créer une application qui compare deux cartes, deux scènes ou une carte et une scène. Les étendues des deux widgets Map (Carte) doivent donc toujours être synchronisées. Vous pouvez ajouter un déclencheur Extent Changes (Modifications d’étendue) aux deux widgets, sélectionner l’autre widget comme cible de chacun et sélectionner l’action Pan to (Déplacer sur) ou Zoom to (Zoom sur).
  • Vous ajoutez un widget List (Liste) en regard d’un widget Map (Carte) et souhaitez que la liste ne contienne que les enregistrements de l’étendue actuelle de la carte. Vous pouvez ajouter un déclencheur Extent Changes (Modifications d’étendue) au widget Map (Carte), sélectionner l’action Filter Data Records (Filtrer les enregistrements de données) de la structure, choisir les données d’action comme vue de données configurée dans les paramètres du widget List (Liste) et configurer l’action avec une relation spatiale à l’étendue.

Utilisez des actions Données pour prendre en charge les exigences de conception d’application, telles que les suivantes :

  • Vous ajoutez un widget Chart (Diagramme) pour représenter un ensemble de données numériques ou qualitatives sous forme de diagramme et vous voulez donner à l’utilisateur final la possibilité d’afficher les données statistiques générées par le diagramme dans un widget Table. Lorsque vous ajoutez un widget Table à côté du widget Chart (Diagramme), l’action Données View in table (Afficher dans la table) est automatiquement ajoutée au widget Chart (Diagramme). Au moment de l’exécution, l’utilisateur final peut cliquer sur le bouton Actions dans le widget Chart (Diagramme) et sélectionner View in table (Afficher dans la table) pour afficher les données statistiques dans le widget Table.
  • Vous ajoutez un widget List (Liste) pour afficher un enregistrement de données et un widget Map (Carte) pour afficher un autre enregistrement de données différent. Vous voulez offrir la possibilité à l’utilisateur final d’afficher une entité sur la carte qui correspond à un enregistrement sélectionné dans la liste pour comparer différentes données sur une carte. Au moment de l’exécution, l’utilisateur final peut cliquer sur le bouton Actions dans le widget List (Liste) et sélectionner Show on map (Afficher sur la carte).
  • Vous affichez les enregistrements de données dans un widget Table et voulez que les utilisateurs finaux aient la possibilité d’exporter les données. Lorsque l’option Allow export (Autoriser l’exportation) est activée pour la source de données, ils peuvent cliquer sur le bouton Actions dans le widget Table et choisir d’exporter les enregistrements sélectionnés ou la totalité des enregistrements (5 000 au maximum).