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éclencheur	Description
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 source	Modifications de filtrage des données	Modifications d’étendue	Modifications de sélection d’enregistrements	Enregistrements créés
Diagramme
Feature Info (Informations sur les entités)
Filtrer
Liste
Carte
Requête
Rechercher
Tableau

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 :

Cible	Action1	Déclencheur : modifications de filtrage des données	Déclencheur : modifications de sélection d’enregistrements	Déclencheur : modifications d’étendue	Dé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.
	Select Data Records (Sélectionner des enregistrements de données)2 : marquez les enregistrements comme sélectionnés et placez-les dans la vue Selected features (Entités sélectionnées).
Widget cartographique	Pan to (Déplacer sur) : conservez l’échelle actuelle et centrez l’écran sur une localisation spécifiée.
	Zoom to (Zoom sur)3 : zoomez sur une localisation spécifiée.
	Flash (Clignoter) : faites clignoter une entité sur la carte.
	Filter (Filtrer) : ne conservez que les entités qui remplissent les conditions d’affichage dans le widget de carte.
	Show on map (Afficher sur la carte)4 : affichez les enregistrements créés sur la carte en tant que nouvelle couche.

¹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é.

³Lorsque vous ajoutez une action Zoom to (Zoom sur), vous pouvez modifier les paramètres Zoom scale (Échelle de zoom) dans la fenêtre Action settings (Paramètres de l’action). Choisissez Custom (Personnaliser) pour ajuster le niveau de zoom de la carte, ou choisissez Automatic (Automatique) pour utiliser l’échelle par défaut de la carte.

⁴Lorsque vous ajoutez une action Show on map (Afficher sur la carte), vous pouvez personnaliser les symboles des enregistrements créés. Choisissez Use custom symbols (Utiliser les symboles personnalisés) afin de personnaliser le remplissage, le contour, la transparence et davantage pour les points, les lignes et les polygones. Choisissez Use layer defined symbols (Utiliser les symboles définis par la couche) pour utiliser les symboles des couches associées à l’action actuelle dans le widget source.

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.

*Lorsque vous ajoutez une action Show on map (Afficher sur la carte), vous pouvez personnaliser les symboles des enregistrements créés.

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.

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.