Widget Table

Le widget Table affiche des tables attributaires interactives pour les couches d’entités et les couches de scène avec une couche d’entités associée, qui permettent d’inclure plusieurs feuilles accessibles par les utilisateurs finaux via des onglets ou une liste. Vous pouvez choisir les champs à inclure dans la table et activer des outils, tels que la recherche et la sélection. Les utilisateurs peuvent trier les tables par un ou plusieurs champs et dans l’ordre croissant ou décroissant.

Exemples

Utilisez ce widget pour prendre en charge les exigences de conception d’application, telles que les suivantes :

• Vous souhaitez afficher des tables attributaires.
• Vous souhaitez fournir une table aux utilisateurs afin qu’ils puissent interagir avec elle, par exemple pour rechercher et trier des enregistrements, mettre à jour des attributs et sélectionner les entités correspondantes dans une carte.

Remarques sur l’utilisation

Ce widget requiert la définition d’une source de données pour chaque feuille de la table.. La table prend en charge des couches d’entités et des couches de scènes avec une couche d’entités associée. Vous pouvez définir des actions pour qu’un widget Table interagisse avec d’autres widgets par exemple, zoomer sur l’entité sélectionnée sur une carte dans un widget de carte ou filtrer des lignes dans un widget de liste. Vous pouvez également utiliser ce widget pour afficher les attributs d’entité sans inclure de carte dans l’application.

Conseil :

Dans le cas de champs contenant de longues chaînes, les utilisateurs peuvent survoler n’importe quelle cellule pour afficher la totalité de sa valeur dans une info-bulle. Les URL dans les cellules sont automatiquement raccourcies en boutons View (Afficher) et se transforment en liens dynamiques.

Méthodes de recherche

L’outil de recherche du widget Table emploie différentes méthodes pour générer les suggestions et les résultats de recherche.

L’outil de recherche utilise la recherche de texte intégral pour générer des suggestions de recherche. La recherche de texte intégral est une méthode de recherche efficace qui utilise des index de champ de texte intégral pour diviser les enregistrements en unités plus petites, telles que des mots individuels. Prenons l’exemple d’une couche des localisations des bureaux de poste aux États-Unis qui comporte un champ contenant les noms de chacune de ces localisations. L’index fractionne le nom Highland Station Baltimore Post Office en cinq mots pouvant faire l’objet d’une recherche individuelle : Highland, Station, Baltimore, Post et Office. Si vous saisissez une expression de recherche combinant ces mots (ou uniquement une partie d’entre eux), comme Baltimore Office, Highland Baltimore ou Stat Balt Office, ce bureau de poste apparaît dans les suggestions de recherche.

Les index de champ de texte intégral sont automatiquement générés pour les couches d’entités hébergées lorsque vous les sélectionnez en tant que champs de recherche pour le widget Search (Rechercher), List (Liste) ou Table si vous possédez la couche d’entités hébergée ou si vous êtes administrateur de l’organisation. Vous pouvez également ajouter manuellement des index aux champs d’attribut sur la page des détails de l’élément de la couche. Dans le cas de couches dépourvues d’index et que vous n’êtes pas autorisé à modifier, le widget Table trouve les suggestions à l’aide de START WITH abc%, c’est-à-dire qu’il recherche les enregistrements qui commencent par l’expression de recherche. Cette méthode de recherche est moins efficace.

Pour obtenir les résultats de recherche, le widget utilise CONTAIN %abc%, ce qui signifie que l’expression de recherche peut se trouver n’importe où dans l’enregistrement. Vous pouvez ainsi rechercher alt pour obtenir les résultats de recherche Baltimore, Salt Lake City et Alton.

Attention :

La recherche de texte intégral est une nouvelle fonctionnalité de la version d’octobre 2023 de Experience Builder et est une modification importante. Avant cette version, le widget utilisait CONTAIN %abc% pour générer les suggestions et les résultats. À la différence des requêtes CONTAIN %abc%, la recherche de texte intégral ne peut pas trouver les expressions situées au milieu des mots. Dans l’exemple ci-dessus, la recherche de altimor ou de ighlan ne renvoie pas le bureau de poste attendu dans les suggestions de recherche.

En savoir plus sur la recherche d’entités dans les cartes et les applications.

Paramètres

Le widget Table inclut les paramètres suivants :

