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 un widget et la structure (source de données) ;
• 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 entre un widget et les données en configurant les actions en réponse à des déclencheurs. Il est ainsi possible de créer une interaction selon laquelle, à chaque changement de l’étendue du widget Carte, les autres widgets (comme le widget Liste) sont filtrés de manière à n’afficher que les entités comprises dans l’étendue actuelle. Cela suppose de définir comme déclencheur le changement d’étendue dans le widget Carte et comme action, l’enregistrement de filtre dans la visualisation de données utilisée par le widget Liste. Étant donné que les widgets sont dépendants des données, l’action de filtre s’applique au niveau de la structure et des données pour que tous les widgets qui utilisent la même visualisation de données soient synchronisés automatiquement. Vous pouvez également définir des interactions entre les widgets. Les actions provenant d’un widget sont suivies d’effets uniquement au sein de celui-ci. Par exemple, pour synchroniser l’étendue de deux widgets Carte lorsque les utilisateurs appliquent un zoom ou un déplacement sur l’un d’eux, vous devez définir le changement d’étendue d’un widget Carte comme déclencheur et le changement d’étendue de l’autre widget Carte comme action.

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)
Carte
Feature Info (Informations sur les entités)
Liste
Table

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 :

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 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)** : 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) : 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.

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

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 pouvez modifier les paramètres ultérieurement en cliquant sur le bouton Settings (Paramètres) . 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 Carte, sélectionner l’action Filter Data Records (Filtrer les enregistrements de données) de la structure, choisir les données d’action comme visualisation de données configurée dans les paramètre List (Liste) et configurer l’action avec une relation spatiale à l’étendue.