Widget de requête

Le widget Requête permet de récupérer des informations à partir d’une source de données en exécutant une requête de filtre attributaire ou spatial. Les résultats d’une requête génèrent une source de données en sortie que d’autres widgets peuvent utiliser.

Exemples

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

• Vous voulez permettre aux utilisateurs de rechercher des entités à partir d’une expression de requête.
• Vous voulez permettre aux utilisateurs de dessiner une forme sur une carte pour obtenir les entités qui intersectent la forme dessinée sur la carte.
• Vous souhaitez que les utilisateurs puissent trouver les entités présentant une relation spécifique (par exemple, une intersection ou une superposition) avec les formes d’entités sélectionnées d’autres widgets.
• Vous voulez utiliser les résultats de la requête pour créer des entités pour d’autres widgets.

Remarques sur l’utilisation

Il est nécessaire de configurer une source de données pour chaque requête que vous ajoutez. Chaque requête fonctionne avec une couche unique et vous pouvez définir plusieurs filtres spatiaux et attributaires. Vous pouvez également créer plusieurs requêtes et utiliser les couches de plusieurs sources de données. Une requête peut être configurée avec ou sans carte. Pour afficher les entités renvoyées depuis une requête dans un widget Carte, vous pouvez soit paramétrer une action pour qu’elles s’affichent automatiquement, soit utiliser une action de données qui permet à l’utilisateur de cliquer sur un bouton. Actuellement, l’utilisation d’une couche de scène nécessite d’ajouter un déclencheur Record selection changes (Modifications de sélection d’enregistrements), qui permet aux utilisateurs de cliquer sur un résultat de la requête pour le mettre en surbrillance sur la carte.

Attention :

Tenter d’exécuter une requête spatiale pour une entité extrêmement complexe (par exemple une entité surfacique comportant un grand nombre de sommets) peut surcharger le widget et ne pas renvoyer de résultats. Si cela se produit, vous pouvez tenter de généraliser l’entité. Assurez-vous de respecter les limites de ressources maximales de votre serveur.

Paramètres

Le widget Requête comprend les paramètres suivants :

• New query (Nouvelle requête) : créez une requête et indiquez les paramètres suivants dans le volet Set query (Définir la requête)  :
  • Data (Données) : sélectionnez les données sur lesquelles lancer la requête. Vous ne pouvez sélectionner qu’une source de données par requête. Les couches d’entités, les couches d’entités contenues dans les scènes Web et les cartes Web sélectionnées, les visualisations de données, les sources de données en sortie et les URL de service d’entités sont prises en charge.
  • Label (Étiquette) : personnalisez le nom de chaque requête. Si le widget ne comprend qu’une seule requête, vous pouvez désactiver l’étiquette d’affichage pour le styles de disposition Vertical et Icon (Icône).
  • Icon (Icône) : sélectionnez une icône pour chaque requête affichée dans le widget et pour la liste de requêtes affichées dans le volet de contenu. Vous pouvez sélectionner des icônes dans les bibliothèques General (Général) et Arrows (Flèches) ou ajouter une icône de votre choix à partir d’un fichier. Cliquez sur le bouton Delete (Supprimer) pour supprimer les icônes importées inutilisées.

    Remarque :

    Vous pouvez télécharger les formats d’image suivants : PNG, GIF, JPG, JPEG et BMP. Pour préserver une performance optimale, une limite de taille à 10 Mo est appliquée.

  • Attribute filter (Filtre attributaire) : créez des expressions SQL pour spécifier les critères de filtre attributaire. Le générateur d’expressions SQL qui s’ouvre inclut plusieurs options permettant de créer des requêtes complexes et interactives.
    • Label (Étiquette) : personnalisez l’étiquette de la section du filtre attributaire.
    • Description : fournissez des instructions destinées à un public spécifique, par exemple de nouveaux utilisateurs, qui apparaissent comme texte de survol sur une icône d’informations.
  • Spatial filter (Filtre spatial) : sélectionnez les filtres spatiaux qui seront disponibles et, éventuellement, choisissez un widget Map (Carte).
    • Label (Étiquette) : personnalisez l’étiquette de la section du filtre spatial.
    • Selected features from data source (Entités sélectionnées de la source de données) : renvoyez uniquement les entités dotées d’une relation spatiale avec les entités d’une autre couche. Vous pouvez également appliquer une distance de recherche aux géométries des entités de la couche associée.
      • Spatial relationship rules (Règles de relation spatiale) : choisissez laquelle des relations spatiales suivantes fournir aux utilisateurs :
        • Intersect (Intersecter) : une partie de l’entité de la couche source figure dans une entité de la couche de filtre.
        • Contain (Contenir) : l’entité de la couche source est complètement entourée par l’entité de la couche de filtre.
        • Cross (Croiser) : l’entité de la couche source croise une entité de la couche de filtre.
        • Envelope Intersect (Intersection de l’enveloppe) : l’enveloppe de la couche source intersecte l’enveloppe de la couche de filtre.
        • Index Intersect (Intersection de l’index) : l’enveloppe de la couche source intersecte l’entrée d’index de la couche de filtre.
        • Overlap (Superposition) : les entités de la couche source se superposent à celles de la couche de filtre.
        • Touch (Coïncider) : l’entité de la couche source coïncide avec la bordure d’une entité de la couche de filtre.
        • Within (Dans) – L’entité de la couche de filtre est complètement entourée par l’entité de la couche source.
      • Enable buffer (Activer la zone tampon) : ajoute une distance de recherche. Vous pouvez définir la distance et l’unité par défaut.
    • Geometries from a map (Géométries d’une carte) : renvoyez les entités figurant dans l’étendue de carte actuelle ou intersectant une forme dessinée sur la carte. Vous pouvez activer et désactiver les outils de dessin pour contrôler ceux qui sont disponibles dans le widget.
    • Description : fournissez des instructions destinées à un public spécifique, par exemple de nouveaux utilisateurs, qui apparaissent comme texte de survol sur une icône d’informations.
  • Results (Résultats) : définissez comment le widget affiche les résultats de requête.
    • Label (Étiquette) : personnalisez l’étiquette de la liste de résultats.
    • Select mode (Mode Sélectionner) : indiquez le nombre d’enregistrements que les utilisateurs peuvent sélectionner dans la liste des résultats.
      • Single (Unique) : les utilisateurs peuvent sélectionner un enregistrement à la fois.
      • Multiple (Multiples) : les utilisateurs peuvent sélectionner plusieurs enregistrements.
    • Configure each record (Configurer chaque enregistrement) : honorez les paramètres des données sources ou personnalisez les résultats en spécifiant les champs à afficher de la couche et en fournissant un en-tête explicite. Si vous sélectionnez Customize (Personnaliser), seuls les champs que vous définissez comme champs d’affichage ou incluez dans l’en-tête sont exportés lorsque l’utilisateur exporte au format d’élément JSON, CSV, GeoJSON ou ArcGIS.
    • Expand by default (Développer par défaut) : cochez cette case pour développer tous les nœuds de résultat par défaut.
    • Sort records (Trier les enregistrements) : configurez les champs selon lesquels trier la liste de résultats.
