> 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/de/datenanalyse/creating-queries.md).

# Abfragen erstellen

Eine Abfrage filtert die im GeoDin-Objektmanager angezeigten Objekte und Messpunkte anhand einer oder mehrerer Bedingungen. Diese Seite behandelt, was Abfragen sind und wie sie abgegrenzt sind, die und/oder-Logik des Abfrage-Assistenten, die Schritt-für-Schritt-Anleitung zum Erstellen Ihrer eigenen Abfrage sowie die vollständige Referenz für Abfragevorlagen, Operatoren und Datumsformate, Anzeigefelder, den alternativen SQL-Befehl und parametrisierte Abfragen. Außerdem behandelt sie Objekt **Gruppen** (manuelle und importbasierte Sammlungen) und die **Feldzuordnung** die Strukturinformationen zu Benutzerdefiniertem SQL hinzufügt.

## Abfragen

Alle Objekte, die im GeoDin-Objektmanager angezeigt werden, sind das Ergebnis einer Abfrage an die GeoDin-Datenbank. Abfragen können auf einzelnen Projekten oder in einer Datenbank (d. h. projektunabhängig) durchgeführt werden. Zusätzlich zu Abfragen, die daraus resultieren, dass eine (Menge von) Bedingung(en) erfüllt ist, ist es auch möglich, eine gemischte Gruppe von Objekten zusammen zu erstellen.

GeoDin führt beim Öffnen eines Projekts oder einer Datenbank automatisch eine Reihe von Abfragen aus und zeigt sie im GeoDin-Objektmanager an. Alle Objekte in einer Datenbank einschließlich verschiedener Typen von Objekten und Messpunkten werden aufgelistet:

Objekte

Alle Objekte

Geotechnisches Bohrloch

BH 01

BH 02

BH 03

BH 04

CPT

Messpunkte

BH

Filter

B01: (4-6m)

B01: (7.5-9.5m)

Proben

B01: (1.4-1.8m)

B01: (2.5-2.9m)

B01: (5.2-5.6m)

Zusätzlich zu den vordefinierten Standardabfragen von GeoDin können Sie mit dem Abfrage-Assistenten Ihre benutzerspezifischen Abfragen erstellen. Die Ergebnisse werden auch im GeoDin-Objektmanager angezeigt - Sie können so viele Abfragen erstellen, wie Sie möchten; die Definitionen werden im Projekt oder in der Datenbank gespeichert. Die Abfragedefinitionen bleiben verfügbar, bis sie aus dem Projekt oder der Datenbank gelöscht werden.\
\
Abhängig davon, für welches Objekt im GeoDin-Objektmanager eine Abfrage definiert wurde, sind die Ergebnisse projektspezifisch oder datenbankweit.

Zum Beispiel eine Abfrage auf einem **Objekt** ODER **Messpunkte** innerhalb eines Projekts kann nur Ergebnisse von Objekten aus dem Projekt erzeugen, in dem es enthalten ist.

DemoDB\
Projekt 1\
Objekte\
Alle Objekte\
Standardaufschluß SEP kompatibel\
Bohrung 1\
Bohrung 2\
Bohrung 3\
Meine Abfrage\
Messpunkte\
Objekte\
Messpunkte

Am anderen Ende bei Verwendung entweder der **Objekte** ODER **Messpunkte** Knoten einer Datenbank (d. h. unterhalb aller Projekte dieser Datenbank), eine Abfrage wird auf alle Projekte dieser Datenbank angewendet.

Datenbanken\
DemoDB\
Projekt 1\
Objekte\
Alle Objekte\
Standardaufschluß SEP kompatibel\
Messpunkte\
Objekte\
Meine datenbankweite Abfrage\
Messpunkte

\
\
**Sichtbarkeiten**

Dies kann über die erweiterten allgemeinen Einstellungen und die Benutzerverwaltung gesteuert werden.

{% hint style="warning" %}
**Standard-Sichtbarkeit geändert:** Früher waren in früheren Versionen von GeoDin neu erstellte Abfragen per Standard privat (Sichtbar nur für den Benutzer, der sie erstellt hat). Dieses Verhalten wurde umgekehrt - Abfragen UND Karten, die Jetzt erstellt werden, sind **Sichtbar für Alle Benutzer** von der Gleiche Datenbank per Standard. Wenn eine Abfrage auf den erstellenden Benutzer beschränkt werden soll, Öffnen Sie die Abfrage **Erweitert** Registerkarte allgemeine Einstellungen und Einrichten Sie die Sichtbarkeit entsprechend. Derselbe Standard gilt auch für Karten.
{% endhint %}

## UND- vs. ODER-Bedingungslogik

Beim Erstellen von Bedingungen im Abfrage-Assistenten bestimmt die Position einer Bedingung, ob sie mit UND- oder ODER-Logik kombiniert wird:

* **ODER-Logik:** ziehen Sie ein Feld auf die Oben-Ebene **Bedingungen** Knoten. Jede Bedingung, die auf dieser Ebene abgelegt wird, erzeugt einen unabhängigen ODER-Zweig - die Abfrage gibt Objekte zurück, die mit einer der Bedingungen übereinstimmen.
* **UND-Logik:** ziehen Sie ein Feld auf einen **vorhandener Bedingungseintrag** (unter dem "Wenn"-Knoten verschachtelt). Dies fügt die Bedingung als zusätzliche UND-Anforderung innerhalb dieses Zweigs hinzu – die Abfrage gibt Objekte zurück, die alle verschachtelten Bedingungen gleichzeitig erfüllen.

**Beispiel:** Um Alle Objekte zu finden, die tiefer als 9 m UND auf dem Kartenblatt JD1234 liegen, ziehen Sie zuerst die Tiefenbedingung auf den Bedingungen-Knoten und dann die Kartenblattbedingung auf den Tiefen-Bedingungseintrag. Beide müssen erfüllt sein.

{% hint style="info" %}
Abfragen auf der **Messpunkte** Zweig eines Projekts geben Messpunkte statt Objekte zurück. Sie können Abfragen entweder unter dem **Objekte** oder dem **Messpunkte** Knoten im Baum des Objekt-Managers.
{% endhint %}

## Abfrage erstellen

Um eigene Abfragen (z. B. "Bohrungen tiefer als 9 m") zu definieren, steht ein Abfrage-Assistent zur Verfügung.

