Interrogation des couches

L'outil Couche de requête permet aux utilisateurs finaux d'extraire des entités d'une couche de service de carte en renseignant des valeurs dans une requête prédéfinie. Cette requête est définie par la configuration de l'outil au sein d'Application Builder, où il est possible de créer des requêtes complexes qui interrogent plusieurs champs. Chaque condition de la requête est encapsulée dans une expression de requête, ces expressions pouvant être regroupées et jointes grâce aux opérateurs logiques « and » et « or ». Pour chaque expression, l'outil peut être configuré de manière à permettre aux utilisateurs de saisir les valeurs de leur choix, de restreindre leur saisie à une liste prédéfinie ou de ne pas modifier du tout la valeur en entrée. Pour les champs utilisant des domaines, les valeurs sont automatiquement restreintes à celles contenues dans le domaine. Alors que la configuration de l'outil confère une grande souplesse, les utilisateurs de l'outil voient apparaître une simple boîte de dialogue constituée d'étiquettes, de zones de texte et de menus déroulants pour la définition de valeurs de requêtes.

Pour les développeurs, le code source complet de l'outil a été mis à disposition sur ArcGIS Online et donne un exemple d'outil avancé exploitant les extrémités d'extensibilité de la visionneuse. L'implémentation fournit un exemple d'options de configuration de surfaçage complexes qui s'intègrent en toute transparence avec Application Builder, elle montre comment exécuter des requêtes et ajouter des couches par programmation, elle explique comment rendre un complément localisable, etc. Pour afficher le code source, téléchargez l'exemple de l'outil Mesurer d'ArcGIS Online et ouvrez le fichier QueryTool.sln. Pour déboguer le complément, suivez les instructions énoncées dans le fichier texte Deployment and Use Instructions (Instructions de déploiement et d'utilisation) qui accompagne l'exemple.

Configuration de l'outil Couche de requête

Les étapes requises pour configurer l'outil Couche de requête sont présentées ci-après. Les parties de la configuration comptant de nombreuses options sont décrites en détail dans les sections suivantes.

1. Sous l'onglet Outils de la barre d'outils Application Builder, cliquez sur Ajouter un outil. La boîte de dialogue Ajouter un outil s'affiche.
2. Faites défiler jusqu'à la catégorie Requête, puis sélectionnez l'outil Couche de requête :

   

