Ajouter des déclencheurs d’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 les widgets.

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 plus spécifiques entre les widgets en configurant les actions en réponse à des déclencheurs. Par exemple, vous pouvez définir des actions pour un widget Map (Carte) qui déclenche des modifications de contenu dans les widgets List (Liste) et Feature Info (Informations sur les entités). Vous pouvez filtrer les enregistrements de widget List (Liste) pour n’afficher que ceux qui apparaissent dans l’étendue actuelle d’un widget Map (Carte) ou synchroniser l'étendue de deux widgets Map (Carte) lorsque les utilisateurs zooment sur l’un deux ou le déplacent.

Structure des interactions

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

• Les déclencheurs du widget source
• Les cibles qui répondent au déclencheur et notamment 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 deux déclencheurs actuellement pris en charge :

Déclencheur	Description
Extent Changes (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.
Record Selection Changes (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é.

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	Extent Changes (Modifications d’étendue)	Record Selection Changes (Modifications de sélection d’enregistrements)
Cartographier
Liste
Feature Info (Informations sur les entités)

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 un widget List (Liste) et que le déclencheur est basé sur des données différentes, vous pouvez filtrer la liste 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	Action*	Déclencheur : Record Selection Changes (Modifications de sélection d’enregistrements)	Déclencheur : Extent Changes (Modifications d’étendue)
Structure	Filter Data Records (Filtrer les enregistrements de données) : ne conservez que les 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)** : marquez les enregistrements comme sélectionnés.
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) : zoomez sur une localisation spécifiée.
	Flash (Clignoter) : faites clignoter une entité sur la carte.
	Filter (Filtrer) : ne conservez que les données qui remplissent les conditions d’affichage dans le widget.
Widget de liste	Filter (Filtrer) : ne conservez que les données qui remplissent les conditions d’affichage dans le widget.
Widget Feature Info (Informations sur les entités)	Display feature (Afficher l’entité) : affichez des informations contextuelles sur l’entité sélectionnée.

*Les actions de structure affectent tout widget qui utilise les données configurées dans l’action ; les actions de widget n’affectent que le widget cible.

**L’état sélectionné d’un enregistrement est synchronisé dans toute l’application. La configuration des widgets peut différer pour l’affichage d’un enregistrement sélectionné.

Configurer et gérer les interactions

Configurez les interactions dans l’onglet Action (Action) des widgets source (widgets qui fournissent les déclencheurs). Ajoutez et sélectionnez le déclencheur, sélectionnez la cible, puis ajoutez et sélectionnez les actions. Chaque déclencheur ne peut être ajouté qu'une seule fois, mais vous pouvez ajouter plusieurs actions pour un même déclencheur en cliquant sur Add action (Ajouter une action). Les actions d’un même déclencheur sont effectuées dans l’ordre. Faites glisser les actions regroupées sous un déclencheur pour modifier l’ordre.

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. Une fois la configuration terminée, vous pourrez modifier les paramètres ultérieurement en cliquant sur le bouton Settings (Paramètres) de l’action. Pour modifier une action ou une cible une fois que vous avez ajouté une action, vous devez la supprimer, puis en ajouter une nouvelle. La suppression d’un déclencheur supprime également toutes les actions qui y ont été ajoutées.

Exemple d'utilisation

Ajoutez des déclencheurs d’action 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 (Filtrer) du widget List (Liste) et configurer l’action avec une relation spatiale à l’étendue.
• Vous affichez les entités dans un widget Map (Carte) et souhaitez afficher les détails d’une entité sélectionnée dans un widget Feature Info (Informations sur les entités). Vous pouvez ajouter un déclencheur Record Selection Changes (Modifications de sélection d’enregistrements) au widget Map (Carte), sélectionner le widget Feature Info (Informations sur les entités) comme cible et choisir l’action Display feature (Afficher l’entité).