Der Abfrage-Assistent kann Abfragen bis zu einem gewissen Grad an Komplexität erstellen. Bei sehr komplexen Abfragen ist es möglich, [Alternativer SQL-Befehl](/geodin-desktop/de/datenanalyse/creating-queries/sql-and-advanced-options.md) im Abfrage-Assistenten einzugeben oder zu erstellen [Systemabfragen](/geodin-desktop/de/datenanalyse/creating-queries.md) (Am Systemteil von GeoDin).

Eine Abfrage besteht aus einer unbegrenzten Anzahl von Teilabfragen. Wenn ein Objekt eine Teilabfrage-Bedingung erfüllt, wird es in das Ergebnis der Abfrage aufgenommen.

**Beispiel:**

Sie möchten Alle Objekte aus einer Datenbank auswählen, die ein Kollege eingegeben hat. Der Autor für ein bestimmtes Objekt oder Messpunkte ist in der Tabelle A im Datenfeld A1 gespeichert, für andere Objekte (z. B. Wasserwerksbrunnen) in einer anderen Tabelle B im Datenfeld B1.

In diesem Fall erstellen Sie zwei Teilabfragen: Eine, die das Datenfeld A1 in Tabelle A abfragt, und die zweite, die das Datenfeld B1 in Tabelle B abfragt. Zusammen erzeugen sie eine Liste aller Objekte von Kollege X im GeoDin-Objekt-Manager.

Jede Teilabfrage hat ihre eigene Sortierung, deren Ergebnisse mithilfe der Option -Sortierung der Teil-/Teilergebnisse- individuell geändert werden können. In der Regel reicht jedoch eine einzige Teilabfrage aus, um die benötigten Objekte auszuwählen.

{% stepper %}
{% step %}

#### Schritt 1: Abfrage-Assistent starten

Der Abfrage-Assistent wird mithilfe des Verfahrens gestartet ![New Query](/files/b4891250c048b2f3408b76d94d2c6343024314d7) **"Neue Abfrage"**.

Dies ist Verfügbar, wenn entweder **Objekte** ODER **Messpunkte** im GeoDin-Objekt-Manager selektiert sind.
{% endstep %}

{% step %}

#### Schritt 2: Die Abfrage benennen und Teilabfragen organisieren

Im erster Schritt des Abfrage-Assistenten legen Sie den Namen der Abfrage fest, der im GeoDin-Objekt-Manager angezeigt wird. Sie können auch die Teilabfragen organisieren.
{% endstep %}

{% step %}

#### Schritt 3: Eine Teilabfrage erstellen und eine Vorlage wählen

Erstellen Sie eine Teilabfrage mithilfe des **Neu** Schalter, der Sie zur Auswahl / Selektion der zu verwendenden Vorlage führt, mit der die Teilabfrage erstellt wird. Hier definieren Sie, ob die Abfrage auf selektiert Objekte in der Datenbank beschränkt ist. Auswählen Sie eine der Abfragevorlagen und Sie erhalten detailliertere Erläuterungen im unteren Teil des Dialogfensters. Die angebotenen Vorlagen sind aufgeführt in **Referenz: Abfragevorlagen** unten.

Wenn Sie auf einen Abfragetyp klicken, wird im unteren Teil des Dialogfensters eine erklärende Hilfe angezeigt. Die relevanten Tabellen und Datenfelder für die Abfrage werden im Fenster angezeigt.
{% endstep %}

{% step %}

#### Schritt 4: Bedingungen und Anzeigefelder festlegen

Nach Auswahl der gewünschten Vorlage führt der **Folgende** Schalter bringt Sie zur Definition der Bedingungen und Anzeigefelder (siehe **Referenz: Bedingungen festlegen** und **Referenz: Anzeigefelder festlegen** unten).
{% endstep %}
{% endstepper %}

***

## Referenz: Abfragevorlagen

Wenn Sie eine Teilabfrage erstellen, öffnet der **Neu** Schalter die Auswahl / Selektion der zu verwendenden Vorlage. Folgende Vorlagen werden angeboten:

\
**Alle Objekte** - Abfrageerfassung von GeoDin-Objekten

***Hinweis:*** *Diese Option ist nur unter den Objektknoten Verfügbar, also nicht unter dem Messpunkte-Knoten im GeoDin-Objekt-Manager!*

Mit dieser Vorlage sind die Verfügbare Datenfelder für Bedingungen und Anzeigefelder stark eingeschränkt (Suche nur nach Name, Koordinaten, Anfangstiefe und Endtiefe von Objekten).\
\
**Spezifische Objektart** - Abfrage von Objekten bestimmter Objektarten

Ist auf eine bestimmte Menge von GeoDin-Tabellen (auf Grundlage ihrer vordefinierten Verknüpfungen) beschränkt und begrenzt dadurch die Ergebnisse, die von der Abfrage erzeugt werden.\
\
**Benutzerdefiniert Tabellenverknüpfungen** - Abfrage mit Verknüpfungen beliebiger Tabellen

Der vollständige Satz von GeoDin-Tabellen, der Kenntnisse der GeoDin-Datenbankstruktur und der Verknüpfungsmöglichkeiten erfordert.

Zugriff auf alle Tabellen mit Beschreibungen von Stammdaten, Probendaten, Ausbaudaten usw.

\
[Alternativer SQL-Befehl](/geodin-desktop/de/datenanalyse/creating-queries/sql-and-advanced-options.md) - SQL-Abfrage

Diese Auswahl erfordert SQL-Kenntnisse und Kenntnisse der GeoDin-Datenbank-Tabellenstruktur.

**Benutzerdefiniert Abfragedefinitionen** - Abfragen auf Basis von Benutzerdefiniert Vorlagen

\
Vorlagen können von Ihnen oder Ihrem GeoDin-Vorgesetzten auf der GeoDin-Systemseite erstellt werden.

## Referenz: Bedingungen festlegen

Abhängig vom gewählten Abfragetyp zeigt das Fenster eine Liste der relevanten Datenbanktabellen an. Um eine Tabellenfeldliste zu öffnen, klicken Sie auf das Pluszeichen (+) vor dem Tabellennamen.

