> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/auswertungen/freie-vql.md).

# Freie VQL

Im **Menüpunkt "Freie VQL"** unter **"Auswertungen"** kannst Du freie VQL-Selektionen erstellen. Dabei kannst Du auf alle Datensätze in VARIO zugreifen, um Selektionen anhand von VQL zu konfigurieren.

Auf unserer **Developer-Seite** steht Dir eine ausführliche Dokumentation zu [**VQL**](https://developer.vario-software.de/documentation/fundamentals/vql) zur Verfügung. Dort sind die verschiedenen **VQL-Formulierungen** und ihre **Verwendung** aufgelistet und genau erklärt.

{% hint style="warning" %}

## **VQL-Kenntnisse erforderlich**

Für die Erstellung von Selektionen im VQL-Modus sind gute Kenntnisse in der Datenbanksprache VQL erforderlich.
{% endhint %}

In unserem **Deep Dive** zu VQL zeigen wir Dir wie Du VQLs nicht nur im **Menüpunkt "Freie VQL"** sondern in **jedem Bereich** erstellen kannst:

{% embed url="<https://www.youtube.com/watch?index=2&list=PL0EUYY7rOquvH67AHkOjoAGmcsgMt8ihx&v=TTXrpPZdisk>" %}

## VQL-Selektion erstellen

Beim ersten Öffnen des **Menüpunkts "Freie VQL"** wird keine vordefinierte Selektion angezeigt. Um eine **neue Selektion** zu erstellen, gehe wie folgt vor:

{% stepper %}
{% step %}
Klicke **links** im **Spaltenkopf** auf das **Zahnrad-Icon**.

<figure><img src="/files/NNewM93rAROjwz5dOOBL" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Trage im **Feld "Bezeichnung"** eine Bezeichnung für die Selektion ein.

<figure><img src="/files/9EO1tyqAIYShG7lD9BHq" alt="" width="563"><figcaption></figcaption></figure>

Der **Modus "VQL"** ist bereits vorausgewählt und kann nicht geändert werden. Im **Feld "Anzahl der Datensätze"** kannst Du die **maximale Anzahl** an **Datensätze** eintragen, die selektiert werden sollen.

Nach dem Speichern kannst Du die Selektion über den **Toggle "Standard"** als **Standardselektion** festlegen. Sie wird dann beim **Öffnen des Menüpunkts** automatisch ausgewählt.

Genauere Informationen zu den Konfigurationsmöglichkeiten findest Du auf der [**Seite "Selektionen konfigurieren"**](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md).
{% endstep %}

{% step %}
Im **Reiter "VQL Query"** kannst Du die Selektion frei anhand von VQL konfigurieren.

<figure><img src="/files/s1TpSCKVJBm2WE8mIsuG" alt="" width="563"><figcaption></figcaption></figure>

Die **einzelnen Icons** oberhalb des **Editors** helfen Dir dabei, die Selektion effizienter zu konfigurieren. Beispielsweise wird Dir eine Auflistung **möglicher Code-Ausschnitte** und **C-Units** angeboten.
{% endstep %}

{% step %}
Im **unteren Bereich** kannst Du die in den VQL-Abfragen hinterlegten **Variablen** zu einem **Datentyp,** z. B. Datum oder Zahl, zuordnen. Dadurch wird für die Eingabe in der C-Unit das entsprechende Feld eingeblendet.

Über das **Pluszeichen** kannst Du die Variable **manuell** eintragen während mit dem **Zauberstab** die Variablen aus dem VQL-Skript **ausgelesen** werden können.&#x20;

<figure><img src="/files/oCKzUFYWSpk8RYtplrbP" alt=""><figcaption></figcaption></figure>

Als **Name** kannst Du die **Bezeichnung des Feldes** eintragen und als **Typ** den entsprechenden **Datentyp**. Pro Variable kannst Du im **Feld "Suchdialog"** ein **Bereich** auswählen, dass als Suchdialog bei der Eingabe eines Wertes eingeblendet wird.
{% endstep %}

{% step %}
Im **Reiter "Aggregation"** kannst Du ebenfalls [**Aggregationen**](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md#reiter-aggregationen) anhand von VQL erstellen.

<figure><img src="/files/e7v0jzpFnW1uozkIowfC" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Klicke **unten rechts** auf eines der **Disketten-Icons**, um die Selektion zu speichern. Mit dem **Button "Speichern"** wird die Selektion zwischengespeichert. Mit dem **Button "Speichern und anwenden"** wird das Fenster nach dem Speichern direkt geschlossen.

<figure><img src="/files/p0KpxqRpWwe322gcTCKp" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Tools im VQL-Editor

Im **VQL-Editor** im **Reiter "VQL Query"** innerhalb der Selektionskonfiguration stehen Dir verschiedene Tools zur Verfügung, die Dir dabei helfen Selektion effizienter zu konfigurieren:

<table><thead><tr><th width="138">Tool</th><th>Beschreibung</th></tr></thead><tbody><tr><td><img src="/files/zHQKioSLJXahyH0c97Yk" alt="Icon formatieren" data-size="line"></td><td><strong>Formatiert</strong> den Code entsprechend der verwendeten Objekte</td></tr><tr><td><img src="/files/f0mu8uI3gZDzSwWaVkG0" alt="Icon rückgängig" data-size="line"> / <img src="/files/VPSwO5unCNhfYOEPBd1y" alt="Icon wiederherstellen" data-size="line"></td><td>Änderung <strong>rückgängig</strong> machen oder <strong>wiederherstellen</strong> (Strg+Z / Strg+Y)</td></tr><tr><td><img src="/files/CxrQ20jSI7st29NkYqQ7" alt="Icon suchen" data-size="line"></td><td>Nach einem Wert im Skript <strong>suchen</strong> (Strg+F)</td></tr><tr><td><img src="/files/kqsIkDxqXknVp0gdZPZe" alt="Icon suchen und ersetzen" data-size="line"></td><td>Nach einem bestimmten Wert im Skript <strong>suchen</strong> und diesen <strong>ersetzen</strong> (Strg+H)</td></tr><tr><td><img src="/files/aaJLq1gCtFRQ9HBEAjwI" alt="Icon Kommentar einfügen" data-size="original"></td><td><strong>Kommentar</strong> ins Skript einfügen (Strg+/)</td></tr><tr><td><img src="/files/INEt497uUBK0Iec63MTl" alt="" data-size="line"> / <img src="/files/qn2c2PZKiRbwWX9aChC2" alt="" data-size="line"></td><td>Alle Klammern <strong>ein- oder ausklappen</strong></td></tr><tr><td><img src="/files/uBEKwy3259vJ9gACoCXD" alt="Icon Code-Snippets" data-size="line"></td><td>Auswahl der meistgenutzten <strong>Code-Ausschnitte</strong>, die beliebig für die Verfassung des Skripts beliebig eingesetzt werden können</td></tr><tr><td><img src="/files/3AQaVM1MACekCcpWwhHk" alt="Icon kopieren" data-size="original"></td><td>Gesamtes Skript <strong>kopieren</strong></td></tr><tr><td><img src="/files/36jjyvc3O1kcQJhiRyAC" alt="Icon minimap" data-size="original"></td><td><strong>Minimap</strong> des Skripts in der oberen rechten Ecke des Skript-Editors ein- und ausblenden</td></tr><tr><td><img src="/files/WVMyvMdRHkbRV5dvrRrR" alt="Icon Zeilenumbruch" data-size="line"></td><td>Bestimme, ob am <strong>Ende der Zeile</strong> im Skript-Editor ein <strong>Zeilenumbruch</strong> erfolgen soll</td></tr><tr><td><img src="/files/LRTkoDfXcVfS4fj79xhP" alt="Icon Design ändern" data-size="original"></td><td><strong>Design</strong> des Skripteditors auswählen</td></tr><tr><td><img src="/files/mo1OfUewJf3ctdEciT5d" alt="Icon Vollbildmodus" data-size="original"></td><td>Skript-Editor im <strong>Vollbildmodus</strong> öffnen</td></tr></tbody></table>

## VQL-Selektionen verwenden

Über das **Feld "Selektion"** kannst Du eine der erstellten Selektionen auswählen. Ist eine Selektion als **Standard** festgelegt, wird diese beim Öffnen des Menüpunkts automatisch ausgewählt.

<figure><img src="/files/rGGvpwGUxzaQEAMJAfL0" alt="Selektion auswählen"><figcaption></figcaption></figure>


---

# 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://help.vario-software.de/vario-cloud-handbuch/auswertungen/freie-vql.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.