> For the complete documentation index, see [llms.txt](https://docs.geodin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geodin.com/geodin-desktop/fr/analyse-des-donnees/query-builder-reference.md). # Référence du générateur de recherche Le Constructeur de recherche définit des recherches partielles GeoDin comme un ensemble de Définitions de nœuds individuelles - liste de Tableau, clause FROM, conditions, Résultat et champs d’affichage - que GeoDin combine en une instruction SQL Plein complète. Cette page est la référence pour chaque nœud de cette définition : ce qu’il configure et la syntaxe qu’il accepte. Utiliser cette page lorsque vous construisez ou modifiez une recherche et que vous devez savoir ce que fait un nœud spécifique. Elle couvre aussi les Requêtes système - ce qu’elles sont, le Répertoire QUERYDEF, et les nœuds de Requêtes système (Besoins, Afficher les conditions, affichage et Options de représentation). *** ## Travailler avec les Requêtes système Les Requêtes système contiennent les Définitions des Requêtes sur la base de données et sont stockées dans leurs propres Fichiers avec l'extension `.GSQ` (GeoDin Requête système). Une définition de recherche n'est normalement pas spécifique à un seul système de Base de données, donc elle peut être transmise à d'autres Utilisateur. Contrairement aux Requêtes utilisateur, qui appartiennent à une seule Base de données ou Projet, les Requêtes système sont automatiquement Disponible pour tous les Utilisateur dans chaque Base de données et Projet - elles n'ont jamais besoin d'être recréé par Base de données. Trois choses sont généralement obtenues avec eux : * **Définissez une recherche une fois et retrouvez-la partout.** Si plusieurs Bases de données sont régulièrement interrogées pour des Résultats similaires, la recherche n’a pas besoin d’être reconstruite pour chacune d’elles. Définie comme Requête système, elle est ajoutée automatiquement à chaque Base de données comme une branche Nouveau dans le gestionnaire de Puits GeoDin, et les conditions à la recherche s’adaptent à l’endroit et à la manière dont elle apparaît. * **Étendez OU restructurez le gestionnaire de Puits.** La structure du gestionnaire de Puits Texte standard est définie par GeoDin : Objets inclus dans une branche, Stations de mesure inclus dans une autre. Une Requête système peut Modifier cela - par exemple en affichant les Échantillons appartenant sur un Trou de forage directement sous ce Trou de forage, au lieu de seulement inclus dans la branche séparée **Stations de mesure** branche. * **Fournissez des Modèles de recherche pour les utilisateurs moins expérimentés.** Fort complexes Requêtes joignent souvent de nombreux Tableaux GeoDin via des champs de Lien tels que `PRJ_Identification`, `LOCID` et `INVID`, ce qui nécessite une bonne connaissance de la Structure de la table. L’assistant de recherche propose les jointures les plus courantes, mais pas toutes celles possibles. Une Requête système comble cet écart en fournissant la jointure sous forme de modèle prêt, de sorte que l’Utilisateur n’ait plus qu’à fournir les conditions et les champs d’affichage. ### Le Répertoire QUERYDEF Les Requêtes système sont stockées inclus le `QUERYDEF` Répertoire de l'Installation GeoDin, un Fichier par recherche. La Méthode **Nouvelle recherche** crée un nouveau Fichier là sous le Nom que vous saisissez. Si une structure de Répertoire est créé à l'intérieur `QUERYDEF`, la même structure apparaît inclus dans le gestionnaire de Puits GeoDin, ce qui permet de donner un ordre logique à une collection Plus grand de Requêtes. GeoDin lui-même n'a Non Méthode pour créer ces sous-dossiers - Utiliser l'Explorateur Windows. Les Fichiers de recherche qui ne sont plus nécessaires sont supprimés de la même manière. Après avoir restructuré le Répertoire dans l’Explorateur Windows, cliquez avec le bouton droit sur le **Requêtes** branche dans l’onglet Système et choisissez **Mettre à jour** pour mettre à jour la vue du gestionnaire de Puits. Il n’est pas nécessaire de redémarrer GeoDin pour prendre en compte une nouvelle structure de Nouveau fichier ou de nouveaux Fichiers de recherche. ## Référence : nœuds du générateur de recherche Chaque sous-section ci-dessous documente un nœud de la définition de la sous-requête (recherches partielles), dans l’ordre où ils apparaissent dans le générateur. ### Tableaux La liste des Tableaux d’une sous-requête (recherches partielles) Contient tous les identifiants des Tableaux ou des Vues Utilisé dans la recherche. Il s’agit des noms des Tableau/Vues dans la Base de données référencés dans l’instruction FROM. Le but de cette liste est d’ajouter, si nécessaire, des ajouts de schéma à ces noms avant que l’instruction SQL ne soit exécutée. Comme l’instruction FROM peut contenir N’importe quelle syntaxe SQL (inclure la syntaxe spécifique à la Base de données), GeoDin n’évaluera pas cette chaîne pour déterminer quels noms de Tableau doivent être étendus avec un nom de schéma. Au lieu de cela, la liste de Tableaux définie ici indique à GeoDin quels noms inclure dans l’instruction FROM et dans les autres parties de la configuration de recherche. Tous les noms spécifiés ici sont automatiquement étendus avec le nom du schéma issu de la configuration de Base de données GeoDin. **Exemple :** Tous les tableaux GeoDin ont été Créé par l’utilisateur dbo (propriétaire de la Base de données) de la Base de données. Par conséquent, tous les tableaux ne peuvent être accessibles par d’autres Utilisateurs que si le schéma est répertorié et que le nom Plein du Tableau est utilisé : dbo.GeoDin\_LOC\_LOCREG Pour éviter d’avoir à spécifier le remplacement du schéma pour chaque Tableau, il est possible de stocker le schéma des Tableaux GeoDin dans la configuration de Connexion à la base de données **Configuration** pour les Bases de données Utilisateur. ***Note :*** *Les noms d’alias donnés dans l’instruction FROM (par exemple pour des sous-recherches) ne peuvent pas être inclus ici. Sinon, l’extension du schéma sera ajoutée à l’alias et l’instruction échouera.* ### Requêtes système au niveau du Projet (GeoDin 10 et versions ultérieures) Depuis le changement de structure du Projet GeoDin 10, une requête système qui doit être affichée au niveau du Projet doit inclure le tableau d’Enregistrement de puits `GEODIN_LOC_LOCREG` - l’ajouter à la liste des tableaux et à la clause FROM de la recherche. {% hint style="warning" %} Si le tableau d’Enregistrement de puits est omis d’une requête système au niveau du Projet, l’exécution de la recherche renvoie une des erreurs suivantes, selon le système de Base de données : * Base de données Access de Microsoft : `[FireDAC][...] Trop peu de Paramètres. 1 attendu.` * Base de données Client/Serveur : `[FireDAC][...] Nom de Colonne Invalide 'ProjectGUID'.` {% endhint %} ### Configuration Dans la configuration, les Paramètres de la recherche sont définis, sur la Base de données utilisée pour la recherche. La configuration couvre : 1. l'instruction FROM à la [Lien (FROM)](/geodin-desktop/fr/analyse-des-donnees/query-builder-reference/conditions-and-operators.md) nœud pour la Commande SQL 2. et d'autres critères [Champs restrictifs](/geodin-desktop/fr/analyse-des-donnees/query-builder-reference/conditions-and-operators.md) pour la restriction automatique (WHERE) de la recherche, selon la position de la recherche dans le gestionnaire de Puits GeoDin 3. Définition des informations nécessaire pour le traitement du Résultat de la requête [Champs de résultat](/geodin-desktop/fr/analyse-des-donnees/query-builder-reference/conditions-and-operators.md) à l'Entrée ***Sous-requêtes*** Il est possible de Vue la recherche en cliquant sur « SQL Aperçu avant impression » à la recherches partielles souhaitée. ***Note :*** *La requête SQL affichée dans l’Aperçu avant impression peut être testée directement dans la Base de données, inclus après avoir remplacé le Projet Identification ($PRJID), l’Emplacement-Identification ($LOCID) OU le INVID ($INVID)* **Options supplémentaires :** 1. \*-\*DISTINCT par recherche Exécution inclus dans le GeoDin Puits Manager- Définissez si une commande SELECT DISTINCT ... doit être exécutée dans la requête ou uniquement une commande SELECT. Dans les deux cas, GeoDin affiche un objet qui est disponible plus d'une fois dans une requête une seule fois dans le gestionnaire d'objets. Cela se fait par une vérification des ID d'objet. Un DISTINCT général n'est pas utilisé par défaut, car l'utilisation de cette commande dépend de la conception de la requête. Si vous êtes sûr que votre Commande SQL permet un distinct, cette option peut accélérer considérablement la requête. 1. -Ignorer l'erreur- Si la recherche conduit sur une Erreur, Par défaut un message d'Erreur est affiché. Vous pouvez Masquer le message d'Erreur en utilisant cette option. Si l'exécution de la recherche conduit sur une Erreur de cette façon, l'Erreur est Ignorer et la recherche n'est pas insérée inclus le Puits manager. Vous pouvez Utiliser cette option, si vous voulez Créer une recherche, qui ne peut pas être Utilisé dans N'importe type de Base de données et vous voulez Ignorer cette Erreur. Il est recommandé qu'au lieu d'Utiliser cette option la configuration de la **Besoins** sont utilisés pour une recherche, car il est toujours plus rapide de contrôler les besoins que de rencontrer une erreur dans une recherche. 1. -Utiliser DISTINCT pour Exporter la Forme- Si la recherche est utilisée sur Créer un Fichier de Forme, vous pouvez Sélectionner ici s’il faut utiliser une commande de Sélectionner DISTINCT ou une commande de "simple" Sélectionner pour l’Exporter de la Forme. ### Condition Cette section de la définition de Requêtes système peut être utilisée en option pour limiter les Résultats de la recherche. Cette section est comparable à l'instruction WHERE d'une recherche SQL et est ajoutée automatiquement sur la recherche de la Base de données. Ajouter inclus la Liste une ou plusieurs entrées sur Editer. ### OU **¯¯¯** Cette section des Requêtes système peut être utilisée pour affiner les Résultats de la recherche. Elle est équivalente à la restriction WHERE d’une recherche SQL et sera ajoutée automatiquement à la recherche de Base de données. Les opérateurs logiques possibles sont les relations ET et OU, qui peuvent être ordonnées en deux niveaux. Le premier niveau lie les sous-recherches connectées avec un OU. La première condition apparaît avec le mot-clé SI et marque le début des conditions. inclus dans la premier Étape, il est donc défini : <\> OU <\> OU <\> ... à la Seconde Niveau, les Conditions simples sont les critères « Vrai » de la recherche, où les opérateurs ET peuvent être utilisés. **Exemples de conditions** Exemple utilisant les Coordonnées d'une Stations de mesure (Opérateur OU) : La recherche devra trouver tous / toutes les Stations de mesure où soit la X-Coordonnée (XCOORD) est supérieure à 100 OU la Y-Coordonnée est supérieure à 50. Les conditions seraient : ``` Si XCOORD \> 100 OU YCOORD \> 50 ``` L'exemple peut être étendu pour démontrer la Recherchez des Objets avec leurs Coordonnées (relation OU et ET). La recherche trouve tous / toutes les Stations de mesure avec X-Coordonnée supérieure à 100 ET inférieure à 200 OU avec Y-Coordonnée supérieure à 50 ET inférieure à 100 : ``` Si XCOORD \> 100 XCOORD \< 200 OU XCOORD \> 50 YCOORD \< 100 ``` Si les conditions pour Tous les deux les X-Coordonnées et les Y-Coordonnées doivent correspondre, les conditions sont saisies sur le Seconde Niveau (ET) de la recherche : ``` Si XCOORD \> 100 XCOORD \< 200 YCOORD \> 50 YCOORD \< 100 ``` ### ET à le Niveau des conditions, différentes conditions de Recherchez doivent être définies. Ici, les conditions sont définies soit comme Conditions simples, OU comme une combinaison avec l'ET logique. Il est possible sur combiner des groupes de conditions entre eux par un logique [OU](/geodin-desktop/fr/analyse-des-donnees/query-builder-reference/conditions-and-operators.md). **Configuration des conditions** Inclus le champ Nom du champ de la base de données, le Nom de champ du Champ de données doit être défini sur lequel il doit être utilisé pour la recherche. Le Nom de champ est indiqué au Format de papier \.Nom de champ. Dans le champ « condition », la condition souhaitée peut être définie directement, ou une condition paramétrée peut être utilisée. Si elle est définie directement, la CONDITION s'exprime sous la forme d’une expression logique avec un opérateur relationnel et une valeur. Opérateurs relationnels possibles : \> supérieur à \=> supérieur OU égal sur < inférieur à <= inférieur ou égal \= égal sur <> pas égal sur est nul Champ de données est Vide n'est pas nul Champ de données n'est pas Vide semblable 'A%' Contenus dans des guillemets haut, haute en utilisant des jokers dans la chaîne de caractères : \_ un caractère ou % plusieurs caractères inclus ('T1','T2') Liste de Valeurs dans des parenthèses Rond, Valeurs séparées par des virgules, les champs texte ont des Valeurs en haut, haute guillemets, Champ numérique ont des Valeurs utilisant le point décimal (pas une virgule) et exclus haut, haute guillemets **Conditions** que recherche un **date** : veuillez vérifier votre Base de données pour le formatage correct : Les formats standard suivants sont disponibles : Accès #MM/JJ/AAAA# Oracle 'JJ-MM-AAAA' MySQL, MS SQL, PostgreSQL 'DD.MM.YYYY' **Conditions** que recherche un **Date/Heure(Date/Heure)**: veuillez utiliser les formats standards suivants : Accès : #MM/JJ/AAAA HH:MM:SS# Oracle : TO\_DATE('*31.05.2015 12:24:36'*,'dd.mm.yyyy hh24:mi:ss') MySQL, MS SQL, PostgreSQL : 'DD.MM.YYYY HH:MM:SS' Si une Requête paramétrée est utilisée, une fenêtre s'ouvre lorsque la recherche est exécutée au premier moment. tous / toutes les Conditions marquées comme paramétrées peuvent être saisies et modifiées dans cette fenêtre. ***Note :*** *L'utilisation d'une condition paramétrée est indiquée par les caractères ":?". En option, un Opérateur de comparaison peut être spécifié avant cette chaîne de caractères. Dans ce cas, cet Opérateur est prérempli lorsque les Paramètres sont interrogés.* Si une Requête paramétrée est utilisée, les différents Paramètres nécessaires deviennent Disponible. Le Paramètre peut être marqué comme nécessaire - s'il n'est pas nécessaire, le Paramètre sera ignoré lorsqu'il est vide. Il est également possible de saisir une Valeur par défaut et d'Utiliser intervalle. L'option -Utiliser intervalle- produit un type spécial de condition. Si vous voulez Sélectionner des Objets dans une zone définie autour d'une coordonnée sélectionnée, la condition suivante est possible : 1. Nom de champ de données : GeoDin\_LOC\_LOCREG.XCOORD 2. Condition : >=:? 3. x Utiliser intervalle 4. 100 Lorsque la recherche est exécutée, une fenêtre de saisie s'affiche montrant la coordonnée X sélectionnée (Easting), la distance (Valeur par défaut 100) à saisir. La condition WHERE suivante est ajoutée automatiquement à l'instruction SQL : ... (GeoDin\_LOC\_LOCREG.XCOORD >= C*coordonnée*-100) et (GeoDin\_LOC\_LOCREG.XCOORD <= C\*coordonnée+\*100) Si vous sélectionnez une deuxième condition pour le champ de données GeoDin\_LOC\_LOCREG.YCOORD (coordonnée nord), des objets peuvent être sélectionnés dans un rectangle donné autour de l’emplacement sélectionné en saisissant 3 nombres au lieu de saisir les coins du rectangle. **Utilisation du paramètre $%SYSDATE$** Vous pouvez utiliser $%SYSDATE$ comme espace réservé pour le paramètre de date, afin de sélectionner la date actuellement comme valeur par défaut. Des termes mathématiques avec la macro $%SYSDATE$ sont également possibles, par exemple $%SYSDATE$-7 pour sélectionner le même jour il y a une semaine. ### Champs d'affichage Les champs d’affichage définissent quels champs de base de données d’un objet doivent être affichés dans le gestionnaire d’objets GeoDin (GOM). Les objets et les contenus affichés sont en réalité les résultats d’une recherche ; il s’agit généralement du nom d’un objet ou de « LONGNAME ». Il est toutefois possible de combiner des champs pour un affichage plus détaillé, tel que le nom et le type de trou de forage. Vous pouvez organiser quels champs et combien de champs doivent être affichés [Montrer le champ](/geodin-desktop/fr/analyse-des-donnees/query-builder-reference/conditions-and-operators.md). Il existe des instructions de formatage facultatives sur l’affichage du Texte. Dans le champ de saisie, vous pouvez définir la macro qui est appliquée sur les résultats de la requête SQL. Si aucune macro n'est définie, les Enregistrements de données seront affichés tels qu'ils existent inclus dans la Base de données. Cela signifie par exemple que les codes ne seront pas retraduits Retour sur Plein Texte, mais affichés comme des codes. La macro ne peut contenir que des références sur des champs d'affichage définis. Ainsi, la macro ne remplace pas les champs d'affichage mais les complète et les formate. Sélectionner DISTINCT GeoDin\_LOC\_LOCREG.LOCID, GeoDin\_LOC\_ZMGENINF.SHORTNAME, GeoDin\_LOC\_ZMGENINF.PURPOSE .... Les macros de Texte sont implémentées exactement de la même manière que dans un modèle, d’où la Gamme d’Options de formatage Disponible inclus. **Exemple :** $GeoDin\_LOC\_ ZMGENINF. NOM COURT $ ($GeoDin\_LOC\_ZMGENINF.PURPOSE $) Lors de l’utilisation d’un Texte macro, une macro additionnel doit être définie et est utilisée lorsque la macro est actualisée dans le GOM. Cela se produit chaque fois que les Données générales sont modifiées et enregistrées. À cette heure, le Puits chargé est utilisé pour résoudre la macro. La recherche initiale ni l’enregistrement de données qui fournit l’Entrée dans le GOM, puisque ce n’est pas nécessaire et n’utiliserait que de la mémoire inutilement. La macro pour Mettre à jour doit être créé comme dans un modèle avec des références de champ au Puits. D’ordinaire, les noms de Tableau précédents sont omis. ### Champs de tri Ici, des Champs de données additionnel peuvent être sélectionnés comme Tri additionnel pour les Résultats de la recherche (c.-à-d. indépendants des champs affichés). Un champ de tri est défini en utilisant \.\. Une commande ORDER BY est automatiquement ajoutée sur l'instruction SQL lors de l'utilisation des Champs de tri. De plus, vous pouvez définir, Si le tri est utilisé pour Exécution inclus dans le gestionnaire de Puits ou inclus dans Sélectionner une mise en page. ### Champs de résultat Les Champs de résultat sont ajoutés sur la Liste de Champ de données de l'instruction Sélectionner et définissent la structure des données de résultat. Un Champ de résultat est défini par \.\. **Ce que les Champs de résultat doivent sur contenir** Les identifiants et les Coordonnées dont GeoDin a besoin du Résultat dépendent de ce à quoi sert la recherche. La même recherche est exécutée différemment lorsque 1. son nœud de résultat est ajouté sur le gestionnaire d’objets, 2. il est utilisé pour un Exporter de Forme ou inclus dans l'Extension pour ArcGIS, ou 3. il fournit des données pour un Rapport. Pour le premier cas, les Champs de résultat doivent uniquement contenir les identifiants d’objet GeoDin ; les Coordonnées ne sont pas pertinentes. En revanche, de nombreuses Opérations SIG utilisent les Champs de données pour les Coordonnées X et Y (`XCOORD` et `YCOORD`) ensemble avec un Champ de données contenant un ID d'objet unique - généralement le `INVID` d'un objet. Étant donné qu'une recherche peut s'adresser à n'importe quel tableau dans la base de données, y compris aux tableaux non-GeoDin, cet Identification d'objet peut provenir d'un autre tableau et pas doit avoir sur être le `INVID`. Quels champs d’identifiant sont attendus dépend aussi du type de Résultat Puits, qui est sélectionné dans la Requête système : | Résultat Type de puits | Champs d’identifiant attendus | | ------------------------- | ------------------------------------------------------------------------------------------------------- | | Puits (Rouge) | un champ avec l'Identification du Projet (`PRJ_Identification`) et un champ avec l’ID d'objet (`LOCID`) | | Stations de mesure (Bleu) | un champ avec l'Identification des Stations de mesure (`INVID`) | Les Colonnes d’origine peuvent avoir des noms différents. Comme pour les autres colonnes d’identification, elles sont données dans le format de papier `.` ET doit sur être Disponible comme une Colonne inclus dans le Résultat de la recherche. {% hint style="success" %} Lorsque c’est possible, Remplissage inclus tous / toutes les champs. Une définition de Résultat qui porte Tous les deux les identifiants et les Coordonnées permet à la même recherche de servir à tous / toutes les usages — gestionnaire de Puits, Forme et Exporter ArcGIS, et Rapports — au lieu d’un seul. {% endhint %} ### recherches partielles Une recherches partielles est une recherche indépendante à la Base de données (une instruction SQL), qui fournit une quantité de Résultats. L’instruction SQL est Non défini comme une instruction Plein, mais par l’intermédiaire d’un Nombre de Définitions individuelles. Dans des champs de saisie distincts, certains fragments de la recherche sont définis, lesquels sont combinés sur une instruction SQL Plein par GeoDin. La raison en est un Nombre de parties variables de l’instruction SQL, par exemple la Liste de champs dans Sélectionner, qui sera créé dans GeoDin selon l’utilisation désignée. C’est le seul moyen d’obtenir une recherche optimisée (orientée vers un objectif) dans la Base de données, qui diffère grandement, par exemple, lors de l’exécution de la recherche dans le gestionnaire de Puits GeoDin par rapport à l’exécution de la même recherche pour la récupération de données dans une Sélectionner une mise en page. **Nom** Ici, un Nom pour les recherches partielles peut être saisi. **Description du modèle** Saisissez ici une brève description de la recherche. La description est affichée dans l’assistant de recherche, si la recherche est définie comme un modèle pour les Requêtes Utilisateur (voir [Travailler avec les Requêtes système](#working-with-system-queries)) **Combiner les conditions avec OU/ET** Cette option contrôle la combinaison de Conditions simples de la recherche. Selon Le recherche avec plusieurs conditions le *"OU"* connexion inclus le nœud principal (Condition 1 et Condition 2) ou (Condition 1 et Condition 3) peut être mieux remplacé par un *« Et »* connexion inclus le nœud principal (Condition 1) et (Condition 2 ou Condition 3). **Aperçu avant impression SQL** Ici, la Commande SQL est affichée en fonction de la configuration actuellement de la requête. **Type de requête d’une requête de cadre d’objet** Lors de la modification d’un [requête de cadre d’objet](/geodin-desktop/fr/visualisation-mises-en-page-et-rapports/creating-custom-layouts/object-frames.md#object-frame-queries) vous pouvez choisir compris entre la définition d’un modèle structuré ou d’une instruction SQL complète. Une instruction SQL permet toutes les possibilités de sélection de données (par ex. SÉLECTIONNER COMPTE(ChampDeDonnées) AS GCCOUNT FROM tableau), mais n’est probablement pas exécutable dans tous les types de base de données. En général, un modèle structuré est préférable. ### Lien (FROM) Le Lien est la clause FROM d'une instruction SQL. Les informations peuvent être collectées à partir d'un Tableau ou d'un ensemble de Tableaux comme défini dans la condition FROM. Si un seul Tableau est sélectionné, seul le Nom de tableau doit être saisi ici. Pour des expressions plus complexes, la syntaxe de la clause FROM doit suivre les spécifications SQL du Système de Base de données utilisé. La définition ou la structure de la clause FROM peut varier entre différents systèmes de Base de données en raison des spécifications de la syntaxe SQL spécifique. ***Astuce :*** *Il peut être utile de créer d'abord la recherche dans un programme de Base de données à l'aide d'un éditeur de recherche graphique. Ensuite, la clause FROM de l'instruction peut être copiée ici (Exemple : l'éditeur de recherche dans MS Access)* ### Champs restrictifs Les Champs restrictifs sont utilisés pour définir des Champs de données que GeoDin ajoute automatiquement à la condition WHERE de la recherche en fonction de la position de la recherche dans le gestionnaire de Puits afin de restreindre le Résultat selon la structure du gestionnaire de Puits. La base sont les [Afficher les conditions](/geodin-desktop/fr/analyse-des-donnees/query-builder-reference/conditions-and-operators.md) de la recherche. **Base de données, Requêtes sur la base de données** Les Requêtes ne sont pas davantage restreintes. Les Champs restrictifs peuvent rester vides. **Projet, Requêtes sur le projet** Les Requêtes sont restreintes en utilisant le Projet Identification. Le champ de restriction PRJ\_ID a sur être rempli. **Puits** La recherche est limitée en utilisant le Projet ID et l’ID d'objet. Les Champs restrictifs PRJ\_ID et LOCID doivent être remplis. **Stations de mesure** La recherche est restreinte en utilisant l'Identification des Stations de mesure. Le champ de restriction INVID doit être rempli. Les Colonnes doivent sur être sélectionné inclus dans le Format de papier \.\ ET doivent sur faire partie du Résultat de la recherche. ### Montrer le champ Les champs d'affichage définissent quels champs de Base de données sont utilisés pour nommer les Résultats de la recherche, inclus dans le gestionnaire de Puits GeoDin. Ainsi, le Nom peut être composé à partir de plusieurs champs. Un champ de Base de données couramment utilisé est le Nom de l'objet LONGNAME. Mais vous pouvez aussi Utiliser des noms combinés semblable à Nom et Profondeur. ``` Base de données DemoDB Démo GeoDin Objets Stations de mesure Projet Trou de forage 1 Trou de forage 2 Projet 2 Projet 3 Objets Stations de mesure Base de données ``` **Nom du Champ de données** Inclus dans ce champ, le Champ de données à afficher est défini sur le formulaire \.\. **Texte d’extension** Les caractères saisis ici sont ajoutés sur le Contenu du Champ de données sous forme de « Texte d'extension ». Par exemple, le Contenu d’un champ d’affichage (Montrer le champ) tel que GeoDin\_LOC\_LOCREG.ZCOORDE (Profondeur finale) peut être complété avec l’Unité de mesure, par ex. : « m » ou avec des versions plus longues, telles que « m inclus sous Niveau du sol ». **Critères de Trier** Sélectionner la séquence de tri sur ce Champ de données. Une clause ORDER BY est automatiquement ajoutée sur l'instruction SQL. ### Propriétés du portail Le **Propriétés du portail** Le nœud contient les Paramètres dont une recherche a besoin lorsque sa Sélectionner une mise en page est utilisée comme une Mise en page du portail. Une Mise en page du portail est une Sélectionner une mise en page GeoDin qui Contient Au moins un Elément avec un Lien du portail, c’est-à-dire une instruction sur appeler une autre Sélectionner une mise en page GeoDin. Les Mises en page qui s’appellent les unes les autres assembler / composer un réseau complet de présentations ET de Rapports — un Portail. Les Mise en page du portails peuvent être créé ET Utilisé dans N'importe quelle combinaison de modules GeoDin ; inclus une installation GeoDin Portail Server, elles constituent l’interface frontale liée par laquelle le lecteur navigue dans les présentations ET les données inclus un navigateur. Un Texte standard Graphique n’offre aucune fonction de Portail ; il doit donc être préparé en premier. En mode Editer, sélectionnez l’arborescence Puits du graphique - si vous avez un doute, cliquez sur la zone Blanc à côté des cadres Puits - ouvrir **Propriétés étendues** inclus les Propriétés d'objet du Graphique et activez l'option **Activer la fonction Portail**. Un Nouveau **Propriétés du portail** la branche apparaît ensuite sous les propriétés étendues, et les éléments **Texte variable** et **Image variable** obtenir la possibilité de configurer des Liens du portail. La configuration des Liens eux-mêmes est décrite sous [Création de Plans du site](/geodin-desktop/fr/visualisation-mises-en-page-et-rapports/creating-site-plans.md). Basculement **Activer la fonction Portail** La désactivation à nouveau à une Mise en page du portail existante supprime les Propriétés du portail de tous / toutes les éléments affectés du Graphique. Les Paramètres ne sont toutefois pas perdus - pas même lorsque le Graphique est enregistré - et peuvent être réactivés Plus tard. **Comment une recherche appelée reçoit l'ID d'objet** Une mise en page appelée se limite aux objets par défaut. La mise en page appelante (mise en page source) détermine quel Identification d'objet est transmis ; la mise en page appelée (mise en page cible) le résout via le [Champs de résultat](#result-fields) de sa recherche de Cadre, qui déclare quelle Colonne du Tableau de Résultat contient `PRJ_Identification`, `LOCID` OU `INVID`. `PRJ_Identification` et `LOCID` suffisent pour les Objets ; les Stations de mesure nécessitent `INVID`. Si ces affectations sont manquantes, la requête ne peut pas être exécutée et un message d’erreur est émis. Définir tous les champs lorsque seuls certains sont nécessaires ne pose aucun problème. En interne, lors du passage d’un ID d'objet, Toujours appends une restriction à l’instruction de la mise en page appelée, construite à partir des entrées dans les Champs de résultat. Si l’instruction possède déjà une clause WHERE, la restriction est ajoutée comme une construction AND. Au-delà des identifiants d’objets, d’autres Paramètres peuvent être transmis à la recherche dans la mise en page cible ; ils ne prennent effet que là où des conditions correspondantes sont définies dans cette recherche, et les Paramètres transmis sans condition d’évaluation n’ont aucune conséquence. Une Sélectionner une mise en page multi-Cadre ne reçoit pas un objet IDs à tous / toutes - là, la premier recherche de Cadre fournit les identifiants de Puits. Si la recherche du Cadre utilise une instruction SQL individuelle au lieu d’une recherche structurée, uniquement `PRJ_Identification`, `LOCID` et `INVID` peut être transmise, et l'instruction doit contenir l'espace réservé correspondant pour que la valeur sur soit évaluée : | Espace réservé | Passes | | -------------- | ------------------------------------------------ | | `%INVID` | les `INVID` (identifiant de Stations de mesure) | | `%PRJID` | les `PRJ_Identification` (identifiant de Projet) | | `%LOCID` | les `LOCID` (Index de l'objet) | ### Propriétés de site web Ici, vous définissez la Résolution, le Rafraîchir l'intervalle et une couleur d'Arrière-plan pour le Site Web. Vous pouvez aussi Sélectionner un Modèle HTML pour le Site Web. **maintenir la Sélectionner une mise en page en cache :** quand cette case est cochée, la Sélectionner une mise en page est maintenue en cache pendant un certain temps. Selon la Sélectionner une mise en page, cela peut réduire sensiblement le temps de réponse du serveur. ### Paramètres du cache Ici, vous définissez le Nombre de minutes pendant lesquelles La mise en page est conservée dans le cache. Si, par exemple, les données des mises en page de surveillance sont actualisées toutes les cinq minutes, il est logique de maintenir la mise en page dans le cache pendant cinq minutes également. Après ce délai, elle est supprimée automatiquement et reconnectée avec des données fraîches à la requête suivante. ## Référence : nœuds de Requête système Une Requête système comporte un Seconde groupe de nœuds à côté de la définition des recherches partielles ci-dessus. Ils ne donnent pas de Forme à l'instruction SQL — ils décident si la recherche s'exécute contre une Base de données donnée du tout, où ses Résultats apparaissent dans le gestionnaire de Puits GeoDin, et comment ces Résultats sont affichés. ### Besoins Le **Besoins** Le nœud définit les conditions de base dans lesquelles la Requête système est exécutée dans une Base de données et ajoutée au gestionnaire de Puits. Comme une recherche utilise des tableaux de Base de données spécifiques, ces tableaux peuvent ne pas exister partout : une Base de données peut utiliser le Type de puits "Général Profil de forage - British Texte standard" tandis qu'une autre utilise différents Types d'objets ; ainsi, une recherche sur la table `GEODIN_LOC_BSSRCLAS` créé pour le Général Profil de forage mène sur une Erreur inclus la Seconde Base de données. Saisissez une condition par Ligne. Chaque Ligne doit être satisfaite (ET) ; Si une seule exigence n'est pas satisfaite, la recherche est ignorée pour cette Base de données. Les exceptions sont `Nom d'utilisateur=` et `Connexion au poste de travail=` lignes, qui sont combinées avec OU afin qu'elles puissent être saisies pour plusieurs utilisateurs différents. Dans une ligne, les valeurs séparées par des virgules sont des alternatives (OU). | Condition | Vérifications | | --------------------------- | ----------------------------------------------------------------------------------- | | `LOCTYPE=` | Le type de puits nommé est installé dans la base de données actuellement | | `DATTYPE=` | Le type de donnée nommé est configuré dans la base de données actuellement | | `ADOConnectionHas=` | La chaîne de connexion à la base de données contient la chaîne de caractères donnée | | `Nom d'utilisateur=` | Le nom de connexion à la base de données de l'utilisateur correspond actuellement | | `WorkstationLogin=` | Le nom de connexion Windows de l'utilisateur actuellement — Concordances | **Restreindre à un Type de puits spécifique** Les Types d'objets installés sont vérifiés avec la variable `LOCTYPE=`. Dans l'exemple suivant, la recherche n'est affichée que si le Type de puits « Général Profil de forage » est utilisé dans la Base de données actuellement : ``` LOCTYPE=BSBORLOG ``` L'Abréviation du Type de puits est affichée lorsque la Méthode **Nouveau point** est utilisée - prenez note de ce Nom pour l'Utiliser sur ici. Si plusieurs Abréviations sont données séparées par des virgules, GeoDin vérifie si Au moins un des Types d'objets existe (OU) : ``` LOCTYPE=LOCTYPE1,LOCTYPE2 ``` Si deux lignes ou plus commençant par `LOCTYPE=` sont fournies, GeoDin vérifie si tous les Types d'objets sont présents (ET) : ``` LOCTYPE=LOCTYPE1 LOCTYPE=LOCTYPE2 ``` **Restreindre à un Type de donnée spécifique** Les Types de données configurés dans la Base de données sont vérifiés avec la variable `DATTYPE=`. Dans l'exemple suivant, la recherche s'affiche uniquement si le Type de donnée "Chimie de la nappe phréatique" existe : ``` DATTYPE=WAS ``` Les noms courts des Types de données sont affichés inclus les Propriétés d’un Type de donnée Le Système onglet. **Restreindre sur un Système de Base de données particulier** La variable `ADOConnectionHas=` restreint la recherche sur un Système de Base de données spécifique, ce qui est utile pour les Requêtes qui Utiliser la syntaxe SQL Disponible uniquement dans ce cas, telle que la syntaxe Oracle. Parce qu’une Connexion à la base de données est créé à partir d’une Commande de connexion, la restriction est exprimée sous forme d’un fragment de cette chaîne : ``` ADOConnectionHas=MSAcc ``` Ici, la Commande de connexion doit sur contenir la chaîne de caractères `MSAcc`, ce qui est Vrai pour une Base de données Access Microsoft avec une Commande de connexion telle que `DriverID=MSAcc;Base de données=C:\My Data\GeoDin\DB\Access_DB.accdb`, donc la recherche n'est affichée que pour les Bases de données Microsoft Access. La même sémantique des virgules et des lignes s'applique comme pour `LOCTYPE=`. Plusieurs chaînes de caractères séparées par des virgules sont combinées avec OU : ``` ADOConnectionHas=MSAcc,MSSQL ``` Deux ou plus `ADOConnectionHas=` lignes sont combinées avec ET, donc toutes les chaînes doivent être présentes : ``` ADOConnectionHas=MSAcc ADOConnectionHas=MSSQL ``` **Restreindre sur des utilisateurs spécifiques** Les Requêtes système peuvent être restreintes sur des utilisateurs nommés de la Base de données. `Nom d'utilisateur=` vérifie le nom de connexion de l'Utilisateur dans la Base de données, afin qu'une recherche puisse être rendue accessible seulement sur certaines personnes : ``` Nom d'utilisateur=Smith ``` Parce que cela vérifie la connexion à la base de données, il n'est pas Disponible pour les Bases de données Microsoft Access. `Nom d'utilisateur` Les conditions sont combinées avec OU, de sorte que plusieurs utilisateurs peuvent être listés. `Connexion au poste de travail=` Vérifie plutôt le nom de connexion Windows de l'utilisateur actuellement connecté, et est également combiné avec OU. La recherche ci-dessous n'est affichée que lorsque l'utilisateur Windows actuellement connecté est « Smith » ou « Jones » : ``` WorkstationLogin=Smith WorkstationLogin=Jones ``` {% hint style="info" %} Toujours indiquez ce dont une recherche dépend. Pour une Requête système sur des Objets, nommez un Type de puits qui existe dans la Base de données ; si la recherche utilise les Tableaux d'un Type de donnée, nommez aussi ce Type de donnée. Vérifier les Besoins est plus rapide que de tomber sur une Erreur, c'est donc l'alternative recommandée à la **Ignorer l'erreur** option dans le [Configuration](#configuration) nœud. {% endhint %} ### Afficher les conditions Le **Afficher les conditions** le nœud définit où, dans le gestionnaire de puits GeoDin, la recherche est affichée, et dans quelles conditions elle est affichée du tout. **recherche sous le Type de puits** Ces paramètres contrôlent à quel Niveau la recherche apparaît : | Niveau | Où la recherche apparaît | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Base de données** | Dans la branche principale de la Base de données, au même niveau qu'un Projet | | **recherche dans la Base de données** | Dans le **Objets** OU **Stations de mesure** branche qui se situe au même niveau que les Projets, selon le type de puits du Résultat de la recherche. Ces branches peuvent déjà contenir des recherches inter-projets spécifiques à l'Utilisateur | | **Projet** | Dans la branche principale d'un Projet, au même niveau que les branches **Objets** et **Stations de mesure** | | **Requêtes sur le projet** | Dans le **Objets** OU **Stations de mesure** branche d’un projet, selon le type de puits de résultat — au même endroit que **Tous les points** et les branches des Types d'objets installés | | **Puits** | Comme sous-branche d’un seul Puits (Rouge), représentant généralement une Dépendance à d’autres Objets | | **Stations de mesure** | Comme sous-branche d’une seule Stations de mesure (Bleu), représentant également une Dépendance sur le plan structurel | **Limites sur les types d'objet** Pour les recherches insérées comme nouvelles branches sous un Puits ou une Stations de mesure, ce Champ de saisie limite les Types d'objets sous lesquels la branche peut être insérée. Supposons qu’une recherche doive lister tous les Échantillons d’un Trou de forage sous ce Trou de forage. Le [Besoins](#requirements) indiquent déjà que la recherche concerne uniquement les Bases de données contenant des Sondages « Général Profil de forage » (`LOCTYPE=BSBORLOG`). Si la Base de données contient également d’autres Objets — qui ne disposent d’aucun Tableau d’Échantillons Général Profil de forage et ne renverraient rien — la branche de recherche ne doit toujours pas leur être proposée. La saisie de ``` LOCTYPE=BSBORLOG ``` restreint la recherche aux Objets de ce type, de sorte qu’elle n’est affichée que sur la branche « Général Profil de forage ». Le Champ de saisie multi-ligne peut contenir plusieurs `LOCTYPE=` entrées ; la recherche est alors Valide pour tous / toutes les Types d'objets répertoriés. **Insérer la recherche uniquement lorsque des Résultats sont présents** Cette option contrôle si la recherche est Toujours visible dans le gestionnaire de Puits ou seulement lorsqu'elle renvoie un Résultat. La recherche est exécutée en premier, et si le jeu de Résultat est Vide, la branche de recherche (pyramide Jaune) n'est pas ajoutée. Cela évite les branches Vide dans le gestionnaire de Puits. {% hint style="warning" %} Activez cette option uniquement après que la recherche a été vérifiée pour les Erreurs de syntaxe et qu’elle s’exécute Sans Erreur dans le gestionnaire de Puits. Une recherche qui Contient une Erreur ne renvoie pas de Résultats, donc, avec cette option active, elle disparaît du gestionnaire de Puits même si ses Afficher les conditions sont remplies — ce qui rend l’Erreur difficile à trouver. {% endhint %} **Ordre de tri inclus dans le gestionnaire d’objets GeoDin** Les Requêtes sont affichées dans l'ordre alphabétique, inclus Par défaut. Saisir un Nombre ici définit une position explicite ; Utiliser différents Nombre à différentes Requêtes système sur les ordonner les unes par rapport aux autres. ### Paramètres d'affichage Le **Paramètres d'affichage** Le nœud définit comment les Résultats de la recherche sont affichés et quelles Méthodes sont Disponible à eux inclus le gestionnaire de Puits GeoDin. **Permet l'expansion des nœuds enfants du Résultat inclus dans le GeoDin Puits Manager** Cette option contrôle si une autre Requête système existante est ajoutée comme Nouveau nœud enfant à un Puits Résultat. Considérez deux Types d'objets avec une relation compris entre eux, «Employé» et «Trou de forage» : une Requête système liste tous / toutes les Sondages sur lesquels un employé a travaillé, et une Seconde Requête système sous le Trou de forage affiche l'employé qui a travaillé à cela. Avec l'option active, développer le Résultat produirait une structure infinie - employé, Trou de forage, employé, Trou de forage, et ainsi de suite. Avec l'option Désactivé, la structure se termine à les Sondages. **Vue étendue du Puits pour les nœuds enfants du Résultat** Avec cette option, les Résultats de la recherche sont testés pour les Valeurs mesurées et les Documents liés, ce qui conduit sur un type particulier d'affichage. Sur des Bases de données fort grandes ou lentes, ce Tes prend du temps, donc l'option peut y être Désactivé. **Méthodes disponibles** Ici, vous définissez quelles Méthodes sont Disponible à le nœud de la recherche elle-même ou à les nœuds de Résultat (Puits ou Stations de mesure). Un champ Vide signifie que GeoDin autorise tous / toutes les Méthodes Texte standard à le nœud. Saisir une Liste d’Identification des Méthodes, séparées par des virgules, limite le nœud sur ces Méthodes ; chaque Méthode GeoDin possède une Identification unique, et les nombres Disponible sont répertoriés inclus dans la section ExecuteMethod de la [Référence de la Méthode de l'API COM](/geodin-desktop/fr/integrations-et-modules-externes/overview-1/method-reference.md). Par exemple, en saisissant `2,6` affiche uniquement **Editer le graphique** et **Plan topographique** à le nœud et supprime les méthodes telles que **Coupe lithologique**, ce qui Mai pas être possible pour ces Objets. ### Options de représentation Une recherche peut être utilisée comme une Couche inclus dans le SIG intégré - voir [Ajout de Couches](/geodin-desktop/fr/cartes/adding-layers.md). Le **Options de représentation** le nœud détermine comment le Résultat de la recherche est affiché là. Cela permet de définir une Requête système qui ne teste pas seulement des conditions et ne fournit pas seulement des Résultats, mais qui emporte déjà avec elle ses Couleurs, ses Modèles de remplissage et ses paramètres de Légende:. {% hint style="info" %} Ces Paramètres peuvent devenir fort complexes. Il est généralement plus facile sur de les assembler / composer premier inclus dans le SIG embarqué avec l’assistant intégré, puis de les Copier comme un Bloc de Texte depuis Propiétés de la couche sur la branche Requêtes système. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.geodin.com/geodin-desktop/fr/analyse-des-donnees/query-builder-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.