Fast alle Ausführungsoperationen in diesem Dialog werden Ausgeführt durch Drag-and-drop durchgeführt. Das bedeutet: auf eine Tabelle Eingabe klicken, den Mausschalter gedrückt halten und auf das ![Condition](/files/948f6bc4fe20356f2cbdc5411e268f6c5a1c6204) ***Bedingung*** Zweig von der Hierarchie im unteren Fenster.\
\
Sobald die erster Datenfeld-Eingabe auf eine Bedingung abgelegt wird, erscheint die Unterstufe "IF". Wenn mehr als eine Anforderung zu erfüllen ist, dann die Drag-and-drop-Aktion erneut durchführen, indem auf den "IF"-Knoten abgelegt wird. Dies wird automatisch mit "UND" Erweitert (Hinweis: das abgelegte Feld muss nicht ein anderes sein, z. B. wenn die Werte für einen bestimmten Variablenname begrenzt werden).\
\
Wenn entweder eine oder eine andere Bedingung zu erfüllen ist, sollte eine Tabelle-Eingabe Von dem Feld Oben auf die Bedingung abgelegt werden, wodurch der Knoten "Or" automatisch erscheint.

Im folgenden Beispiel wurde die Abfrage für alle Objekte, die tiefer als 9 m gebohrt wurden und auf den Kartennummern JD1234 oder JD1235 liegen, festgelegt.

```
Bedingung

Wenn

SSGKRZT1.TK25=JD1234

SSGKRZT1.ZCOORDE>9

Oder

SSGKRZT1.TK25=JD1234

SSGKRZT1.ZCOORDE>9
```

***Hinweis:*** *Um die visuelle Abfrageanzeige zu vereinfachen, ist es nicht möglich, ODER-Bedingungen aus einer UND-Bedingung heraus zu definieren. Dadurch bleibt die Abfrage-Logik für den Benutzer klar (Löschen), und durch die Definition von unbegrenzten ODER-Bedingungen kann praktisch jede Abfrage (Beliebig) definiert werden.*

Wenn wir die in dem obigen Beispiel gezeigte Abfrage wie folgt zu zusammenfassen möchten:

(ZCOORDE>9) UND ((ORDNSURV='JD1234') ODER (ORDNSURV='JD1235'))

GeoDin ermöglicht es Ihnen auch, eine Abfrage als Text zu formulieren – weitere Details sind in [Alternativer SQL-Befehl](/geodin-desktop/de/datenanalyse/creating-queries/sql-and-advanced-options.md).

**Gültige Vergleichsoperatoren:**

| Operator       | Bedeutung                                                                                                                                                                            |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| =              |                                                                                                                                                                                      |
| >              |                                                                                                                                                                                      |
| >=             |                                                                                                                                                                                      |
| <              |                                                                                                                                                                                      |
| <=             |                                                                                                                                                                                      |
| <>             | (nicht gleich zu)                                                                                                                                                                    |
| ist null       | (Datenfeld ist leer)                                                                                                                                                                 |
| ist nicht null | (Datenfeld ist nicht leer)                                                                                                                                                           |
| wie 'A%'       | (Datenfeld-Inhalt(e) in Anführungszeichen, Platzhalter: % für unbegrenzte Zeichen und \_ genau ein Zeichen)                                                                          |
| in ('T1','T2') | (Wert-Liste in Runden Klammern, Werte durch Kommas getrennt, Werte in Anführungszeichen für Textfelder, für numerische Werte ein Dezimaltrennzeichen und nicht in Anführungszeichen) |

**Für Bedingungen, die eine Abfrage zu einem Datum durchführen, beachten Sie bitte die folgenden Daten-Formatierungen für Datenbanken**:

Die Norm-Werte sind:

| Datenbank        | Papierformat  |
| ---------------- | ------------- |
| Access-Datenbank | #mm/dd/yyyy#  |
| Oracle-Datenbank | 'dd-mmm-yyyy' |
| dBase-Datenbank  | 'dd.mm.yyyy'  |

**Für Bedingungen, die eine Uhrzeit-Abfrage für einen Zeitstempel durchführen, benutzen Sie bitte die folgenden Norm-Formatierungen**

| Datenbank                  | Papierformat                                               |
| -------------------------- | ---------------------------------------------------------- |
| Zugriff:                   | #MM/DD/YYYY HH:MM:SS#                                      |
| Orakel:                    | zu\_Datum('*31.05.2015 12:24:36'*,'dd.mm.yyyy hh24:mi:ss') |
| MySQL, MS SQL, PostgreSQL: | 'DD.MM.YYYY HH:MM:SS'                                      |

Zum Entfernen einer Bedingung klicken Sie auf den **Bedingung löschen** Symbol.

Mit demselben Schalter können Sie auch die Anzeige oder ganze Zweige der Bedingung löschen.\
\
**Anzeige und Inhalt des Datenfelds in der Bedingung**\
\
Oft wissen Sie möglicherweise nicht, welche Werte Sie von den Objekten erwarten können, um die Bedingung zu erfüllen, die Sie definieren möchten. Durch Klicken **Werte anzeigen** können Sie diese manuell anzeigen. Durch Ankreuzen des Kästchens **Automatisch** Sie werden für das jeweils ausgewählte Feld angezeigt. Diese Option „Automatisch“ sollte bei der Arbeit mit großen Datenbanken deaktiviert bleiben, um mögliche Verzögerungen beim Navigieren zwischen den Datenfeldern zu vermeiden.

Sie können eine Eingabe aus der Werteliste in das **Einschränkung** Feld ziehen. Dies ist eine große Hilfe, wenn diese viele Zeichen enthalten. GeoDin erkennt automatisch das Papierformat des Datenbankfelds und setzt Zeichenfolgen in hochgestellte Kommas ("Textzeichenfolge") in der Bedingung.

**Testen einer Abfrage**

Durch Klicken auf den Schalter **Abfrage testen** Die Bedingungen werden auf Syntaxfehler geprüft, und die Zahl der Objekte, die die Abfragebedingungen erfüllen, wird angezeigt. Bis zu 50 Werte werden in der Liste angezeigt.

## Referenz: Anzeigefelder festlegen

Das Ergebnis einer Abfrage ist immer mindestens das GeoDin-Datenbankfeld LOCID – eine eindeutige GeoDin-Objektidentifikationszahl. Wenn keine Anzeigefelder definiert sind, werden die Ergebnisse der Abfrage mithilfe der LOCID im GeoDin-Objektmanager angezeigt. Natürlich ist diese LOCID möglicherweise nicht besonders hilfreich.