3. Cliquez sur Suivant.
4. Spécifiez les barre d'outils, l'étiquette, l'info-bulle et l'icône de l'outil, puis cliquez sur Suivant. Alors que, dans de nombreux cas, la barre d'outils et l'icône par défaut de l'outil Couche de requête peuvent être adaptées, il est recommandé que l'étiquette et l'info-bulle soient mises à jour afin de refléter la requête que l'outil exécutera. Par exemple, si l'outil est configuré de manière à rechercher les villes américaines dont la population est supérieure à un seuil donné, l'étiquette « Query US Cities » (Requête villes américaines) et l'info-bulle « Find US cities based on population » (Rechercher des villes américaines d'après leur population) seraient adéquates.
5. Spécifiez l'URL de la couche à interroger, puis cliquez sur Connecter. Notez que cet URL doit spécifier une couche dans un service de carte, et non le service de carte en soi :

   

6. Une fois la connexion à la couche établie, cliquez sur Suivant.
7. Spécifiez une expression pour l'interrogation des entités dans la couche, notamment le champ, l'opérateur et la méthode de saisie. Pour plus d'informations, reportez-vous à la section Définition d'une expression de requête ci-dessous.
8. Une fois l'expression de requête définie, cliquez sur Suivant.
9. Une page s'ouvre, répertoriant toutes les expressions de requête qui ont été définies. Puisqu'une seule a été définie pour l'instant, la liste contient une seule expression de requête. Pour définir d'autres expressions de requête, cliquez sur Nouveau. Il est possible de modifier et de supprimer les expressions qui ont déjà été définies grâce aux boutons qui s'affichent en regard. S'il existe plusieurs expressions, leurs différentes combinaisons peuvent être gérées en sélectionnant des opérateurs logiques et des regroupements. Pour plus d'informations, reportez-vous à la section Combinaisons d'expression de requête ci-dessous. Cliquez sur Suivant une fois que vous avez terminé de définir des expressions de requête.
10. Dans la page qui s'affiche, spécifiez les champs à inclure dans les résultats de la requête, et consultez les autres options d'affichage des résultats. Cliquez ensuite sur Suivant.
11. La dernière page de l'assistant définit l'aspect de la boîte de dialogue qui sera présentée aux utilisateurs finaux de l'outil Couche de requête. Le titre qui apparaît dans la partie supérieure de la boîte de dialogue peut être spécifié en haut de la page. Dans la section Apparence des paramètres, il est possible de définir l'étiquette de chaque expression de requête. De la même façon, si une expression de requête possède une valeur par défaut, elle peut être masquée aux yeux des autres utilisateurs en désactivant la case à cocher Visible qui apparaît en regard de l'expression. Cela aura pour effet de toujours utiliser la valeur par défaut de l'expression lors de l'exécution de la requête.
12. Cliquez sur OK en spécifiant que la définition de l'aspect de la boîte de dialogue est terminée. L'outil Couche de requête sera ajouté à la barre d'outils spécifiée.

Définition d'une expression de requête

Dans l'outil Couche de requête, une expression de requête définit une condition par rapport à laquelle les entités dans la couche à interroger sont vérifiées. Si les entités remplissent cette condition, elles sont extraites et affichées sur la carte. Chaque expression de requête est composée des trois parties suivantes :

• Champ : définit quel attribut dans la couche sera vérifié pour y rechercher des valeurs correspondant à la condition définie par l'expression de requête
• Opérateur : spécifie la relation recherchée entre la valeur en entrée et les valeurs dans la couche. Par exemple, l'opérateur supérieur à (>) indique que les entités dont la valeur est supérieure à la valeur en entrée doivent être extraites.
• Méthode de saisie : détermine la façon dont les utilisateurs finaux pourront définir les valeurs en entrée. Si la méthode de saisie Saisir une valeur est sélectionnée, les utilisateurs finaux voient une zone de texte permettant la saisie de la valeur de l'expression de requête. Si la méthode de saisie Choisir une valeur dans la liste est spécifiée, les utilisateurs finaux voient un menu déroulant comportant des valeurs prédéfinies parmi lesquelles ils peuvent faire leur choix.

L'image ci-après montre une expression de requête qui extrait des entités dont la population est supérieure à la valeur en entrée. Une valeur en entrée par défaut de 100 000 a été spécifiée.

Combinaison des expressions de requête

L'outil Couche de requête permet d'inclure plusieurs expressions de requête dans un seul outil. Si spécifier plusieurs expressions est souvent nécessaire pour l'extraction du jeu d'entités de votre choix, le fait d'avoir plusieurs expressions nécessite également de prendre en compte les expressions combinées. Lors de la configuration de l'outil Couche de requête, vous pouvez sélectionner l'opérateur logique utilisé pour combiner plusieurs expressions dans un menu déroulant comme illustré ci-après :

Si vous sélectionnez and, les entités doivent correspondre aux deux expressions de requête pour être incluses dans les résultats de la requête. Si vous spécifiez or, les entités remplissant l'une ou l'autre condition sont extraites.

Vous pouvez également regrouper les expressions afin de les évaluer ensemble. Lorsque vous combinez plusieurs expressions de requête, il est quelquefois nécessaire de s'assurer de l'évaluation souhaitée de la requête. Envisagez l'ensemble d'expressions suivant :

Lorsque les expressions sont combinées comme illustré ci-dessus, la requête extrait les entités qui (1) ont une population supérieure à la première valeur en entrée, (2) ont une population inférieure à la seconde valeur en entrée et (3) qui possèdent une certaine classe (par ex. ville, village, etc), ou elle extrait les entités ne correspondant à aucune de ces conditions, mais qui correspondent à la valeur en entrée de CAPITAL. Supposons que ça n'est pas le comportement souhaité, mais que l'objectif soit plutôt d'extraire des entités correspondant aux conditions de population et à l'une ou l'autre des deux autres conditions. Cela nécessite le regroupement des deux dernières conditions afin d'indiquer qu'elles doivent être évaluées ensemble. Pour ce faire, il suffit de sélectionner les expressions à regrouper en cliquant dessus, puis en cliquant sur le bouton Groupe sélectionné qui apparaît :

Une fois que vous avez terminé, un symbole apparaît en regard des expressions de requête regroupées, qui indique le regroupement :

Une fois les expressions regroupées, vous pouvez supprimer le regroupement en sélectionnant les expressions incluses dans le groupe et en cliquant sur le bouton Dissocier la sélection illustré dans l'image ci-dessus.

Utilisation de l'outil Couche de requête

Une fois l'outil Couche de requête configuré, il est très simple à utiliser. Voici la procédure à suivre :

1. Cliquez sur le bouton Couche de requête dans la barre d'outils. La barre d'outils comprenant l'outil est définie lors de la configuration de l'outil.
2. Si l'outil a été configuré sans paramètres en entrée visibles, la requête s'exécute avec les valeurs par défaut spécifiées lors de la configuration. Dans le cas contraire, une boîte de dialogue s'affiche pour permettre à l'utilisateur final de définir les valeurs en entrée pour la requête. Avec les expressions de requête définies dans la section précédente, la boîte de dialogue peut s'afficher comme illustré dans l'image ci-après. Notez que l'aspect exact varie selon le titre de la boîte de dialogue, les étiquettes et la visibilité des paramètres spécifiés lors de la configuration.

   

3. Saisissez les valeurs de votre choix, puis cliquez sur Exécuter. Une fois la requête terminée, les résultats apparaissent sur la carte :

   

4. Pour supprimer les résultats de la carte, il suffit de fermer la boîte de dialogue. Vous pouvez également conserver les résultats sur la carte après avoir fermé la boîte de dialogue en activant la case à cocher Conserver les résultats sur la carte avant de fermer la boîte de dialogue.

: