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

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
• 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 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 s’appliquent à toutes les visualisations de données.
  • Refresh settings (Actualiser les paramètres) : si l’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’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.
  • Onglet Fields (Champs) : champs utilisés par les widgets.
  • Onglet Widgets (Widgets) : widgets qui utilisent la couche dans leurs paramètres.
  • Onglet Data views (Visualisations de données) : créez des visualisations de données des couches d’entités et de scène prises en charge en ajoutant des critères de filtre et de tri, de manière à contrôler ce qui est affiché dans les widgets connectés.
    • Vous pouvez ajouter plusieurs visualisations de données avec des limites d’enregistrement, filtres et champs de tri différents. Ces paramètres s’appliquent uniquement à la vue, sans aucune incidence sur les autres visualisations de données ni les données sources.
    • Pour chaque couche, il existe deux vues intégrées. La vue Default (Par défaut) représente les données. La vue Selected features (Entités sélectionnées) représente la collection des entités sélectionnées d’une couche. L’état sélectionné d’une entité est synchronisé dans toutes les vues.
    • Vous pouvez utiliser la vue des entités sélectionnées pour y afficher le résultat d’une interaction (par exemple, cliquer sur une entité pour afficher ses attributs). En l’absence de sélection, par défaut, c’est le nom de l’attribut qui est affiché. Pour éviter cela, vous pouvez sélectionner l’option View for empty selection (Vue pour sélection vide) et configurer une vue dans laquelle afficher les informations des entités lorsqu’il n’y a aucune entité sélectionnée. Notez que les entités de la vue configurée ne sont pas sélectionnées automatiquement.
    • Si un widget est ajouté à un widget List (Liste) et connecté à la même visualisation de données, une vue Auto-populated (À remplissage automatique) est disponible dans les paramètres de contenu dynamique. Cette vue contient une seule entité, que la liste génère pour chacun de ses éléments.

    Remarque :

    Les données et leurs vues ont une relation de type 1:M dont l’effet est unidirectionnel. Les paramètres des données agissent sur toutes les vues. En revanche, les paramètres des vues n’affectent pas les vues entre elles ni les données. Pour plus d’informations sur la relation entre les données et leurs vues, consultez l’article Vue (base de données) de l’encyclopédie Wikipedia.

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, le traitement des données sur la visualisation de données par défaut (filtre, tri et limitations d’enregistrements) concerne tous les widgets qui utilisent les données ou leurs vues. Le traitement des données sur une visualisation de données spécifique n’affecte que les widgets qui utilisent la même visualisation 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 de l’application qui sont prises en charge par les widgets (sauf les données masquées). Vous pouvez sélectionner des données de cette liste ou ajouter d’autres données dans 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.

Une fois que les données sont sélectionnées et qu’elles contiennent des visualisations de données, vous pouvez sélectionner une ou plusieurs vues dans la liste déroulante, en fonction du nombre de sources de données prises en charge par le widget. 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 nouvelle pour le widget. La vue nouvellement créée est disponible pour d’autres paramètres de widget.

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
Embed (Incorporer)**	Couche d’entités, couche de scène	0 ou 1
Feature Info (Informations sur les entités)	Couche d'entités	1
Filtre	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
Table	Couche d'entités	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.

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 ou représenter le nombre d’entités du jeu d’entités.

Expression

L’éditeur d’expressions vous permet de saisir du texte (format : « texte »), des valeurs numériques, des variables de champ (format : {fieldname}) et des fonctions, parmi lesquelles AVERAGE({fieldname}), COUNT, 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 le chiffre 2 ; si vous saisissez 1 + “1”, elle renvoie la chaîne « 11 ».

Au cours de la saisie, vous pouvez cliquer sur les suggestions proposé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 visualisation de données correspondant à ce champ.