![Display Fields](/files/392d59db756254ec3f21e190c9e7364d25bbf383) **Anzeigefelder**

Mit den Anzeigefeldern definieren Sie die Beschriftungen der Objekte im GeoDin-Objektmanager. Sie können so viele Anzeigefelder wie Sie möchten kombinieren (z. B. Name des Bohrlochs und Endtiefe). Ziehen Sie dazu die gewünschten Datenfelder auf die Anzeigefelder-Eingabe im unteren Teil des Fensters. Der Inhalt(e) aller Anzeigefelder wird mit einem Text verknüpft und im GeoDin-Objektmanager angezeigt.

**Erweiterung/Zusatztext**

Um einzelne Anzeigelinhalte (Datenfelder) voneinander zu trennen, kann für jedes Anzeigefeld ein Text definiert werden, der an den jeweiligen Datenfeldinhalt angehängt wird.

**Beispiel:**

Anzeigefelder

SSGKRZT1.Lange Bezeichnung (bis

SSGKRZT1.ZCOORDE m)

Um den Summe-Text in der Form zu bilden **Lange Bezeichnung (zu Xm)** für jedes gefundene Bohrloch, der Zusatztext **(*****bis*** oder \[Englisch] ***zu*** und für das Anzeigefeld ZCOORDE der Erweiterungstext ***m*****)** ist für das Anzeigefeld LONGNAME definiert. Infolgedessen wird jedes Bohrloch im GeoDin-Objektmanager mit Name und Endtiefe beschriftet:

Standort tiefer als 9m

Brg 01 (Bis zur Tiefe 11m)

Brg 02 (Bis zur Tiefe 10,5m)

Brg 03 (Bis zur Tiefe 12m)

Brg 04 (Bis zur Tiefe 9,5m)

Sie können die Reihenfolge von den Anzeigefeldern Ändern, indem Sie eine Eingabe zu einer anderen Position innerhalb der **Anzeigefelder** Sektion.

Mit den Anzeigefeldern definieren Sie auch die Sortierreihenfolge von den gefundenen Objekten im GeoDin-Objektmanager.

Vor jedem Anzeigefeld zeigt ein Pfeil die festgelegte Sortierreihenfolge an. Sie können die Sortierreihenfolge durch Doppelklicken auf die Eingabe Ändern. Die Sortierreihenfolge kann die folgenden Zustände haben: Aufsteigend, Absteigend, Unsortiert. Die aktuell Sortierreihenfolge wird vor dem Anzeigefeld angezeigt. Die gefundenen Objekte werden Immer in der Reihenfolge von Anzeigefeld sortiert, d. h. im obigen Beispiel als erster nach Name und dann nach endgültiger Tiefe, wenn der Name gleich ist.

Um die Objekte nach endgültiger Tiefe zu sortieren, ohne die Reihenfolge der Anzeigefelder zu ändern, doppelklicken Sie auf das LONGNAME-Anzeigefeld, bis das Sortieren für dieses Feld deaktiviert ist. Die Ergebnismenge wird nun nur nach endgültiger Tiefe sortiert, und die Definition von der Reihenfolge der Anzeigefelder bleibt erhalten. Jetzt wird als Ergebnis die folgende Liste im GeoDin- Objekt-Manager angezeigt:

Standort tiefer als 9m

Brg 04 (Bis zur Tiefe 9,5m)

Brg 02 (Bis zur Tiefe 10,5m)

Brg 01 (Bis zur Tiefe 11m)

Brg 03 (Bis zur Tiefe 12m)

**Formatierung und erneute Übersetzung von Beschriftungen im Objekt-Manager**

Wenn die Sektion „Anzeigefelder“ markiert ist, können Sie die Anzeigefelder über das untere Eingabefeld weiter anpassen **Beschriftungen-Anweisung - Abfrage:**. Neben zahlreichen [Beschriftungsanweisung](/geodin-desktop/de/visualisierung-layouts-and-berichterstattung/report-templates/text-macros-in-reports.md) Durch die Eingabe eines Makros können Sie festlegen, dass im Objektmanager die Lange Bezeichnung von der Eingabe des Feldes (d. h. die Zurückübersetzung) angezeigt wird.

Die eingegebenen Makros müssen in der Sektion „Anzeigefelder“ als Verfügbar geführt werden. Sie können die Anzeigefelder nicht ersetzen, sondern dienen zu ihrer Ergänzung.

***TIPP:*** *Wechseln Sie zur SQL-Voransicht. Kopieren Sie von dort die gewünschten Eingaben.*

**Beispiel:**\
Wenn Sie GeoDin\_LOC\_S3STAMM.LONGNAME und GeoDin\_LOC\_S3STAMM.BART als Anzeigefelder definiert haben und die Lange Bezeichnung des Bohrtyps (BART), d. h. die Zurückübersetzung von dem Schlüssel, im GeoDin-Objektmanager zu sehen sein soll, muss folgende Eingabe in das Eingabefeld geschrieben werden **Beschriftungen-Anweisung - Abfrage:**

$GeoDin\_LOC\_S3STAMM.LONGNAME$ ($GeoDin\_LOC\_S3STAMM.BART$)

Der Objektmanager zeigt jetzt Folgendes:

Bohrungen (Aufschlussart)\
SEP3 Bohrung 1 (Allgemein)\
SEP3 Bohrung 2 (Aufschluss, verfüllt)\
SEP3 Bohrung 3 (Schrägbohrung)\
SEP3 Bohrung 4 (Allgemein)

Wenn eine Anweisung für Beschriftungen verwendet wird, muss im Eingabefeld ein zusätzliches Makro definiert werden **Anweisung für Beschriftungen - Aktualisieren:**. In der Regel besteht das Makro aus den Feldverweisen darüber im Eingabefeld, abzüglich der Tabellennamen.

Das Makro wird beim Aktualisieren der Anzeige im Objekt-Manager aufgrund der im Stammdaten-Editor vorgenommenen Änderungen verwendet.

(Hintergrund: Bei der Aktualisierung wird das geladene Objekt verwendet, um das Makro aufzulösen. Die ursprüngliche Abfrage oder der Datensatz, der zur Eingabe im Objekt-Manager geführt hat, wird nicht zwischengespeichert, da dies nicht notwendig ist und nur Speicher belegen würde. Das Makro für die Aktualisierung muss daher mit den Feldverweisen erstellt werden, so wie sie auch in Layouts für das geladene Objekt verwendet werden.)

