Sélectionner des données

Les données occupent une place privilégiée dans la plupart des applications créées avec Experience Builder. De nombreux widgets sont axés sur les données et le générateur offre une gestion unifiée des données. Les widgets qui utilisent les mêmes données peuvent être connectés dans une application. Par exemple, vous pouvez synchroniser des sélections d’enregistrements entre plusieurs widgets et appliquer le même filtre aux widgets connectés aux mêmes données.

Lorsque vous ajoutez des données à une application dans Experience Builder, il s’agit d’une instance spécifique d’une connexion à une source de données. Cela procure les avantages suivants :

• Les mises à jour de la source de données d’origine sont synchronisées dans les applications que vous créez.
• Vous pouvez ajouter plusieurs fois la même source de données. Les connexions deviennent des données indépendantes dans Experience Builder. La plupart des traitements de données n’affectent pas les autres traitement de données (tels que le filtrage et le tri), à l’exception des mises à jour effectuées sur la source de données d’origine (telles que les mises à jour d’entités et d’attributs).

Gérer les données

Toutes les données que vous ajoutez à une application sont répertoriées dans le panneau Data (Données) de l’espace de travail du générateur. Vous pouvez y gérer les données de l’application et vérifier les informations correspondantes (par exemple, combien de widgets sont connectés aux données et à tel ou tel champ, si applicable, et quels sont ces widgets). Filtrez la liste à l’aide de la zone Search (Rechercher) pour vous aider à trouver une source de données en particulier. Les résultats de recherche sont notamment les sous-couches des cartes Web et scènes Web que vous avez ajoutées à l’application.

Ajouter des données à une application

Pour ajouter des données à une application, vous pouvez sélectionner des cartes Web, des scènes Web et des couches d’entités stockées sous forme d’éléments de contenu dans ArcGIS, et notamment ce qui suit :

• Couches d’entités hébergées
• Couches de scènes ponctuelles et d’objets 3D qui prennent en charge les requêtes
• Couches de scènes avec une couche d’entités associée
• Services d’entités, de scène et de carte
• Collections d’entités (à l’exclusion des annotations de cartes et des couches d’itinéraire)

Vous pouvez parcourir et rechercher ces sources de données dans votre contenu, vos groupes, votre organisation, ainsi que dans le contenu partagé publiquement, y compris ArcGIS Living Atlas of the World. Les couches des URL de service d’entités, de scène ou de carte sont également prises en charge. En outre, vous pouvez utiliser comme source de données des widgets les couches prises en charge des cartes Web et scènes Web que vous ajoutez à une application.

Remarque :

• Lorsque vous ajoutez une carte Web ou une scène Web en tant que source de données, les widgets peuvent se connecter à ses couches prises en charge, comme les tables, les couches d’images de carte, les couches de tuiles et les groupes de couches. Les types de couches non pris en charge ne sont pas proposés dans les paramètres des widgets et ne sont pas affichés dans l’onglet des détails du volet Data (Données).
• Les cartes Web et scènes Web créées avec JSAPI 3.x qu’il est impossible d’ouvrir dans Map Viewer Classic ou dans Scene Viewer sont inutilisables comme sources de données. (Si vous ajoutez un de ces éléments, il ne pourra pas être sélectionné et s’affichera dans le volet Data (Données) sous la forme d’une fiche d’erreur.)

Vous pouvez ajouter des données à une application de différentes manières :

• Avant d’ajouter des widgets, cliquez sur le bouton Add data (Ajouter des données) dans le volet Data (Données) pour ajouter les données à utiliser dans l’application. Tous les types de données pris en charge dans Experience Builder sont répertoriés dans la fenêtre Add data (Ajouter des données).
• Si vous n’ajoutez pas de donnée avant d’ajouter des widgets, vous pouvez ajouter des données lors de la configuration d’un widget en cliquant sur Add data (Ajouter des données) dans la partie inférieure de la fenêtre Select data (Sélectionner des données). Seul le type de données pris en charge par le widget peut être ajouté. Les données que vous ajoutez lors de la configuration d’un widget apparaissent également dans le panneau Data (Données) et peuvent être sélectionnées lors de la configuration d’autres widgets.

Remarque :

