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 répondent aux 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 peuvent cliquer dans les widgets au moment de l’exécution et qu’ils peuvent sélectionner dans une liste d’actions à effectuer, telles que l’exportation d’enregistrements vers un fichier ou en tant qu’élément ArcGIS.

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) en tant qu’action dans la visualisation de données utilisée par le widget List (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éclencheurs

Les déclencheurs sont des événements générés par le widget source. Une fois qu’un déclencheur survient, les actions qui y sont ajoutées sont exécutées en réponse. La table suivante décrit les sept déclencheurs actuellement pris en charge :

Déclencheur	Description
Clic d’un bouton	Un déclencheur survient lors d’un clic sur le widget Bouton ou lors d’un clic sur le bouton du widget Navigateur de vues.
Données ajoutées	Un déclencheur survient lorsqu’une source de données est ajoutée avec le widget Ajouter des données.
Modifications de filtrage des données^1	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.
Enregistrements créés	Un déclencheur survient lorsque des enregistrements de résultat sont chargés dans le widget source.
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é.
Modification des vues	Un déclencheur survient lorsqu’une vue est sélectionnée avec le widget Views Navigation (Navigateur de vues).

¹L’action Data filtering changes (Modifications de filtrage des données) ne prend pas en charge les couches d’imagerie dynamique.

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	Clic d’un bouton	Données ajoutées	Modifications de filtrage des données	Modifications d’étendue	Modifications de sélection d’enregistrements	Enregistrements créés	Modification des vues
Ajouter des données
Bouton
Diagramme
Feature Info (Informations sur les entités)
Filtrer
Liste
Carte
Autour de moi
Requête
Rechercher
Sélectionner
Tableau
Traçage de réseau de distribution
Navigateur de vues

Attention :

La sélection d’un grand nombre d’entités avec le widget Chart (Diagramme) ou Map (Carte) peut submerger le déclencheur Record selection changes (Modifications de sélection d’enregistrements) et entraîner la non-exécution de l’action prévue par Experience Builder.

Cibles

Les cibles effectuent des actions. Une cible peut correspondre à un widget ou à la structure. Si vous utilisez la structure comme cible, l’action est effectuée globalement dans la totalité des pages et widgets 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 répond au 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.

Si vous voulez établir une relation attributaire entre un champ de déclencheur et un champ d’action, les enregistrements du champ de déclencheur doivent correspondre exactement à ceux du champ d’action, y compris la mise en majuscules.

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 :

Conseil :

Explorez les exemples de chaque action en utilisant les liens dans la colonne Action ci-dessous.

Cible	Action^1	Déclencheur : clic d’un bouton	Déclencheur : données ajoutées	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	Déclencheur : modification des vues
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. Exemple : Sites potentiels de construction de logements au Royaume-Uni
	Select Data Records (Sélectionner des enregistrements de données)^2 : marquez les enregistrements comme sélectionnés et placez-les dans la vue Entités sélectionnées. Exemple : États, comtés et secteurs de recensement aux États-Unis
Widget Business Analyst	Select feature (Sélectionner une entité) : marquez l’entité comme sélectionnée.
Widget Elevation Profile (Profil d’élévation)	Select line (Sélectionner une ligne) : marquez l’entité linéaire comme sélectionnée et générez un profil d’élévation. Exemple : Sentiers du service des parcs nationaux
Widget cartographique	Add to map (Ajouter à la carte) : ajoutez des données à la scène ou carte Web en tant que couche. Exemple : Visualiseur de données
	Pan to (Déplacer sur)^3 : conservez l’échelle actuelle et centrez l’écran sur une localisation spécifiée. Exemple : Ornithologie à Boston
	Zoom to (Zoom sur)^4 : zoomez sur une localisation spécifiée. Exemple : Portland 2D et 3D
	Flash (Clignoter) : faites clignoter une entité sur la carte. Exemple : Découvrir la Nouvelle-Angleterre
	Filter (Filtrer) : ne conservez que les entités qui remplissent les conditions d’affichage dans le widget Carte. Exemple : Sites à découvrir à Washington, D.C.
	Show on map (Afficher sur la carte)^5 : affichez les enregistrements créés sur la carte en tant que nouvelle couche. Exemple : ArcGIS Geocoding service
Widget Near Me (Autour de moi)	Set location (Définir la localisation) : définissez la localisation de recherche et trouvez les entités à proximité.
Widget Sidebar (Encadré)	Open sidebar (Ouvrir la barre latérale) : ouvrez la barre latérale.
	Toggle sidebar (Activer/désactiver la barre latérale) : permet d’ouvrir ou de fermer l’encadré.
Widget Controller widget (Contrôleur de widgets)	Open widget (Ouvrir le widget) : ouvrez les widgets dans le contrôleur.

¹Si les données d’action sont la vue par défaut, l’action de structure affecte tous les widgets qui utilisent les données et leurs vues. Si les données d’action sont une vue spécifique, l’action affecte 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 Entités sélectionnées des données. La configuration des widgets peut différer pour l’affichage d’un enregistrement sélectionné.

³Si un widget Map (Carte) est configuré avec à la fois l’action Zoom to (Zoom sur) et l’action Pan to (Déplacer sur), l’action Zoom to (Zoom sur) est prioritaire. En d’autres termes, si l’utilisateur se déplace et zoome sur la carte en même temps, l’action Pan to (Déplacer sur) est ignorée.

⁴Lorsque vous ajoutez une action Zoom to (Zoom sur), vous pouvez changer 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. L’action Zoom to (Zoom sur) inclut le comportement de rotation pour les cartes Web et les scènes Web ainsi que le comportement d’inclinaison pour les scènes Web.

⁵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.

Données associées

Si une source de données comporte des données associées, vous pouvez utiliser la relation de la couche pour configurer une action Messages. Le déclencheur, les cibles et les actions ci-après prennent en charge les données associées :

Déclencheur	Cible	Actions
Modifications de sélection d’enregistrements	Structure	Sélectionner les enregistrements de données, Filtrer les enregistrements de données
	Carte	Filtrer, Clignoter

Actions Données

Vous pouvez configurer les actions Données pour que les utilisateurs traitent les données dans l’application au moment de l’exécution. Ils peuvent cliquer sur le bouton Actions dans les widgets sources et 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 le volet 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 le décident.

Le jeu de données transmis à la cible varie en fonction du widget source. Par exemple, le widget Chart (Diagramme) transmet toutes les données statistiques au widget Table, qu’une sélection ait été effectuée ou non.

Les deux tables suivantes répertorient les widgets sources disponibles, les cibles et les actions Données prises en charge (cible : action Données) :

Widget source	Structure : Exporter	Structure : Données associées^1	Structure : Définir un filtre	Framework (Structure) : Statistics (Statistiques)	Analyse : Définir comme entrée d’analyse	Directions (Feuille de route) : Directions from (Feuille de route à partir de)	Directions (Feuille de route) : Directions to (Feuille de route vers)
Analyse
Ajouter des données
Diagramme
Feature Info (Informations sur les entités)
Liste
Carte
Couches cartographiques
Autour de moi
Requête
Sélectionner
Tableau

Widget source	Feuille de route : Planifier un itinéraire	Elevation Profile (Profil d’élévation ) : View elevation profile (Afficher le profil d’élévation)	Carte : Déplacer	Carte : Afficher sur la carte^2	Carte : Zoom sur	Carte : Ajouter à la carte^3	Near Me (Autour de moi) : Set location (Définir la localisation)	Table : Add to table (Ajouter à la table)	Table : Afficher dans la table^4
Analyse
Ajouter des données
Diagramme
Feature Info (Informations sur les entités)
Liste
Carte
Couches cartographiques
Autour de moi
Requête
Sélectionner
Tableau

¹Les champs Arcade ne s’affichent pas comme prévu avec l’action Related data (Données associées). Experience Builder ne prend pas arcade en charge actuellement.

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

³Vous ne pouvez pas ajouter plusieurs fois la même couche à une carte à partir du widget Add Data (Ajouter des données). Une fois que vous avez utilisé l’action Données Add to map (Ajouter à la carte) avec le widget Table ou Add Data (Ajouter des données), elle n’apparaît plus sous forme d’option pour cette couche dans aucun des deux widgets. Si vous configurez le widget Analysis (Analyse) pour ajouter automatiquement des couches de résultat à la carte, l’action Données Add to map (Ajouter à la carte) n’est pas disponible pour ces résultats.

⁴Vous pouvez ajouter de nombreux types de données avec le widget Add Data (Ajouter des données), mais seuls les types de données que le widget Table prend en charge (couches d’entités et couches de scènes avec des couches d’entités associées) peuvent déclencher l’action Données Add to table (Ajouter à la table).

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 sélectionne des données dans un widget 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.)