Für das obige Beispiel werden daher die folgenden Feldverweise eingetragen:

$LONGNAME$ ($BART$)

**Auswählen von Sortierungsfeldern**

Neben den Anzeigefeldern (die wie oben beschrieben auch zum Sortieren der Ergebnisse verwendet werden können) können auch die Datenfelder, die in den angezeigten Ergebnissen im GeoDin-Objekt-Manager nicht verwendet werden, zum Sortieren verwendet werden. Ziehen Sie dazu die ausgewählten Sortierungsfelder aus der oberen Liste auf die Eingabe **Sortierungsfelder** per Drag-and-drop. Um die Sortierreihenfolge zu ändern, doppelklicken Sie auf die jeweilige Eingabe. Der Pfeil zeigt die aktuell Sortierreihenfolge.

**Ergebnisfelder auswählen**

Zusätzlich zu der Ansicht und den Sortierungsfeldern können die Ergebnisfelder ausgewählt werden, die als nicht für die Anzeige oder Sortierung verwendete Datenfelder gelten. Wenn jedoch die Ergebnisse der Abfrage exportiert werden sollen, z. B. für GIS, benutzen Sie die Ergebnisfelder, um festzulegen, welche Datenfelder von GeoDin zu der Attributtabelle der erzeugten Schicht übertragen werden sollen. Ziehen Sie die gewünschten Felder wie gewohnt auf den Knoten Ergebnisfelder (Exportieren). Wenn Sie alle Felder einer GeoDin-Tabelle übertragen möchten, ziehen Sie einfach die gewünschte Tabelle auf den Knoten Ergebnisfelder (Exportieren).

## Referenz: Alternativer SQL-Befehl

Neben der visuellen Erstellung von Abfragen können Sie mithilfe des SQL-Voransicht-Fensters Ihre eigenen SQL-Befehle definieren.

Die Option <[Alternativer SQL-Befehl](/geodin-desktop/de/datenanalyse/creating-queries/sql-and-advanced-options.md)> ermöglicht es Ihnen, einen SQL-SELECT-Befehl für Ihre Abfrage zu definieren:

1. Der Befehl muss eine Menge zurückgeben (Datenbank-Cursor). Ein SQL-Befehl ohne Auswählen-Anweisung am Anfang eines Befehls wird nicht ausgeführt.
2. Die erster Zeile von dem zurückgegebenen Ergebnis muss eine gültige GeoDin-Standort-Kennung (LOCID) ODER eine GeoDin-Messpunkt-Kennung (INVID) (abhängig auf dem gewünschten Ergebnissatz) enthalten. Die Abfragen werden nicht auf ihre Gültigkeit geprüft, aber eine formale Prüfung, dass die erster Zeile vom Ergebnis Zahlen enthält, die zu ganzen Zahlen konvertiert werden können. Wenn das Ergebnis keine gültige Kennung zurückgibt, kann das Objekt später nicht selektiert werden.

Weil für den SQL-Befehl keine weiteren Bedingungen festgelegt sind, ist es möglich, andere Tabellen der Datenbank in die Abfrage zu integrieren, die nicht Teil der GeoDin-Systemstruktur sind. Natürlich ergibt eine solche Abfrage nur dann Sinn, wenn solche anderen Tabellen mit einer GeoDin-Tabelle verbunden sind, sodass das zurückgegebene Ergebnis gültige Kennungen liefert.

Der Alternativer SQL-Befehl zeigt alle Parameter, die in der Abfrage visuell definiert sind (Reihenfolge, Erweiterungstext usw.), solange die Datenfeldnamen übereinstimmen.

## Referenz: Parametrisierte Abfragen

Im obigen Beispiel wurde in der Abfrage eine Bedingung festgelegt, dass die Endtiefe größer als 9 m sein muss. Bei einer anderen Gelegenheit möchten Sie vielleicht alle Bohrungen auswählen, die tiefer als 20 m sind. Dazu könnten Sie den Wert von (>9m) zu (>20m) in der bestehenden Abfrage ändern oder eine neue Abfrage definieren, die sich von der erster nur im Tiefe-Wert unterscheidet.

GeoDin bietet ein weiteres, effizienteres Verfahren, um Abfragen zu definieren, die ähnliche Bedingungen haben, während der Hauptparameter frei bleibt, unterschiedliche Werte anzunehmen. Dieselbe Abfrage kann dann verwendete werden, um verschiedene Auswahlen von GeoDin Objekte zu treffen.

Benutzen Sie dazu die Art ":?" im Begrenzungsfeld anstelle von einer Zahl (Tiefe) - siehe unten:

```
Bedingung

Wenn

SSGKRZT1.ZCOORDE>:?

Anzeigefelder

SSGKRZT1.LONGNAME (zu

SSGKRZT1.ZCOORDE m)
```

Die verwendete Abfrage-Bedingung ist >:?

Um eine Parametrisierte Abfragen zu charakterisieren, kann ein geeigneter Name gewählt werden, z. B. „Bohrungen tiefer als ?m“, um zu markieren, dass die Abfrage im GeoDin Objekt Manager ein Variablenname ist. Sobald die Abfrage bei der erster Öffnung geöffnet wird, wird ein Eingabedialog angezeigt, der die Eingabe von Parametern anfordert.

Geben Sie den gewünschten Tiefe-Wert ein und bestätigen Sie durch Klicken **OK**Als Ergebnis: Alle Bohrungen, die tiefer als der angegebene Wert sind, werden im GeoDin Objekt Manager angezeigt. Die angezeigten Bohrungen können dann als für weitere Analyse verwendete Bohrungen dienen.

Wenn Sie in einer Abfrage eine Bedingung mit einem Variablenname-Parameter definieren, können Sie Auswählen, ob der Parameter eine notwendige Eingabe (Parameterangabe erforderlich) ist. Wenn diese Option Gesperrt ist, kann das Eingabefeld Links leer gelassen werden im Eingabedialog. Diese Bedingung ist Links leer, wenn die Datenbank-Abfrage ausgeführt wird, und die verwendete Eigenschaft wird nicht verwendet, um die Datensätze in der resultierenden Auswahl / Selektion zu begrenzen.