Vous pouvez masquer certaines sous-couches dans un service, un groupe de couches, une carte Web ou une scène Web lorsque vous ajoutez des données. Vous pouvez également les masquer sous le volet des détails du service, du groupe, de la carte Web ou de la scène Web. Les couches masquées ne sont plus disponibles dans la liste de sélection de données pour la configuration des widgets. Vous pouvez masquer uniquement les couches qui ne sont pas encore utilisées.

Supprimer des données

Vous pouvez supprimer une source de données à l’aide de l’option Remove (Supprimer) des fiches d’élément, dans le panneau Data (Données). Les données présentes dans la source de données sont également supprimées. Lorsque vous supprimez des données dans ce panneau, elles ne sont plus disponibles pour la configuration des widgets. Si vous supprimez des données déjà utilisées par des widgets, l’application n’affiche plus d’informations à partir de ces données et tous les widgets qui y sont connectés sont affectés. Vous pouvez supprimer les widgets affectés lorsque vous supprimez les données ou reconfigurer les paramètres des widgets en connectant d’autres données ultérieurement.

Informations sur les données et visualisations de données

Le volet Data (Données) présente les fiches d’élément, avec les noms d’élément, correspondant aux données que vous ajoutez à l’application. Les étiquettes avec icônes permettent de différencier les types de données. Vous pouvez afficher des détails supplémentaires en cliquant sur le lien permettant d’ouvrir la page des éléments de la source de données d’origine. Vous pouvez remplacer le nom qui apparaît sur les fiches d’élément par un nom plus approprié pour l’application (les données source restent inchangées). Chaque fiche indique le nombre de widgets et de couches associés dans une carte ou une scène. Lorsque vous cliquez sur une fiche de données, une fenêtre s’ouvre avec des détails supplémentaires.

• Concernant les cartes Web, les scènes Web, les services et les groupes de couches, vous pouvez consulter les informations suivantes :
  • Onglet Layers (Couches) : les couches contenues dans la source de données sont répertoriées. Les couches sont divisées en deux groupes : In use (Utilisées) affiche les couches sélectionnées dans les paramètres des widgets et Others (Autres) affiche celles non encore connectées à un widget. Vous pouvez masquer une couche inutilisée, et ainsi ne plus la faire figurer dans la liste de sélection de données pour la configuration d’un widget. Cliquez sur la fiche de la couche pour ouvrir la fenêtre des détails.
  • Onglet Widgets (Widgets) : les widgets qui utilisent directement la carte, la scène, le service ou le groupe de couches dans son intégralité sont répertoriés. Les widgets qui n’utilisent que certaines couches des données ne sont pas répertoriés dans cet onglet, mais sous la couche correspondante.
• Pour les couches uniques (y compris celles sans sous-couche), les options de paramètre et informations suivantes sont disponibles :
  • Data settings (Paramètres des données) : définissez des filtres, des champs de tri et des limites d’enregistrements pour les données. Ces paramètres de filtre s’appliquent à toutes les vues de données.
  • Refresh settings (Actualiser les paramètres) : si l’option Auto refresh (Actualisation automatique) est désactivée, les données sont actualisées uniquement lorsque vous actualisez l’application ou le générateur. Activez l’option Auto refresh (Actualisation automatique) pour actualiser les données et obtenir les dernières entités selon un intervalle temporel spécifié. Vous pouvez définir un intervalle temporel personnalisé ou, si les données proviennent d’une carte Web, utiliser les paramètres de la couche.
  • Allow export (Autoriser l’exportation) : offrez aux utilisateurs des options d’exportation des données au moment de l’exécution depuis des widgets connectés pour lesquels des actions Données sont activées.

    Remarque :

    Pour les couches d’entités hébergées, l’application vérifie que le rôle de l’utilisateur et les paramètres des éléments autorisent l’exportation des données.

  • Onglet Data views (Vues des données) : créez des vues de données des couches d’entités et de scène prises en charge en ajoutant des filtres, des champs de tri et des limites d'enregistrement de manière à contrôler ce qui est affiché dans les widgets connectés. Ces paramètres s’appliquent uniquement à la vue, sans aucune incidence sur les autres visualisations de données ou les données source.

    Remarque :

    Chaque couche comporte également des vues intégrées que vous pouvez sélectionner lors de la configuration des sources de données pour le widget. La vue par défaut contient toutes les entités. La vue des entités sélectionnées contient les entités sélectionnées au moment de l’exécution. La vue renseignée automatiquement est utilisée pour les paramètres de contenu dynamique dans les widgets List (Liste).

    • View for empty selection (Vue en cas de sélection vide) : cochez cette case et cliquez sur son bouton Settings (Paramètres) pour configurer une vue qui s’affiche lorsque aucune entité n’est sélectionnée dans une vue Entités sélectionnées. (Les entités de cette vue configurée ne sont pas sélectionnées automatiquement.)
  • Onglet Fields (Champs) : les champs utilisés par les widgets sont répertoriés.
  • Onglet Widgets (Widgets) : les widgets qui utilisent la couche dans leurs paramètres sont répertoriés.