• New sheet (Nouvelle feuille) : créez une ou plusieurs feuilles dans la table. (Cliquez sur le bouton Remove (Supprimer) pour retirer une feuille de la table.) Pour chaque feuille, spécifiez les paramètres suivants dans le volet Sheet configuration (Configuration de la feuille) :
  • Data (Données) : sélectionnez la source de données d’une couche avec les attributs à afficher dans le widget. Dans les paramètres de visualisation de données, vous pouvez filtrer les données pour restreindre ce qui apparaît dans le widget, trier les données pour afficher les entités dans un ordre particulier ou limiter le nombre d’entités.
  • Last update text (Texte de la dernière mise à jour) – Incluez un texte indiquant la date de la dernière mise à jour des données. Ce paramètre est disponible uniquement si l’actualisation automatique est activée pour la source de données connectée.
  • Label (Étiquette) : saisissez un nom pour la feuille. Ce nom apparaît dans le widget sous la forme d’un onglet ou dans une liste de feuilles.
  • Configure fields (Configurer les champs) : configurez les paramètres des champs qui apparaissent dans la feuille.
    • Use layer settings (Utiliser les paramètres de la couche) : utilisez les paramètres par défaut de la couche pour déterminer quels champs apparaissent lors de l’affichage initial, quels champs sont visibles et quels champs sont modifiables.
    • Customize (Personnaliser) : sélectionnez les champs à inclure dans la feuille. (Les 50 premiers champs sont automatiquement sélectionnés. Utilisez le bouton Clear selection (Effacer la sélection) si nécessaire.) Faites glissser les champs sélectionnés pour les réorganiser. Cliquez sur le bouton Visible pour activer ou désactiver la visibilité d’une colonne au premier chargement du widget. (Les utilisateurs peuvent modifier la visibilité au moment de l’exécution à l’aide de l’outil Show/hide columns (Afficher/masquer les colonnes).) Si la source de données prend en charge les mises à jour, cochez la case Allow editing (Autoriser les modifications) pour que les utilisateurs ayant accès aux données puissent modifier les attributs en double-cliquant sur les cellules de la table. Vous pouvez choisir les champs qui sont modifiables. Des icônes de verrouillage apparaissent dans les en-têtes de colonne des champs qui ne peuvent pas être modifiés.

      Remarque :

      Le widget Table ne prend pas en charge les pièces jointes.

      Remarque :

      Lorsque l’utilisateur effectue une exportation aux formats JSON, CSV ou GeoJSON avec les actions Données Export (Exporter), seuls les champs que vous sélectionnez pour affichage sont inclus dans l’exportation.

  • Header options (Options d’en-tête) : personnalisez la ligne d’en-tête qui apparaît en haut de la feuille. Vous pouvez mettre le texte d’en-tête en gras, changer la couleur de police et changer la taille de police en pixels (px). Vous pouvez aussi choisir la couleur d’arrière-plan de l’en-tête.
  • Tools (Outils) : fournissez des outils pour que les utilisateurs finaux interagissent avec les feuilles de la table.
    • Search (Rechercher) : indiquez une zone de recherche de la feuille dans la table.
      • Select searching fields (Sélectionner les champs de recherche) : sélectionnez un ou plusieurs champs à rechercher.
      • Exact match (Correspondance parfaite) : limitez les résultats de recherche aux seuls enregistrements qui correspondent à la phrase de recherche.
      • Hint (Astuce) : personnalisez l’astuce textuelle qui apparaît dans la zone de recherche.
    • Select records (Sélectionner les enregistrements) : permet aux utilisateurs finaux de sélectionner des enregistrements dans la feuille. Si vous activez cet outil, vous activez également les paramètres Show selection (Afficher la sélection) (met à jour la feuille pour n’afficher que les éléments sélectionnés) et Clear selection (Effacer la sélection) dans le menu Options de la feuille.
      • Select mode (Mode de sélection) : permet aux utilisateurs de sélectionner un ou plusieurs enregistrements dans la table.
    • Show record count (Afficher le nombre d’enregistrements) – Affichez le nombre total d’enregistrements et le nombre d’enregistrements sélectionnés.
    • Actualiser – Cet outil apparaît dans le menu Options de la feuille pour permettre aux utilisateurs d’actualiser la table afin d’obtenir les données les plus récentes.
• Arrangement style (Style de disposition) : sélectionnez Tabs (Onglets) ou Dropdown (Menu déroulant) pour spécifier comment l’utilisateur passe d’une feuille à l’autre dans la table.

Options d’interaction

Ce widget prend en charge les actions, que vous pouvez configurer sur l’onglet Action dans les paramètres du widget.

Les actions Messages permettent de créer des interactions entre les widgets. Par exemple, vous pouvez faire en sorte qu’une carte effectue un zoom sur des entités lorsque l’utilisateur les sélectionne dans une table en ajoutant le déclencheur Record selection changes (Modifications de sélection d’enregistrements) dans les paramètres Action du widget Table, en définissant un widget Map (Carte) comme cible et en ajoutant l’action Messages Zoom to (Zoom sur).

Activez les actions Données pour ajouter des boutons à l’interface utilisateur du widget pour effectuer des tâches de traitement de données, comme l’exportation et le filtrage. Vous pouvez ainsi activer l’action Données Set filter (Définir un filtre) pour permettre aux utilisateurs de définir des filtres de table à l’aide d’expressions SQL au moment de l’exécution.

Il existe deux actions Données liées aux tables que vous activez dans les paramètres des autres widgets : View in table (Afficher dans la table) et Add to table (Ajouter à la table). Les deux permettent d’envoyer les enregistrements d’un autre widget vers une table. La différence consiste dans les enregistrements concernés. Add to table (Ajouter à la table) est une action au niveau de la source de données, ce qui signifie qu’elle envoie tous les enregistrements d’une source de données complète vers le widget Table. View in table (Afficher dans la table) est une action Données au niveau des enregistrements, ce qui signifie qu’elle affecte les enregistrements sélectionnés, actuels ou chargés.

Le tableau suivant répertorie les widgets et les actions Données que vous pouvez utiliser pour afficher des enregistrements dans un widget Table.

	Add to table (Ajouter à la table)	View in table (Afficher dans la table)
Widget source	Tous les enregistrements	Enregistrements sélectionnés	Enregistrements chargés	Enregistrement actuel
Ajouter des données
Analyse
Diagramme
Feature Info (Informations sur les entités)
Liste
Carte
Couches cartographiques
Requête
Sélectionner