Außerdem kann ein Norm-Wert definiert werden, der im Dialog automatisch eingetragen wird. Wenn die Abfrage Gestartet wird, ist der Wert bereits im Eingabefeld eingetragen und kann bei Bedarf geändert werden. Das macht das Ausfüllen der Parameter noch einfacher. Am Feldformat, auf das sich die Bedingungen beziehen, müssen Norm-Werte für Bedingungen im folgenden Papierformat zu finden sein:

Zeichenkette von Zeichen: Norm-Wert kann eine beliebige Zeichenkette von Zeichen sein

Numerischer Wert: Der Normwert hat eine Zahl zu sein, der Dezimaltrennpunkt ist ein Punkt (.).

Datum: Der Norm-Wert muss ein vollständiges Datum im Format dd.mm.yyy (Tag-Monat-Jahr) sein

**Intervall verwenden**

Wenn eine Abfrage parametrisiert ist, ist es möglich, einen Darstellungsbereich anstelle einer oberen und unteren Grenze zu benutzen. Ein Beispiel dafür ist die Suche nach Objekten in einer Fläche um einen bestimmten Punkt. Dies ist mit einer parametrisierten Abfrage und den Parametern möglich:

(X >= X\_value1) und (X <= X\_value2) und (Y >= Y\_value1) und (Y <= Y\_value2)

Wenn Koordinaten-Werte mehrere Ziffern haben, ist das Eingeben der 4 notwendigen Parameter langwierig. Für diese Fälle bietet die Option -Intervall verwenden- eine einfachere Möglichkeit. Benutzen Sie es, um nur zwei Bedingungen zu definieren:

X = :?

und

Y = :?

und schalten Sie die Option -Intervall verwenden- auf Ein. Ein Standardwert für den Darstellungsbereich kann ebenfalls angegeben werden.

Von der Bedingung ( X =X\_value) und ( Y= Y\_value) wird GeoDin automatisch die folgende SQL-Anweisung generieren:

((X >= X\_value - Xinterval) UND (X <= X\_value + Xinterval)) UND ((Y >= Y\_value - Yinterval) UND (Y <= Y\_value + Yinterval))

Als Parameter müssen nur die Koordinaten von dem Mittelpunkt und der Darstellungsbereich eingegeben werden.

Die Verwendung von Intervallen ist nur für parametrisierte Abfragen möglich, kann aber für beliebige numerische Datenfelder verwendet werden (zum Beispiel Endtiefe).

**Verwenden des $%SYSDATE$-Parameters**

Benutzen Sie den $%SYSDATE$-Platzhalter als Standardwert eines Datumsparameters, um das Datum aktuell als Standardwert zu setzen. Außerdem sind mathematische Ausdrücke mit dem $%SYSDATE$-Makro möglich, z. B. $%SYSDATE$ - 7, um ein Standarddatum für den Tag vor einer Woche zu erhalten.

**Parameter ändern**

Zum Ändern eines definierten Werts benutzen Sie das Verfahren ![Change parameter](/files/07e7b07ca4ebe34f1217daed2abc01a007beafbd) **Parameter ändern** Bei dem Objekt der Abfrage:

In einer Abfrage kann eine beliebige Zahl von Parametern definiert werden.

**Beispiel:**

```
Bedingung

Wenn

LOCREG.XCOORD>=:?

LOCREG.XCOORD<=:?

LOCREG.YCOORD>=:?

LOCREG.YCOORD<=:?

Anzeigefelder

SSGKRZT1.LONGNAME
```

Im obigen Beispiel werden vier Parameter definiert, um ein Rechteck aus Koordinaten aufzubauen. Der erste der X- und Y-Werte definiert die Startkoordinaten – der zweite Wert in jedem Paar definiert die Ausdehnung der zu suchenden Fläche. Der Abfragedialog für diese Abfrage wird unten angezeigt:

## Abfrage aktualisieren

In einer Mehrbenutzerumgebung kann es oft notwendig sein, eine Abfrage zu aktualisieren, um Änderungen in den Daten selbst widerzuspiegeln. GeoDin prüft automatisch auf Änderungen an Objekten, die für die Anzeige verwendet werden (z. B. ein Objektname, der im GeoDin-Objektmanager angezeigt wird). Wenn jedoch ein Parameter für die Bedingung geändert wird (z. B. „Endtiefe“), wird die Abfrage nicht automatisch aktualisiert, da dies bei großen Datensätzen den Workflow beeinträchtigen würde. Ebenso wird die Endtiefe nicht automatisch in der Abfrage aktualisiert, wenn ein anderer Benutzer die Endtiefe ändert.

Es gibt eine einfache Möglichkeit, Ihre Abfrageergebnisse schnell zu aktualisieren, um Datenänderungen (z. B. Endtiefe-Werte) zu übernehmen. Klicken Sie mit der rechten Maustaste auf die Abfrage im GeoDin-Objektmanager und wählen Sie **Aktualisieren** aus dem Popup-Menü. Die Objektliste wird neu aufgebaut.

## Abfrage duplizieren

Mit dem Verfahren **"Abfrage duplizieren"** Sie können eine Abfrage, die in einem Projekt erstellt wurde, Kopieren. Benutzen Sie sie in einem anderen. Um eine Abfrage zu alle Projekte zu Kopieren, Auswählen Sie die **Alle** Schalter. Die Abfrage wird in der Datenbank in alle als selektiert markierten Projekte kopiert. Wenn die von Ihnen verwendete Projektkennung (PRJ\_Kennung Datenfeld) in Ihrer Abfrage in der Bedingung, der Anzeige oder dem alternativen SQL-Befehl verwendet wird, wird sie beim Kopieren der Abfrage automatisch an die andere Projektkennung angepasst, sodass die duplizierte Abfrage im Zielprojekt nicht korrigiert werden muss.

## Abfrage löschen

Dieses Verfahren löscht die Abfragedefinition. Sie **nicht** Löschen Sie die in den Abfrageergebnissen enthaltenen Objekte, nur die Bedingung, die diese Ergebnisse erzeugt.

***

## Arbeiten mit Objektgruppen

### Objektgruppen

In einigen Situationen können die Objekte von einer Datenbank nicht ordnungsgemäß abgefragt werden. Dies kann fällig zu unvollständigen oder fehlenden Datenbankeinträgen sein, oder andere Kriterien, die nicht in der Datenbank gespeichert sind, sind wichtig.