Utiliser les données

Les données que vous ajoutez à une application, quelle que soit la méthode d’ajout, sont disponibles pour tous les widgets pris en charge dans cette application. Une source de données utilisée par un widget peut l’être par les autres. La sélection des enregistrements est synchronisée dans toute l’application. De plus, les filtres sur la vue des données par défaut s'appliquent à tous les widgets qui utilisent les données ou leurs vues. Les filtres sur une vue de données spécifique ne s'applique qu'aux widgets qui utilisent la même vue de données.

Remarque :

Lorsqu’une carte Web ou scène Web est affichée dans un widget Carte, une nouvelle vue de carte Web ou scène Web est créée automatiquement, et cette vue est utilisée uniquement dans le widget actuel. Le traitement des données dans le widget Map (Carte) n’a aucune incidence sur les widgets qui utilisent la même source de données ou ses couches. Toutefois, le widget Map (Carte) est affecté par le traitement des données dans la vue par défaut.

Le panneau de configuration de chaque widget inclut un paramètre standard permettant de se connecter aux données. La fenêtre qui s’affiche après que vous avez cliqué sur Select data (Sélectionner les données), répertorie les données ajoutées et les données en sortie de l’application qui sont prises en charge par les widgets (sauf les données masquées). Vous pouvez sélectionner des données dans la liste ou ajouter des données supplémentaires à l’application. Utilisez la zone Search (Rechercher) pour filtrer la liste des options. Les résultats de recherche sont notamment les sous-couches des cartes Web et scènes Web que vous avez ajoutées à l’application. Certains widgets prennent en charge plusieurs sources de données. Vous pouvez alors sélectionner plusieurs éléments de la liste. Si un widget ne peut être connecté qu’à une seule source de données, cliquez sur la fiche de données existante pour ouvrir la fenêtre Select data (Sélectionner des données), dans laquelle vous pouvez effacer la sélection et sélectionner un autre élément.

Le tableau ci-après présente les widgets qu’il est possible de connecter à des données, ainsi que les types de données pris en charge pour chacun.

Widget	Type de données pris en charge*	Nombre de données pris en charge
Gestion des versions de branche	Service d’entités, service de carte (doit être inscrit comme versionné)	1 ou plusieurs
Button (Bouton)**	Couche d’entités, couche de scène	0 ou 1
Diagramme	Couche d’entités, couche de scène	1
Mettre à jour	Couche d’entités, couche de scènes (les couches doivent être modifiables)	1 ou plusieurs
Embed (Incorporer)**	Couche d’entités, couche de scène	0 ou 1
Feature Info (Informations sur les entités)	Couche d’entités, couche de scène	1
Filtrer	Couche d’entités, couche de scène	1 par filtre
Image**	Couche d’entités, couche de scène	0 ou 1
Liste	Couche d’entités, couche de scène	1
Carte	Carte Web, scène Web	1 ou 2
Couches cartographiques	Carte Web, scène Web	0 ou 1
Requête	Couche d’entités, couche de scène	1 pour chaque requête
Rechercher	Couche d’entités, couche de scène	1 pour chaque source de la couche
Tableau	Couche d’entités, couche de scène	1 pour chaque feuille
Text (Texte)**	Couche d’entités, couche de scène	0 ou plusieurs
Chronologie***	Carte web, couche d’entités, couche de service de carte	1 ou plusieurs

*Pour obtenir la liste spécifique des types d’éléments pris en charge, reportez-vous à la rubrique Ajouter des données à l’application.

