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 votre 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 à l’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 à l’application

Pour ajouter des données à votre 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 pour les widgets les couches prises en charge des cartes Web et scènes Web que vous ajoutez à votre 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 deux 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ées avant d’ajouter des widgets, vous pouvez également 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 choisir de 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. À défaut, vous pouvez 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 supprimées également. 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 qui convienne davantage à votre 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) - Il s’agit des couches contenues dans la source de donné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 - Il s’agit des widgets qui utilisent directement la carte, la scène, le service ou le groupe de couches dans son intégralité. 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.
• Concernant les couches uniques (y compris celles sans sous-couches), vous disposez des options de paramètre et informations suivantes :
  • 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. L’activation de l’option Auto refresh (Actualisation automatique) permet d’actualiser les données et d’obtenir les dernières entités selon un intervalle temporel donné. Vous pouvez définir un intervalle temporel personnalisé ou, si les données proviennent d’une carte Web, respecter les paramètres de la couche.
  • Allow export (Autoriser l'exportation) : offre aux utilisateurs des options d'exportation des données au moment de l'exécution depuis des widgets connectés pour lesquels les actions Données sont activées. (L’exportation est limitée aux 5 000 premiers enregistrements.)

    Remarque :

    Pour les couches d’entités hébergées, l'application vérifie en outre que le rôle de l'utilisateur final 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 ni les données sources.

    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 Default (Par défaut) contient toutes les entités. La vue Selected features (Entités sélectionnées) contient toutes les entités sélectionnées au moment de l'exécution. La vue Auto-populated (Renseigné automatiquement) est utilisée pour les paramètres de contenu dynamique dans les widgets 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 Selected features (Entités sélectionnées). (Les entités de cette vue configurée ne sont pas sélectionnées automatiquement.)
  • Onglet Fields (Champs) : champs utilisés par les widgets.
  • Onglet Widgets (Widgets) : widgets qui utilisent la couche dans leurs paramètres.

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. Ainsi, le traitement des données au sein du widget Carte n’a aucune incidence sur les widgets qui utilisent la même source de données ou ses couches. Toutefois, la carte est affectée par le traitement des données sur 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

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

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	Jeu de données en sortie
Diagramme	Couche d'entités	1
Feuilles de route	Couche d'entités	1 pour les arrêts, les points de direction, les lignes de direction et l’itinéraire
Requête	Couche d'entités	1 pour chaque requête
Rechercher	Couche d'entités	1 pour chaque source du localisateur

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 la forme d'une nouvelle source de données. Aussi, les filtres et sélections sur les données en sortie ne s'appliquent pas à la source de données d'origine.

Remarque :

Si vous supprimez un widget pour lequel des données en sortie sont utilisées par un autre widget, un message d’avertissement répertoriant les widgets associés apparaît. Vous pouvez sélectionner les widgets associés pour les supprimer également, 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 telle qu’elle a été trouvée 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 les données 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 a quatre types de vue :

• La vue intégrée Default (Par défaut) contient toutes les entités des données.
• La vue intégrée Selected features (Entités sélectionnées) contient toutes 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. S'il n'y a pas de sélection, la liste affiche le message No data (Aucune donnée) jusqu'à ce que des enregistrements soient sélectionnés. Vous pouvez aussi créer une vue en cas de sélection vide dans la fenêtre Data (Données).
• La vue intégrée Auto-populated (Renseigné automatiquement) est disponible dans les paramètres de contenu dynamique si un widget est ajouté à un widget Liste et qu'il est connecté à la même vue de données. Cette vue contient une seule entité, que la liste génère pour chacun de ses éléments.
• Une vue de données est un 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 vues de données pour contrôler les données qui s'affichent dans un widget sans affecter d'autres vues des données ou les données de la 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 réel, plusieurs requêtes 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 choisir d'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

Vous pouvez utiliser ou afficher des informations dynamiques provenant d’une source de données connectée pour certains paramètres de plusieurs widgets. 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 Auto-populated (À remplissage automatique) si le widget se trouve dans un widget Liste (par exemple, texte, image ou bouton) et comporte la même visualisation de données que le widget Liste. Cette vue contient une seule entité que l’élément de liste représente.

Si la vue choisie 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, représenter le nombre d’entités du jeu d’entités (à l’aide du champ d’ID unique), ou le nombre de valeurs uniques pour un champ si le service prend en charge un total distinct.

Expression

L’éditeur d’expressions vous permet de 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.

Dans l’onglet Fields (Champs), vous pouvez 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 est utilisée dans une fonction (sous la forme AVG({fieldname}), par exemple), cette fonction renvoie le résultat statistique de la vue de données correspondant à ce champ.

Vous pouvez appliquer un format aux numéros de l’expression en cliquant sur l’icône d’engrenage et en activant Number formatting (Format d’affichage des nombres. Vous pouvez choisir le nombre de décimales que vous souhaitez afficher, inclure un séparateur de milliers et ajouter une unité depuis les données.