Für solche Fälle bietet GeoDin die Möglichkeit zu Erstellen **Gruppen** von Objekten, die nicht zu irgendwelchen spezifischen Bedingungen passen.

Das Verfahren **"Neue Gruppe"** ist Bei den Objekte- und Messpunkte-Knoten Verfügbar.

Geben Sie einen Namen für die im GeoDin-Objektmanager zur Identifizierung verwendete Gruppe ein.

Nach dem Erstellen einer Gruppe ist die Liste an erster Stelle Leer. Um die Liste zu Signatur, Auswählen Sie ein Objekt im GeoDin-Objektmanager, beibehalten Sie den Links-Mausschalter gedrückt, ziehen und legen Sie es auf das Öffnen-Dialogfenster. Sie Mai können Einzelobjekte oder Gruppen im GeoDin-Objektmanager Auswählen. Sie Mai können Löschen und Ändern die Reihenfolge von Objekte in einer Gruppe mithilfe der entsprechenden Schalter im <**Gruppe**> Dialogfenster.

Objekte werden mit der Bezeichnung, die sie zum Zeitpunkt des Einfügens haben, in die Liste eingefügt. Dieser Text kann später nicht geändert werden und wird auch dann nicht aktualisiert, wenn sich die Datenlage ändert. Im Gegensatz dazu werden bei Abfragen die Beschriftungstexte aktualisiert und Objekte, die die Bedingung nicht mehr erfüllen, aus der Liste entfernt, wenn die Abfrage aktualisiert wird. Daher kann es in einer Gruppe Objekte geben, deren Beschriftungen nach einer Änderung der Objektdaten nicht mehr korrekt sind. Dieses Beispiel zeigt, dass Gruppen gegenüber Abfragen eine Reihe von Nachteilen haben und daher nur verwendet werden sollten, wenn eine Abfrage aus den eingangs genannten Gründen wirklich nicht möglich ist oder wenn Sie erwarten, dass sich die Daten dieser Objekte nicht mehr ändern werden.

Abfragen und Gruppen werden im GeoDin-Objektmanager mit Pyramiden in unterschiedlichen Farben dargestellt – Gelb für Abfragen und Blau für Gruppen.

Die Sichtbarkeit kann für Benutzer und Gruppen in den allgemeinen Einstellungen der Benutzerverwaltung gesteuert werden.

### Objektgruppe löschen

Diese Methode löscht die Gruppendefinition, **nicht** die in der Gruppe enthaltenen Objekte.

### Gruppe importieren

Benutzen Sie den **„Gruppe importieren“** Verfahren, um GeoDin-Objekte in einer GeoDin-Datenbank anhand externer Daten („Importdatei“) zu suchen und die gefundenen Objekte zusammen zu gruppieren.

Je nach Knoten, an dem das Verfahren gestartet wird, werden GeoDin-Objekte in der gesamten Datenbank (Knoten „Objekte“ eine Ebene unterhalb der Datenbank) oder nur in einem Projekt (Knoten „Objekte“ eine Ebene unterhalb des Projekts) gesucht.

Folgende Schritte sind erforderlich:

**Datenquelle**

Hier öffnen Sie die Datei (z. B. Excel-Datei, Datenbank), die die Informationen zu den GeoDin-Objekten enthält, nach denen in der Datenbank gesucht werden soll (und die später gruppiert werden).

**Objektzuordnung**

Hier ordnen Sie die GeoDin-Objekte der Datenbank den Vorgaben in der Datenquelle zu. Dieser Schritt startet die Auswahl der zu gruppierenden Objekte.

[Importieren](/geodin-desktop/de/daten-importieren/import.md)

Nehmen Sie hier die Einstellungen für die Vergleichssteuerung vor. Die Voransicht zeigt, welche GeoDin-Objekte mit den Informationen in der Importdatei in der Datenbank gefunden werden und welche GeoDin-Objekte in der Importdatei nicht erwähnt werden. Starten Sie hier die Gruppenerstellung.

**Konfiguration speichern und laden**

Alle Einstellungen für den Gruppenimport können in einer Konfigurationsdatei gespeichert werden. Die Konfigurationsdatei ermöglicht es, eine Gruppenerstellung zu einem späteren Zeitpunkt schnell erneut auszuführen, wenn die Datenbasis ähnlich oder gleich ist.

### Datenquelle

Öffnen Sie die Datei, die die Informationen zu den GeoDin-Objekten enthält, nach denen in der Datenbank gesucht werden soll (und die später gruppiert werden). Folgende Dateiformate werden unterstützt:

1. MS Excel
2. MS Access
3. dBASE
4. Textdateien
5. CSV-Dateien

Nachdem Sie die Datei ausgewählt haben, geben Sie die Datenquelle an und wählen Sie ein Arbeitsblatt (Excel), eine Tabelle (Access, dBase) oder ein Spaltentrennzeichen (CSV, Textdatei).

Die Suchdaten werden in der Voransicht angezeigt. Für MS Excel- oder Textdateien können Sie außerdem angeben, ob die erste Zeile Spaltenüberschriften enthält. Das in diesen Dateien verwendete Datumsformat kann ebenfalls angegeben werden. GeoDin berücksichtigt diese Einstellung später bei der Konvertierung von Datumsangaben.

Verwenden Sie diesen Schalter, um selektierte Datensätze aus der Voransicht zu entfernen, wenn Sie nicht möchten, dass sie in die Suche einbezogen werden (die Datensätze werden nur in dieser Voransicht entfernt, die Quelldatei bleibt unverändert).

### Objektzuordnung

In diesem Schritt ordnen Sie die Datensätze in Ihrer Importdatei den GeoDin-Objekten in Ihrer Datenbank zu. Die Zuordnung basiert auf übereinstimmenden Inhalten zwischen den selektierten Stammdaten der GeoDin-Objekte und den Datensätzen in der Importdatei.

**Beispiel**