**Les widgets Image, Text (Texte), Button (Bouton) et Embed (Incorporer) sont statiques par défaut. Pour afficher les informations des données, activez le paramètre Connect to data (Connexion aux données) et spécifiez les paramètres avec des attributs, statistiques ou expressions. Pour plus d’informations, reportez-vous à la rubrique Contenu dynamique.

***Le widget Timeline (Chronologie) prend en charge plusieurs couches d’entités ou couches de service de carte, mais une seule carte Web à la fois.

Données en sortie

En plus des données que vous ajoutez manuellement à l'application, les widgets suivants peuvent traiter les données d'origine et générer un nouveau jeu de données en sortie avec les résultats affichés.

Widget source	Type de données en sortie	Jeux de données en sortie
Diagramme	Couche d'entités	Statistiques du diagramme
Feuilles de route	Couche d'entités	1 chacun pour les arrêts, les points de direction, les lignes de direction et l’itinéraire
Profil d’élévation	Couche d'entités	1 par profil
Requête	Couche d'entités	1 pour chaque requête
Rechercher	Couche d'entités	1 pour chaque source du localisateur
Traçage de réseau de distribution	Couche d'entités	1 couche contenant les polygones de zone de résultat

Lorsque ces widgets source sont configurés dans l'application, leurs données en sortie sont répertoriées dans la fenêtre Select data (Sélectionner les données) lorsque vous configurez d'autres widgets. La sortie est créée sous forme de nouvelle source de données. Aussi, les filtres et sélections sur les données en sortie n’affectent pas la source de données d’origine.

Remarque :

Si vous supprimez un widget sans donnée en sortie utilisé par un autre widget, un message d’avertissement répertoriant les widgets associés apparaît. Vous pouvez supprimer les widgets associés ou les conserver afin de les reconfigurer ultérieurement avec une autre source de données.

La structure des données en sortie dépend de leur widget source.

• Chart (Diagramme) : statistique avec des attributs du champ de catégorie (s’il est configuré) et des résultats de calculs de champs numériques (elle ne contient pas de géométrie)
• Query (Requête) : sous-ensemble d’enregistrements qui satisfont les critères de la requête, avec des champs tels que configurés dans leurs paramètres Results (Résultats)
• Search (Rechercher) : adresse du résultat de la recherche dans la source du localisateur correspondante

Les véritables enregistrements des données en sortie sont générés de façon dynamique par le widget source au moment de l’exécution.

Vues des sources de données

Une fois que les données ont été sélectionnées dans les paramètres de widget, vous pouvez choisir une ou plusieurs vues dans la liste déroulante, en fonction du nombre de sources de données prises en charge par le widget. Une source de données comporte les options de vue suivantes :

• Default (Par défaut) : vue intégrée qui contient toutes les entités des données.
• Selected features (Entités sélectionnées) : vue intégrée qui contient les entités sélectionnées par l’utilisateur au moment de l’exécution. L’état sélectionné d’une entité est synchronisé dans toutes les vues. Cette vue peut servir à afficher le résultat d'une interaction. Par exemple, si elle est configurée pour un widget Liste, la liste n'affiche que les enregistrements sélectionnées et les éléments de la liste change de façon dynamique au fil des changements de sélection. En l’absence de sélection, la liste affiche le message No data (Aucune donnée) jusqu’à ce que des enregistrements soient sélectionnés. Vous pouvez également créer une vue en cas de sélection vide dans le volet Data (Données).
• Auto-populated (Renseigné automatiquement) : vue intégrée qui est disponible dans les paramètres de contenu dynamique si un widget est ajouté à un widget List (Liste) et qu’il est connecté à la même visualisation de données. Cette vue contient une seule entité, que la liste génère pour chacun de ses éléments.
• Vue de données : sous-ensemble d’entités que vous pouvez créer avec différents filtres, champs de tri et limites d’enregistrement. Vous pouvez prétraiter une source de données avec plusieurs visualisations de données pour contrôler les données qui apparaissent dans un widget sans affecter les autres visualisations de données ou données source.

  Remarque :

  Les données en sortie ne prennent pas en charge l'ajout de vues de données personnalisées.

  Remarque :

  Le paramètre Page size (Taille de la page) sur l’onglet Records (Enregistrements) permet d’optimiser l’efficacité et les performances des requêtes. Il n’affecte pas le nombre total d’entités de résultat dans les widgets prenant en charge la pagination. Si la page est de plus petite taille que le résultat, plusieurs demandes sont envoyées jusqu’à ce que tous les résultats soient chargés.