Remarque :

À partir de la version de février 2024, Experience Builder charge uniquement les champs nécessaires afin d’améliorer les performances. Par exemple, si un widget est configuré pour utiliser certains champs d’une source de données, Experience Builder charge uniquement ces champs. Par conséquent, les champs non chargés risquent de ne pas s’afficher lorsque vous exécutez l’action Données Statistics (Statistiques). Si vous voulez afficher des statistiques pour davantage de champs, vous pouvez utiliser les actions Données View in table (Afficher dans la table) ou Add to table (Ajouter à la table) pour afficher les données dans un widget Table au moment de l’exécution, puis utiliser l’action Données Statistics (Statistiques) du widget Table.

Niveaux des actions Données

Les actions Données peuvent avoir un impact sur une partie ou la totalité des données issues d’un widget source. Les actions Données qui affectent tous les enregistrements de l’intégralité de la source de données sont appelées actions au niveau de la source de données. Les actions Données qui affectent les enregistrements sélectionnés, les enregistrements chargés ou l’enregistrement actuel sont appelées actions au niveau de l’enregistrement.

Le tableau suivant répertorie les widgets source et les niveaux pris en charge des actions Données :

Widget source	Niveau de la source de données	Niveau de l’enregistrement
	Tous les enregistrements	Enregistrements sélectionnés	Enregistrements chargés	Enregistrement actuel