Die Importdatei enthält eine Spalte mit einer Auswahl von Bohrlochnamen. Diese Bohrungen sollen in GeoDin gruppiert werden. Für die Zuordnung müssen Sie die Spalte aus der Importdatei dem LONGNAME-Feld der GeoDin-Stammdatentabelle zuweisen. Die Suche nach den zu gruppierenden GeoDin-Objekten erfolgt nun durch den Vergleich der Bohrlochnamen. Wenn Sie für die Objektzuordnung mehrere Inhalte angeben (z. B. den Bohrlochnamen, den Bohrlochstandort usw.), werden nur die GeoDin-Objekte in der Datenbank für die Gruppierung ausgewählt, bei denen alle Felder übereinstimmen.

**Tabellen**:

Wählen Sie die Stammdatentabelle aus der Datenbank, die als Grundlage für einen Stammdatenvergleich zwischen Importdatei und GeoDin-Objekten dienen soll.

Um die zu referenzierenden Felder zuzuordnen, ziehen Sie die einzelnen Einträge aus den Listen „Tabellen:“ und „Datenquelle:“ per Drag & Drop auf das entsprechende Feld in der anderen Liste. Alternativ können Sie die beiden Felder auswählen und eines davon doppelklicken, um die Zuordnung vorzunehmen. Bei Spaltennamen in der Importdatei, die mit den Spaltennamen in der Stammdatentabelle der Datenbank identisch sind, können Sie diese übereinstimmenden Einträge mit dem Schalter \<Automatische Zuordnung> automatisch zuordnen.

Die vorgenommenen Zuordnungen werden in die Tabelle „Zuordnungen:“ übertragen. Gleichzeitig werden die zugeordneten Einträge aus den Listen „Tabellen:“ und „Datenquelle:“ entfernt, sodass nur noch die Einträge verbleiben, die noch nicht zugeordnet wurden.

Mit den beiden Eingabefeldern unterhalb der Listen können die Inhalte der Listen gefiltert werden. Wenn ein Begriff eingegeben wird, werden in den Listen nur die Einträge angezeigt, die diesen Begriff enthalten. Wenn Sie das Eingabefeld leeren, werden alle Einträge wieder angezeigt.

Ungültige Zuordnungen werden in der Tabelle farbig markiert. Diese treten auf, wenn Sie die Datenquelle ändern, nachdem Sie die Zuordnung vorgenommen haben. Entfernen Sie diese Einträge mit dem Schalter\n.

### Importieren

Nehmen Sie die letzten Einstellungen für die Gruppenerstellung vor und sehen Sie sich eine Voransicht des Status der Zuordnungen an. Starten Sie dann die Erstellung einer neuen Gruppe.

**Vergleichsoptionen**\
Wenn Sie das Kästchen *\[Groß-/Kleinschreibung beachten]*, werden Spaltennamen der Importdatei und der Stammdatentabelle nur zugeordnet, wenn die Schreibweise auch hinsichtlich der Groß-/Kleinschreibung übereinstimmt.

**Voransicht**\
Das Voransichtsfenster bietet einen Überblick über die vorgenommenen Zuordnungen. Es gibt drei Arten von Ergebnissen:

*Ein GeoDin-Objekt wurde gefunden*

Für den zu suchenden Eintrag konnte in der Datenbank genau ein GeoDin-Objekt gefunden werden.

*Es wurden mehrere GeoDin-Objekte gefunden*

In der Datenbank wurden für den zu suchenden Eintrag mehrere GeoDin-Objekte gefunden. Das bedeutet, dass die Inhalte Ihrer Importdatei nicht eindeutig sind. Möglicherweise müssen Sie weitere Datenfelder in den Vergleich einschließen, um die richtigen GeoDin-Objekte zu finden.

*Nein GeoDin Objekt wurde gefunden*

Es gibt kein GeoDin-Objekt in der Datenbank mit Informationen, die dem Suchbegriff entsprechen. Überprüfen Sie die Zuordnung der Datenfelder und den Inhalt(e) der Importdatei.

**Filter für die Voransicht**\
Sie können die in der Voransicht angezeigten Zuweisungen filtern und Sortieren. Um dies zu tun, klicken Sie auf die Kopfzeile der Pflichtfeld-Spalte.\
"**Benutzen Sie den Filter für die Voransicht:"** Dropdown-Feld, um nur einen von den drei Typen von Ergebnissen (siehe oben) im Voransicht-Fenster zu zeigen.

**Importieren ausführen**\
Mit einem Mausklick auf den Schalter \*\*Ausführen Importieren\*\* werden alle erfolgreich zugewiesenen GeoDin Objekte in einer neuen Gruppe im GeoDin Objekt Manager zusammengefasst. Unter der Überschrift "Ausführung" können Sie im Bearbeitungsfenster einen Namen für die neue Gruppe festlegen. Als Standard ist hier der Name der Importdatei vorab eingetragen.\
Nach der Ausführung wird ein Protokoll angezeigt, das Sie mit dem entsprechenden Schalter Speichern können. Wenn Sie weitere Gruppen erstellen möchten, wechseln Sie zurück zu **Datenquelle**.

## Benutzerverwaltung

Die Sichtbarkeit/Benutzbarkeit verschiedener Methoden und Funktionen kann über die Benutzerverwaltung eingeschränkt werden.

Standardmäßig ist die Option *"Alle"* eingeschaltet - d. h. keine Einschränkung.

Über die Option Benutzergruppen kann die Funktionalität ausdrücklich für bestimmte *Gruppen oder einzelne Benutzer*.

Dies wird zum Beispiel für Methoden, Systemdatenbanken oder Abfragen verwendet.

Die Erstellung von Benutzern und Gruppen wird im Kapitel zu **Nutzerspezifische Einstellungen**.

## Referenz: Feldzuordnung

Strukturinformationen können an Benutzerdefiniert SQL angehängt werden. Zahlfelder können dann mit Dezimalstellenformatierung oder Einheit-Konvertierungen versehen werden, und Textfelder Wörterbuch-Übersetzungen erhalten.

Für die Feldzuordnung wird ein Ergebnisfeld zu einem Feld Von der GeoDin-Struktur zugewiesen.

**Beispiel:**

Auswählen $Schema$GeoDin\_LOC\_LOCE2LAYER.\* Von $Schema$GeoDin\_LOC\_LOCE2LAYER

Zuordnung:

Datenbank - Tabellenstruktur

GeoDin\_LOC\_LOC\_E2LAYER.SECSTYPE E2LAYER.SECSTYPE


---

# 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/de/datenanalyse/creating-queries.md?ask=<question>&goal=<endgoal>
```

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