• Arrangement style (Style de disposition) : sélectionnez Vertical, Horizontal ou Icon (Icône) pour personnaliser le style des requêtes dans le widget.
• Result style (Style de résultat) : organisez les résultats de requête horizontalement ou verticalement et sur une seule ou plusieurs pages.
  • Number of records per page (Nombre d’enregistrements par page) (disponible lorsque vous choisissez Multipage pour Paging style (Style de pagination)) : définissez le nombre d’enregistrements à afficher par page. Ce nombre doit être compris entre 10 et 1 000. Au moment de l’exécution, les utilisateurs peuvent choisir le nombre de résultats à afficher par page à l’aide d’un menu déroulant ou en saisissant un nombre. Le menu déroulant contient des valeurs égales à 100 pour cent, 50 pour cent et 33 pour cent du nombre que vous définissez.

    Remarque :

    Le widget Query (Requête) respecte les limitations du nombre maximal d’enregistrements que vous définissez pour les couches d’entités dans l’onglet Data (Données).

Options d’interaction

Le widget Requête génère une source de données en sortie que d’autres widgets peuvent utiliser. L’interaction avec d’autres widgets utilisant la même source de données en sortie s’effectue via l’ajout d’actions. Par exemple, la carte peut afficher automatiquement les résultats de la requête et zoomer sur les entités. Dans les paramètres du widget Requête, dans l’onglet Action, ajoutez le déclencheur Records Created (Enregistrements créés), sélectionnez la carte cible et ajoutez des actions pour Show on map (Afficher sur la carte) et Zoom to (Zoom sur).

Les résultats de la requête s’affichent dans une liste. Pour sélectionner l’élément dans la liste et l’entité correspondante sur la carte, ajoutez le déclencheur Record Selection Changes (Modifications de sélection d’enregistrements) pour le widget Query (Requête). Sélectionnez la structure cible, ajoutez l’action Select Data Records (Sélectionner les enregistrements de données) et configurez-la avec la couche d’entités de la carte et les champs qui associent la connexion entre le déclencheur et les données de l’action. Vous pouvez également ajouter l’action Zoom to (Zoom sur) pour zoomer dans la carte sur l’entité sélectionnée.