La vue Default (Par défaut) est sélectionnée par défaut. Vous pouvez également mettre à jour une vue existante ou en créer une autre pour le widget. Les vues créées depuis le volet de configuration d'un widget sont également disponibles à la sélection dans les paramètres d’autres widgets.

Contenu dynamique

Plusieurs widgets possèdent des paramètres que vous pouvez utiliser pour afficher des informations dynamiques provenant d’une source de données connectée. Il peut s’agir notamment d’une valeur attributaire d’une entité spécifiée, d’un résultat statistique pour des entités satisfaisant certaines conditions ou d’une expression combinée à des chaînes statiques, des valeurs dynamiques et des calculs.

Attribut

Obtenez la valeur attributaire d’une entité de la visualisation de données spécifiée en utilisant l’une des vues suivantes :

• Les vues que vous définissez dans le paramètre de source de données du widget.
• La vue Selected features (Entités sélectionnées) de la couche de données d’origine. Cette vue vous permet d’afficher les résultats de l’interaction (par exemple, afficher les attributs de l’entité sélectionnée).
• La vue remplie automatiquement si le widget se trouve dans un widget List (Liste) (par exemple, texte, image ou bouton) et comporte la même visualisation de données que le widget List (Liste). Cette vue contient une seule entité que l’élément de liste représente.

Si la vue comporte plusieurs entités, la valeur attributaire de la première entité est renvoyée (en fonction des paramètres de tri de la visualisation de données).

Statistiques

Obtenez les résultats statistiques du jeu d’entités défini par la visualisation de données spécifiée.

Ces résultats peuvent consister en la valeur maximale, minimale, moyenne ou totale d’un champ numérique, la valeur maximale ou minimale d’un champ de date, le nombre d’entités du jeu d’entités (à l’aide du champ d’ID unique), ou le nombre de valeurs uniques d’un champ si le service prend en charge un total distinct.

Utilisez l’éditeur de statistiques afin de fournir des étiquettes personnalisées pour les statistiques. Pour définir une étiquette, remplacez le texte de l’espace réservé, qui sert d’étiquette par défaut et change en fonction de l’opérateur et du champ que vous spécifiez.

Expression

Utilisez l’éditeur d’expressions pour saisir du texte (format : “text”), des valeurs numériques, des variables de champ (format : {fieldname}) et des fonctions, parmi lesquelles AVERAGE({fieldname}), COUNT({fieldname}), SUM({fieldname}), MAX({fieldname}) et MIN({fieldname}). Chaque partie est concaténée avec un signe plus. L’expression renvoie le résultat de la concaténation de chaînes et du calcul numérique. Par exemple, si vous saisissez 1+1, elle renvoie 2 (valeur numérique), mais si vous saisissez 1 + “1”, elle renvoie “11” (chaîne).

Au cours de la saisie, vous pouvez cliquer sur les suggestions affichées pour les insérer. Vous pouvez également insérer une variable de champ ou une fonction, en cliquant sur les noms de champ ou de fonction affichés sous la zone de saisie.

Les données de l’onglet Fields (Champs) permettent de définir la visualisation de données représentée par la variable de champ. Si une variable de champ est ajoutée sous forme autonome à une expression, la valeur attributaire de ce champ est renvoyée par la première entité de la visualisation de données spécifiée.

Si une variable de champ numérique ou de champ de date est utilisée dans une fonction (par exemple, sous la forme AVERAGE({fieldname})), cette fonction renvoie le résultat statistique de la visualisation de données correspondant à ce champ. Pour les champs de date, le générateur d’expressions prend uniquement en charge les fonctions COUNT, MAX et MIN.

Vous pouvez mettre en forme les nombres de l’expression en cliquant sur le bouton Number formatting (Mise en forme numérique) et en activant Number formatting (Mise en forme numérique). Vous pouvez choisir le nombre de décimales à afficher, inclure un séparateur de milliers et ajouter une unité depuis les données.