Ajouter des données
Diagramme
Feature Info (Informations sur les entités)
Liste
Carte
Couches cartographiques
Autour de moi
Requête
Sélectionner
Tableau

Le tableau suivant répertorie toutes les cibles possibles ainsi que les niveaux pris en charge des actions Données :

Cible	Opération	Niveau de la source de données	Niveau de l’enregistrement
Analyse	Définir comme entrée d’analyse
Profil d’élévation	Visualiser le profil d’élévation
Feuilles de route	Directions from (Feuille de route à partir de)
	Directions to (Feuille de route vers)
	Planifier un itinéraire
Structure	Exporter
	Données associées
	Set filter (Définir un filtre)
	Statistiques
Carte	Zoom
	Déplacer sur
	Afficher sur la carte
	Ajouter à la carte
Autour de moi	Définir l'emplacement
Tableau	Add to table (Ajouter à la table)
	View in table (Afficher dans la table)

Configurer des interactions

Configurez des actions Messages et Données dans le volet 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).

Pour configurer les actions Messages, procédez comme suit :

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

Pour configurer les actions Données, procédez comme suit :

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 répondre aux exigences de la conception d’application, par exemple dans les cas suivants :

• 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 répondre aux exigences de la conception d’application, par exemple dans les cas suivants :

• Vous ajoutez un widget Chart (Diagramme) pour représenter un jeu de données numériques ou qualitatives sous forme de diagramme et vous voulez donner à l’utilisateur 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 peut cliquer sur le bouton Actions dans le widget Diagramme et sélectionner View in table (Afficher dans la table) pour afficher les données statistiques dans le widget Table.

  Conseil :

  Si le widget cible, qui, dans cet exemple, est le widget Table, se trouve dans un widget Widget Controller (Contrôleur de widgets), le widget cible s’ouvre automatiquement dans Widget Controller (Contrôleur de widgets) lorsque l’utilisateur active l’action Données.

• 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 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 peut cliquer sur le bouton Actions dans le widget 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 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 exporter les enregistrements sélectionnés ou la totalité des enregistrements.