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 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 requiert pour ce faire l'ajout d'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.

    Remarque :

    Vous pouvez télécharger les formats d’image suivants : PNG, GIF, JPG, JPEG et BMP.

  • 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.
  • Spatial filter (Filtre spatial) : sélectionnez les filtres spatiaux qui seront disponibles et, éventuellement, choisissez un widget Carte.
    • Label (Étiquette) : personnalisez l'étiquette de la section du filtre spatial.
    • Current map extent (Étendue actuelle de la carte) : permet de renvoyer toutes les entités situées dans l'étendue actuelle de la carte.
    • Interactive draw mode (Mode d’affichage interactif) : permet de renvoyer les entités qui intersectent la 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.
    • Return all features (Renvoyer toutes les entités) : renvoie toutes les entités de la source de données.
  • Résultats
    • Label (Étiquette) : personnalisez l'étiquette de la liste de résultats.
    • List direction (Sens de la liste) : affichez les résultats de la requête dans une liste verticale ou horizontale.
    • Fields (Champs)= : déterminez les champs à afficher à partir de la couche.
    • Sort (Trier) : configurez les champs sur 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 un widget.

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