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 de nouvelles 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.

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 offre 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 complémentaires.
  • 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) : choisissez de renvoyer 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) : une partie ou la totalité d’une entité de la couche source contient entièrement 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 source est complètement entourée par l’entité de la couche de filtre.
      • 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) : choisissez de renvoyer 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 (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 complémentaires.
  • Results (Résultats) : définissez comment afficher les résultats de requête.
    • Label (Étiquette) : personnalisez l’étiquette de la liste de résultats.
    • Configure each record (Configurer chaque enregistrement) : choisissez d’honorer les paramètres des données sources ou de personnaliser les résultats en spécifiant les champs à afficher de la couche et en fournissant un en-tête explicite.
    • 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) : choisissez d’organiser les résultats de requête horizontalement ou verticalement et sur une seule ou plusieurs pages. Par exemple, les utilisateurs peuvent choisir d’afficher 20 résultats par page.

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