> 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/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md).

# Selektionen konfigurieren

C-Unit-Selektionen anlegen, speichern, freigeben und mit Spalten, Sortierungen, Aggregationen und Markierungen konfigurieren.

Auf dieser Seite lernst Du alles über die Einstellungen der C-Unit, die Erstellung eigener Ansichten sowie Speicher- und Zugriffsoptionen.

In unserem **Deep Dive** erhältst Du einen kompakten **Überblick** über alle verfügbaren **Konfigurationsoptionen** in unseren **C-Units**:

{% embed url="<https://www.youtube.com/watch?index=10&list=PL0EUYY7rOquvH67AHkOjoAGmcsgMt8ihx&v=DSi1lUr3-g0>" %}

## Einstellungen der C-Unit

In der Software kommen die C-Units an verschiedenen Stellen vor, an denen Datensätze im sogenannten Datagrid angezeigt werden.

Klicke auf das **Zahnrad**-Symbol in der Kopfzeile der Tabelle, um die Einstellungen für die C-Unit aufzurufen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FWewI7t7UDUiGsTOHd0yu%2Fimage.png?alt=media&amp;token=6f8252dc-4cbd-4241-8f3f-22dbc16e52bb" alt="" width="493"><figcaption></figcaption></figure>

Die Einstellungen für eine bestimmte C-Unit werden in Form von **Selektionen** verwaltet.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FdXvvtzZR1NEnVQaBvKkV%2Fimage.png?alt=media&amp;token=d506afc5-0436-425b-90bf-cee18acc1334" alt="" width="563"><figcaption></figcaption></figure>

Speichere die von Dir angepassten Selektionen, um jederzeit auf diese zugreifen zu können. Lasse Dir die Informationen aus den verfügbaren Datensätzen nach Deinen Bedürfnissen anzeigen.

{% hint style="info" %}
Mit der Tastenkombination **Alt+R** können die Inhalte des Datagrids aktualisiert werden, **ohne** dass **die gesamte Seite** neu geladen werden muss. So kannst Du die Inhalte neu laden und **in der aktuellen Selektion bleiben**, auch wenn diese nicht als Standard-Selektion gespeichert ist.
{% endhint %}

Weiterführende Informationen zu C-Units findest Du auf unserer Handbuchseite zur [**Konfiguration von Selektionen**](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md) und zu [**Filtermöglichkeiten in C-Units**](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/filteroptionen-in-c-units.md).

## Reiter »Allgemein«

Wenn Du die Einstellungen der C-Unit in einem bestimmten Bereich öffnest, werden Dir die Einstellungen der Standard-Selektion angezeigt. Abweichungen von der Standard-Selektion können in einer **neuen Selektion** gespeichert werden, die beim Öffnen des Bereichs **ausgewählt oder als neue Standard-Selektion** für diesen Bereich angelegt werden kann. Um eine (neue) Selektion zu speichern, muss mindestens eine **Bezeichnung** in das entsprechende Feld eingetragen werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FeNn73DblCnYY6hjBUVaX%2Fimage.png?alt=media&amp;token=1a82e39d-6499-49fd-83c5-d72858b9a97a" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}

#### Überschreiben von Selektionen

Sowohl bei **»Speichern«** als auch bei **»Speichern und anwenden«** wird die aktuelle Selektion **überschrieben**. Auch dann, wenn die Bezeichnung vor dem Speichern geändert wurde.

Um aus der geöffneten Selektion eine neue Selektion zu erstellen, muss die bestehende Selektion erst **dupliziert** werden. Dabei wird die alte Bezeichnung durch ein leeres Feld ersetzt, in das die neue Bezeichnung eingetragen werden kann. Nachdem auch die Sichtbarkeit eingestellt wurde, kann die neue Selektion durch Klicken auf »Speichern« oder »Speichern und anwenden« gespeichert werden, ohne die alte Selektion zu überschreiben. Mehr dazu im Abschnitt „**Selektion duplizieren**“.
{% endhint %}

### Zugriffsrechte für alle Benutzer

Mit den Zugriffsrechten kannst Du festlegen, **welche Benutzer bzw. Benutzergruppen** auf die Selektion **zugreifen** bzw. diese **bearbeiten** können. **Administratoren** können unabhängig von den Zugriffsrechten alle Selektionen auswählen und bearbeiten.

#### **Lesen und Bearbeiten**

**Alle Benutzer** können die Selektion **auswählen und bearbeiten**.

#### **Nur Lesen**

**Alle Benutzer** können die Selektion **auswählen**, als **Standard** setzen, **duplizieren** und **herunterladen**, aber **nicht bearbeiten**. Über die Felder „Benutzer (Lesen und Bearbeiten)“ und „Benutzergruppe (Lesen und Bearbeiten)“ können einzelnen Benutzern und Benutzergruppen **zusätzliche Bearbeitungsrechte** zugewiesen werden.

#### **Individuell**

Mit dieser Option kannst Du **gezielt festlegen**, welche Benutzer und Benutzergruppen die Selektion nur auswählen und welche sie auch bearbeiten können. Wenn Du z. B. im Feld „**Benutzer (Lesen und Bearbeiten)**“ nur Deinen eigenen Benutzernamen auswählst, ist die Selektion **nur für Dich sichtbar und bearbeitbar**. Für Benutzer **ohne jegliche Zugriffsrechte** ist die Selektion **nicht sichtbar** und somit auch nicht auswählbar.

{% hint style="info" %}

### Eigene Zugriffsrechte beachten

Bei der Auswahl von Benutzern und Benutzergruppen mit den Optionen **Nur Lesen** und **Individuell** solltest Du daran denken, Deinen eigenen Benutzernamen anzugeben, wenn Du die Selektion weiterhin bearbeiten oder auswählen möchtest. Andernfalls hast Du **keinen Zugriff** mehr auf diese, es sei denn, Du gehörst einer berechtigten Benutzergruppe an oder bist als Administrator angemeldet.

Wird bei der Auswahl des Zugriffsrechts **Nur Lesen** kein Benutzer oder keine Benutzergruppe oder bei dem Zugriffsrecht **Individuell** nur ein Benutzer oder eine Benutzergruppe mit dem Recht **Lesen** ausgewählt, so wird **beim Speichern der Selektion** automatisch **der eigene Benutzer** unter **„Benutzer (Lesen und Bearbeiten)“** eingetragen.
{% endhint %}

### Verwendungszweck

#### **Tabelle**

Mit der Option **Tabelle** werden die Datensätze wie gewohnt in **Tabellen- oder Kachel-Darstellung** aufgelistet.

#### **Statistik**

Die Daten werden von der C-Unit explizit zum Zweck einer **Statistik-Darstellung** erfasst. Die Ergebnisse lassen sich unter anderem als **Tabelle, Säulen-, Linien-, Kreis-, Baum-, Sunburst-, Streu-, Netz- oder Trichterdiagramm sowie als Tachometer** darstellen. Die Optionen zur Darstellung öffnest Du über das **Zahnrad** neben der Diagrammauswahl.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FJdwkNStEGhU6UpgtEDo8%2Fimage.png?alt=media&amp;token=fec4b958-8c78-449f-84a7-187e908fa184" alt="Statistik Zahnrad"><figcaption></figcaption></figure>

<details>

<summary><strong>Beispiel</strong> für den Verwendungszweck Statistik</summary>

Mit dem Verwendungszweck **Statistik** ist es z. B. möglich, innerhalb der Belegverwaltung ein Säulendiagramm mit der Summe der Netto- und Bruttobeträge der Adressen im Menüpunkt **Verkaufsbelege** zu erstellen.

Hierfür wird im Reiter **»Spalten«** **an erster Stelle** die Spalte **„Kurzbezeichnung“** aus dem Adressbereich zu einer leeren Selektion hinzugefügt. Dadurch erscheinen die **Adressen auf der X-Achse**, während die Beträge als Balken in der Y-Achse dargestellt werden. Dazu werden die Spalten **„Betrag Brutto“** und **„Betrag Netto“** mit der Funktion **Summe** hinzugefügt, mit der die Summe der Beträge gebildet wird.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FF134HMaPH5ukrzbGLO17%2Fimage.png?alt=media&amp;token=27ba7eac-858a-4efe-a8a0-2eb832579faa" alt=""><figcaption></figcaption></figure>

In den **Einstellungen für das Säulendiagramm** kann u. a. angegeben werden, dass das Diagramm **horizontal** dargestellt wird, wodurch die Daten in der X-Achse, in diesem Fall die Adressen, auf der Y-Achse dargestellt werden. Zusätzlich kann der **Durchschnitt** durch eine Strichlinie zu den entsprechenden Werten angezeigt werden.

Mit dem Toggle **»Reihe hervorheben«** können die Balken zu einem Wert durch Hovern mit der Maus über einen der Balken oder eine der Diagrammbeschriftungen hervorgehoben werden, indem die restlichen Balken ausgeblendet werden.

Mit dem Toggle **»Werte eingrenzen können«** lassen sich die Werte eingrenzen, indem ein Bereich in der unteren Leiste des Diagramms markiert wird. Dieser wird dann durch einen blauen Balken gekennzeichnet, der nach links und rechts verschoben werden kann.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FQrJgH07p4ksMOdfoSgJR%2Fimage.png?alt=media&amp;token=efb8fd2f-2089-497d-b2c3-c4855f8a3b8c" alt=""><figcaption></figcaption></figure>

Als **Endergebnis** sieht das Säulendiagramm folgendermaßen aus:

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FH7ypAqKE3SpkFvVd58QO%2Fimage.png?alt=media&amp;token=ec6c0edf-3b62-4460-b116-c0c960641ff8" alt=""><figcaption></figcaption></figure>

</details>

**Weitere Diagrammarten einrichten**

Wähle für die Selektion den Verwendungszweck **Statistik**. Ordne im Reiter **»Spalten«** zuerst die Gruppierung und danach die gewünschten Kennzahlen an: Die **erste sichtbare Spalte** liefert die Gruppierung, alle **weiteren sichtbaren Spalten** die Werte. Verwende für die Wertespalten Zahlenfelder oder passende Aggregationen wie Summe oder Anzahl.

| Diagrammart          | So werden die Daten dargestellt                                                                                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Streudiagramm**    | Die erste Spalte bildet die Kategorien auf der X-Achse. Jede weitere Wertespalte erzeugt eine eigene Punktreihe mit den Werten auf der Y-Achse.                                                                                       |
| **Tachometer**       | Verwendet nur die **erste Ergebniszeile**. Jede Wertespalte dieser Zeile liefert einen Wert; die Beschriftung stammt aus der jeweiligen Spaltenbezeichnung. Grenze die Selektion passend ein und beachte ihre Sortierung.             |
| **Netzdiagramm**     | Jede Ergebniszeile ergibt ein Profil mit dem Namen aus der Gruppierungsspalte. Jede weitere Wertespalte bildet eine Achse des Netzes.                                                                                                 |
| **Trichterdiagramm** | Bei **einer Wertespalte** ergibt jede Ergebniszeile eine Stufe mit dem Namen aus der Gruppierungsspalte. Bei **mehreren Wertespalten** ergibt jede Wertespalte eine Stufe; dafür werden ihre Werte über alle Ergebniszeilen summiert. |

Beim **Tachometer** stellst Du **Minimum** und **Maximum** passend zu Deinen Werten ein. Der Standardbereich ist 0 bis 100. Beim **Trichterdiagramm** werden die Stufen standardmäßig absteigend nach ihrem Wert sortiert; über **„Sortierung“** kannst Du das ändern.

**Darstellungsoptionen je Diagrammart**

Welche Einstellungen im Zahnrad erscheinen, hängt von der gewählten Diagrammart ab. Einige Felder werden erst eingeblendet, wenn Du die zugehörige Option aktivierst – zum Beispiel der Innenradius im Donut-Modus oder die Deckkraft eines Flächendiagramms.

| Diagrammart           | Wichtige Einstellungen                                                                                                                                                                                    |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Säulendiagramm**    | Balkenbreite, Balken- und Kategorieabstand, abgerundete Ecken, Daten stapeln sowie Balkenbeschriftung mit Position und Schriftgröße.                                                                      |
| **Liniendiagramm**    | Linien glätten, Flächendiagramm mit Deckkraft und Verlauf, Stufen-Linie, Datenpunkte mit Symbol und Größe sowie Linienbreite und Linientyp.                                                               |
| **Kreisdiagramm**     | Donut-Modus mit Innenradius, Außenradius, Startwinkel und Segmentabstand. Aktiviere die Beschriftung, um zusätzlich Werte oder Prozentanteile anzuzeigen.                                                 |
| **Baumdiagramm**      | Blatt-Tiefe, Sichtbarkeitsgrenze und Kachelabstand. Über die Interaktionsoptionen kannst Du Zoomen und Verschieben sowie das Hineinzoomen per Klick aktivieren.                                           |
| **Sunburst-Diagramm** | Innen- und Außenradius, Segmentabstand, Drehung und Mindestwinkel der Beschriftungen sowie Hervorhebung eines Pfads und Hineinzoomen per Klick.                                                           |
| **Kalenderdiagramm**  | Zellengröße, Zellenrahmen, Trennlinienbreite sowie Typ und Ausrichtung der Farbskala.                                                                                                                     |
| **Streudiagramm**     | Symbolgröße, Symbolform und Deckkraft der Punkte, Beschriftungen sowie Markierungen für Durchschnitt, Minimum und Maximum.                                                                                |
| **Tachometer**        | Minimum und Maximum der Skala, Radius, Start- und Endwinkel, Unterteilungen sowie Länge und Breite des Zeigers und Schriftgrößen für Titel und Wert.                                                      |
| **Netzdiagramm**      | Netzform, Radius, Startwinkel, Unterteilungen und gemeinsamer Achsenhöchstwert. Ergänzend kannst Du Flächenfüllung, Deckkraft, Linienstil und Datenpunkte einstellen.                                     |
| **Trichterdiagramm**  | Breite, minimale und maximale Segmentgröße, Segmentabstand, Sortierung und Ausrichtung. Für die Beschriftung lassen sich Position und Schriftgröße sowie zusätzliche Werte und Prozentanteile einstellen. |

Das **Kalenderdiagramm** wird nur angeboten, wenn die Gruppierung ein Datumsfeld ohne weitere Datumsfunktion verwendet oder mit **In Datum** in ein Datum umgewandelt wird. Eine Gruppierung nur nach Monat oder Jahr genügt dafür nicht.

Unter den allgemeinen Diagrammeinstellungen kannst Du die **Legende** ausblenden sowie ihre Position und Ausrichtung festlegen, soweit die Diagrammart eine Legende verwendet. Speichere die Selektion, wenn Du die Einstellungen dauerhaft verwenden möchtest.

**Diagramme vergleichbar und lesbar darstellen**

Öffne bei einer Selektion mit dem Verwendungszweck **Statistik** das **Zahnrad neben der Diagrammauswahl**. Für Säulen- und Liniendiagramme kannst Du den Wertebereich der Y-Achse einstellen:

* **»Y-Achse bei 0 starten«**: Legt die untere Grenze auf 0 fest. Diese Einstellung hat Vorrang vor **„Y-Achse Minimum“**.
* **„Y-Achse Minimum“** / **„Y-Achse Maximum“**: Gib feste Grenzen ein, um mehrere Diagramme mit demselben Maßstab zu vergleichen. Für eine andere Untergrenze als 0 deaktiviere zuerst **»Y-Achse bei 0 starten«**. Leere Grenzfelder überlassen die Skalierung wieder dem Diagramm.

Bei Säulen- und Liniendiagrammen gelten diese Grenzen für die normale, vertikale Darstellung. Für die horizontale Darstellung werden sie nicht übernommen. Die Achseneinstellungen ändern die Darstellung, nicht die abgefragten Daten; zum Eingrenzen der Datensätze verwendest Du weiterhin die Filter der Selektion.

Auch beim **Streudiagramm** kannst Du **Y-Achse bei 0 starten** aktivieren.

Sind lange Beschriftungen auf der X-Achse schlecht lesbar, aktiviere **X-Achsen-Labels drehen** und wähle den **Drehwinkel (°)** zwischen 0 und 90. Diese Einstellung steht für Säulen-, Linien- und Streudiagramme zur Verfügung und dreht die Beschriftungen der normalen Kategorieachse. Speichere die Selektion, wenn Du die Darstellung beibehalten möchtest.

#### **Weiterleitung**

Mit Weiterleitung wirst Du beim Anklicken des Datensatzes in den **Zielbereich** des angeklickten Datensatzes weitergeleitet, den Du im Feld **„Ziel“** angibst (falls anwendbar).

So kannst Du Selektionen definieren, die dafür sorgen, dass die Auswahl eines Datensatzes **nicht in die Stammdaten** des Datensatzes führt, **sondern in einen anderen Bereich**, wie z. B. Dashboard, Ansprechpartner, Zusatzadressen oder Zusatzfelder. Öffnet ein Datensatz, etwa ein Deal, sonst mit dem Reiter »Dashboard«, kannst Du als Ziel auch Stammdaten angeben.

### Beschreibung

Die Beschreibung ist unter anderem sinnvoll, um festzuhalten, zu welchem **Zweck** die Selektion erstellt wurde oder was selektiert wird.

Außerhalb der C-Unit-Einstellungen kann dieser Beschreibungstext durch das Überfahren mit der Maus über das **Fragezeichen**-Symbol neben der Selektions-Auswahl oder über eine der Selektionen im **Drop-Down-Menü** eingeblendet werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FHewrhtLPsS3G68SHaEFE%2Fimage.png?alt=media&amp;token=3f5dbadf-d4ac-48f0-a587-7f32b77174d9" alt=""><figcaption></figcaption></figure>

### Modus

Im Feld „Modus“ kannst Du auswählen, in welchem Modus Du die Selektion bearbeiten möchtest.

**Selektion:** Du kannst Deine individuelle Selektion anhand der zur Verfügung stehenden Einstellungen zusammenstellen.

**VQL:** Du kannst individuelle Selektionen auf Basis von VQL erstellen. Die VQL-Abfragen kannst Du unter den weiteren Reitern konfigurieren. Weitere Informationen zu VQL findest Du [**hier**](https://help.vario-software.de/vario-cloud-handbuch/auswertungen/freie-vql.md).

{% hint style="info" %}
**VQL-Kenntnisse erforderlich**

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

### Anzahl der Datensätze

Hier kannst Du angeben, wie viele Datensätze in der C-Unit aufgelistet werden sollen. Angezeigt werden die ersten Datensätze, die der Selektion entsprechen.

### Datensätze mit gleicher ID ausblenden

Wenn bei der Selektion mehrere Datensätze mit der **gleichen ID** angezeigt werden, kannst Du über den Toggle festlegen, dass doppelte Datensätze **ausgeblendet** werden. Der Toggle ist im Modus **Selektion** standardmäßig **aktiviert**, während er im Modus **VQL** deaktiviert ist.

### Summen per Klick aufschlüsseln

Mit der Option **»Summen per Klick aufschlüsseln«** kannst Du bei zusammengefassten Werten die dahinterliegenden Einzeldatensätze öffnen, wie unter [Drilldown auf die Einzelsätze](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/bedienung-und-taegliche-nutzung.md#drilldown-auf-die-einzelsatze) beschrieben.

1. Öffne über das **Zahnrad** die Einstellungen der gewünschten Selektion. Du benötigst Bearbeitungsrechte für diese Selektion.
2. Aktiviere im Reiter **»Allgemein«** **»Summen per Klick aufschlüsseln«**.
3. Klicke auf **»Speichern und anwenden«**.

Beim Verwendungszweck **Statistik** ist die Aufschlüsselung automatisch eingeschaltet; der Schalter wird dort nicht angezeigt. Die Einstellung gehört zur gespeicherten Selektion und gilt für alle Benutzer, die diese Selektion verwenden.

Die Selektion muss zusammengefasste Werte liefern, die sich auf Einzeldatensätze zurückführen lassen. Der Schalter allein erzeugt keine Gruppierung.

### Kachelansicht als Standard

Mit dem Toggle **»Kachelansicht als Standard«** legst Du fest, dass die Datensätze dieser Selektion zunächst in der **Kachel-Darstellung** angezeigt werden. Die Einstellung wird mit der Selektion gespeichert. Der Toggle steht im Verwendungszweck **Statistik** nicht zur Verfügung.

Wählst Du eine andere Selektion aus, gilt deren Vorgabe. Wenn Du in der Übersicht manuell zwischen Tabellen- und Kachel-Darstellung wechselst, gilt das nur für Deine aktuelle Ansicht – die gespeicherte Selektion bleibt unverändert.

#### Datumsbestandteile auswerten

Für Datumsfelder stehen zusätzlich diese Funktionen zur Verfügung:

| Funktion     | Ergebnis                                               |
| ------------ | ------------------------------------------------------ |
| **In Tag**   | Tag des Monats als Zahl, z. B. 15.                     |
| **In Monat** | Monat als Zahl von 1 bis 12.                           |
| **In Jahr**  | Jahreszahl, z. B. 2026.                                |
| **In Datum** | Entfernt den Uhrzeitanteil eines Datum-Uhrzeit-Feldes. |

Damit kannst Du Datensätze beispielsweise nach ihrem Anlegemonat zählen. Erstelle in **Adressen** eine eigene Selektion und nimm im Reiter **»Spalten«** nur diese drei Spalten auf:

| Spalte          | Funktion     |
| --------------- | ------------ |
| **Erstellt am** | **In Jahr**  |
| **Erstellt am** | **In Monat** |
| **ID**          | **Anzahl**   |

Dupliziere **Erstellt am** für die zweite Spalte und wähle in den beiden Spalten jeweils nur die angegebene Funktion. Entferne im Reiter **»Sortierungen«** die bisherigen Sortierungen und wende die Selektion an. Das Ergebnis enthält je Jahr und Monat die Anzahl der angelegten Adressen; die ursprünglichen Datumswerte werden nicht geändert.

Verwende **Jahr und Monat gemeinsam**, wenn Deine Daten mehrere Jahre umfassen. Mit **In Monat** allein werden beispielsweise alle Januar-Einträge zusammengezählt. Weitere Spalten ohne Aggregation unterteilen die Gruppen zusätzlich – auch dann, wenn diese Spalten ausgeblendet sind.

### Weitere Optionen

#### Selektion leeren

Mit Hilfe des Buttons »Selektion leeren« kannst Du alle **aktuellen Einstellungen der Selektion entfernen** und somit die Selektion leeren. Der Button sorgt jedoch nicht dafür, dass die geöffnete Selektion gelöscht wird, sondern dafür, dass nun aus einer **vollständig leeren Selektion** eine neue erstellt werden kann. Das ist sowohl mit einer vom Benutzer erstellten Selektion als auch mit einer Default-Selektion in einem bestimmten Bereich möglich.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FZJ7sCzbvIWkPU1QxqS0W%2Fimage.png?alt=media&amp;token=cd0f2bf3-f031-4ce4-90a9-27390a997827" alt=""><figcaption></figcaption></figure>

#### Selektion duplizieren

Mit dem Duplizieren-Button kann eine neue Selektion **auf Grundlage der geöffneten Selektion** erstellt werden, indem diese dupliziert wird:

Die **Bezeichnung** und die **Sichtbarkeitswerte** der Selektion **werden entfernt**, während **alle anderen Eigenschaften der Selektion erhalten bleiben**. Der Duplizieren-Button ist nur verfügbar, wenn Du die C-Unit-Einstellungen einer gespeicherten Selektion öffnest.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FhsCIrVKjCgBEiqJzSujl%2Fimage.png?alt=media&amp;token=d70e2e1f-35aa-4d65-b0f7-e182c5d4a51e" alt=""><figcaption></figcaption></figure>

#### Selektion löschen

Durch Klick auf den Löschen-Button wird eine vorhandene Selektion gelöscht. Nach Anklicken des Buttons wird nochmals gefragt, ob die Selektion wirklich gelöscht werden soll.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F5Pmy0N3qDJh0lD2VobcU%2Fimage.png?alt=media&amp;token=fce84996-c7a7-4770-ad98-e9afe71a4f96" alt=""><figcaption></figcaption></figure>

#### Herunterladen einer Selektion

Du kannst Selektionen aus VARIO Cloud herunterladen, um diese **als Dateien im Dateisystem zu speichern**. Klicke auf den entsprechenden Button, um die aktuell ausgewählte Selektion herunterzuladen. Dadurch wird ein in Browser-Download ausgelöst: Die Selektion wird als **JSON-Datei** heruntergeladen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F1yuOmoxwccwh53mTA3Yz%2Fimage.png?alt=media&amp;token=313e08b5-7068-487f-962b-65275bca6969" alt=""><figcaption></figcaption></figure>

#### Hochladen einer Selektion

Durch Anklicken des Buttons zum Hochladen einer Selektion lässt sich eine Selektion aus einer **JSON-Datei aus dem Dateisystem** in VARIO Cloud hochladen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F1yuOmoxwccwh53mTA3Yz%2Fimage.png?alt=media&amp;token=313e08b5-7068-487f-962b-65275bca6969" alt=""><figcaption></figcaption></figure>

Nach Anklicken des Buttons öffnet sich ein Dialog mit dem Dateisystem zur Auswahl einer Datei. Wähle die JSON-Datei einer Selektion aus und die Selektion wird in die C-Unit-Einstellungen geladen.

{% hint style="info" %}
**Hochgeladene Selektionen speichern**

Durch das Auswählen und Hochladen einer im Dateisystem vorhandenen Selektion wird diese noch nicht aktiv als Selektion gespeichert, sondern nur in die C-Unit-Einstellungen geladen. Um die Selektion auch **endgültig zu speichern**, musst Du dies **über die C-Unit-Einstellungen** tun.
{% endhint %}

#### Standard

Wenn Du vor dem Speichern der Selektion den **»Standard«**-Toggle aktivierst, wird die Selektion als Standard-C-Unit-Selektion für diesen Bereich festgelegt. Sie ist dann **immer ausgewählt**, wenn Du den entsprechenden Bereich öffnest.

Ist eine Selektion als Standard festgelegt, kann diese **nicht gelöscht** werden. Dazu muss der Toggle »Standard« wieder deaktiviert werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FizqDFFF7S9TjOxegeD7Y%2Fimage.png?alt=media&amp;token=01359c7b-7832-4b2d-a517-f2368b73f4b5" alt=""><figcaption></figcaption></figure>

#### Vorgabe für Benutzer

Über das Icon zwischen den beiden Toggles mit dem Hinweis „Als Vorgabe für Benutzer oder Gruppen festlegen“ kannst Du die Selektion als **Pflichtstandardselektion** für bestimmte **Benutzer** oder **Benutzergruppen** festlegen. Sie wird dann statt der vom System vorgegebenen Standardselektion angezeigt und beim Öffnen des Menüpunkts oder Bereichs automatisch ausgewählt.

Die Selektion muss bereits gespeichert sein, damit diese Option sichtbar ist.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FLOl4jtL1lf5OMQzfv0Fg%2Fimage.png?alt=media&amp;token=c91a7ade-8c8f-4d5e-b847-3c61937f3ec6" alt="Pflichtselektion setzen" width="550"><figcaption></figcaption></figure>

Je nach Zugriffsrechten können die angegebenen Benutzer die Selektion auch bearbeiten, sie können aber nicht den **»Standard«**-Toggle deaktivieren. Fehlen ausgewählten Benutzern oder Gruppen die Leserechte an der Selektion, werden diese beim Speichern der Vorgabe automatisch mit **Nur Lesen** ergänzt. Bei Zugriffsrechten **Individuell** zeigt Dir der Dialog vorher die dafür einzutragenden Benutzer und Gruppen an. In der Selektionsauswahl wird die Selektion mit dem Hinweis **„Vorgabe Unternehmen“** markiert.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FXY8IUhWEVUTOKhUFW157%2Fimage.png?alt=media&amp;token=f3c6c399-3808-4257-98df-91b45e23f5df" alt="Vorgabe StandardSelektion" width="563"><figcaption></figcaption></figure>

Die Benutzer können weiterhin auf weitere Selektionen zugreifen, können aber keine weitere als Standard setzen. **Neue Selektionen** können die Benutzer erstellen, indem sie die Standardselektion kopieren.

Für betroffene Benutzer ersetzt die Vorgabe die Option **keine Selektion**. Am Standard-Toggle erscheint der Hinweis „Die Standardselektion dieser Liste wurde für Dich vom Administrator festgelegt“.

Die Option steht **nur Admin-Benutzer** zur Verfügung.

Als Administrator siehst Du weitere hinterlegte Vorgaben für diese Liste unter **„Weitere Vorgaben für diese Liste“**. Hier kannst Du die **Pflicht** auch entfernen. Die **Selektion** bleibt dabei erhalten. Entfernst Du bei der aktuellen Vorgabe alle Benutzer und Gruppen und speicherst, hebst Du diese Vorgabe ebenfalls auf.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FdQwn5IvUkgn5HjuM9WMn%2Fimage.png?alt=media&amp;token=6d529409-7432-4e4e-893e-63f9a3c85abf" alt=""><figcaption></figcaption></figure>

#### Für Workflow

Mit dem Toggle **»Für Workflow«** gibst Du die Selektion zur Verwendung in **Workflows** frei. Diese kannst Du dann unter den **Parametern** in den Elementen **„Benutzerskript“** und **„Abfrage“** auswählen. Weitere Informationen dazu findest Du [**hier**](https://help.vario-software.de/vario-cloud-handbuch/system/workflows/workflow-elemente.md#benutzerskript).

{% hint style="info" %}
Sobald eine Selektion für die Verwendung in Workflows freigegeben wird, steht sie **ausschließlich für Parameter** innerhalb von Workflows zur Verfügung. Sie kann dann **nicht mehr** als reguläre Selektion in der **C-Unit** verwendet oder **bearbeitet** werden.
{% endhint %}

### Speichern und Anwenden von Selektionen

**»Speichern«**: Die C-Unit-Einstellungen der aktuellen Selektion werden unter der gerade eingetragenen Bezeichnung gespeichert und angewendet; die **Einstellungen bleiben** dabei aber **geöffnet**.

**»Anlegen und anwenden«**: Wie »Speichern«, die **Einstellungen werden** jedoch direkt **geschlossen**.

**»Vorschau anzeigen«**: Änderungen an den Einstellungen der C-Unit werden übernommen, es wird aber **keine neue Selektion** dazu **erstellt**.

{% hint style="info" %}
Bei Filtern auf **Datums- und Datumzeitfelder** müssen alle Werte ausgefüllt sein, die der gewählte Vergleich braucht: ein Wert bei Einzelvergleichen, **von** und **bis** bei Bereichen, mindestens ein Wert bei Mehrfachauswahl. Solange das nicht der Fall ist, sind **„Temporär anwenden“**, **„Speichern und anwenden“** und **„Spaltenbreiten anpassen“** gesperrt (Tooltip „Filter überprüfen“). Leere Angaben oder Angaben nur aus Leerzeichen zählen als fehlend. Für **„Ist leer“** und **„Ist nicht leer“** brauchst Du keinen Wert; Variablen und relative Datumsangaben sind gültig.
{% endhint %}

#### Temporäre Selektion

Wenn **Änderungen an der Default-Selektion** in der **Vorschau** angezeigt, aber nicht **gespeichert** werden, wird die Selektion automatisch als temporäre Selektion gespeichert. Diese kann nachträglich ebenfalls als Selektion ausgewählt werden und bleibt solange erhalten, bis sie unter einer anderen Bezeichnung gespeichert wird, auch wenn der Bereich oder der Browser verlassen wird. Diese wird jedoch auch gelöscht, wenn der Browser-Cache geleert wird.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FwaLIl6ReC4F8IhMA2dnI%2Fimage.png?alt=media&amp;token=683d3eae-5154-48df-8664-242498890084" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Es kann immer **nur eine temporäre Selektion** pro Bereich je User geben. Wird eine neue temporäre Selektion erstellt, ohne die vorherige zu speichern, **wird die alte durch die neuen Einstellungen ersetzt.**
{% endhint %}

## Reiter »Spalten«

Hier kannst Du festlegen, welche Spalten beim Ausführen der C-Unit angezeigt werden sollen. Mit einem Klick auf die Reiterüberschrift kannst Du die Spalten als **Kreuztabelle** darstellen lassen. Weitere Informationen dazu findest Du [hier](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/kreuztabellen.md).

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FqR7Qr6H63EM9t9RrDcaG%2Fimage.png?alt=media&amp;token=5674d1ef-479a-4853-aa49-7331492885d7" alt="" width="563"><figcaption></figcaption></figure>

Hier eine Übersicht der **Symbole aus der oberen Maske** und ihrer Bedeutung (von links nach rechts):

| Symbol             | Funktion                                                                                                                                                               |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Stern              | Kennzeichnet die empfohlenen Spalten, die für eine korrekte Darstellung der Selektion erforderlich sind. Mehr dazu im Abschnitt **„Empfohlene Spalten“** weiter unten. |
| Schloss            | Spalte fixieren. Mehr dazu im Abschnitt **„Spalte fixieren“** weiter unten.                                                                                            |
| Mülleimer          | Spalte löschen                                                                                                                                                         |
| Auge               | Spalte im Datagrid aus-/einblenden                                                                                                                                     |
| Duplizieren        | Spalte duplizieren                                                                                                                                                     |
| Drag'n'Drop-Fläche | Anordnung ändern                                                                                                                                                       |

#### Reihenfolge der Spalten ändern

Ziehe eine Zeile an der **Drag'n'Drop-Fläche** an die gewünschte Stelle. Ob die Zeile davor oder dahinter eingefügt wird, hängt davon ab, ob Du sie über der oberen oder unteren Hälfte der Zielzeile ablegst. Die Einfügestelle wird markiert. Bei langen Listen scrollt die Ansicht automatisch weiter, solange Du die Zeile am oberen oder unteren Rand des sichtbaren Bereichs hältst.

Alternativ kannst Du auf die Drag'n'Drop-Fläche klicken und im Menü **An den Anfang**, **Nach oben**, **Nach unten** oder **Ans Ende** wählen. Mit dem Tastaturfokus auf der Fläche oder auf einer markierten Zeile verschiebst Du die Zeile mit **Alt+Umschalt+↑/↓**. Die verschobene Zeile wird kurz hervorgehoben.

Dasselbe gilt für die Reihenfolge in den Reitern **»Sortierungen«** und **»Aggregationen«** sowie in der Kreuztabelle.

Mit dem Toggle **»Ohne Doppelnennung«** kann verhindert werden, dass Datensätze aus den ausgewählten Spalten doppelt ausgegeben werden, wie z. B. die gleiche ID, so dass z. B. die gleiche Adresse mehrfach angezeigt wird.

### Spaltensuche

Mit der **Spaltensuche** kannst Du weitere Spalten **hinzufügen**, so dass sie in der Ausgabe der Selektion mit angezeigt werden. Diese listet Dir alle im aktuellen Bereich verfügbaren Spalten auf. Spalten, die in der aktuellen Ansicht enthalten sind, sind **angehakt** und **grün** eingefärbt.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FuDgRjbfl4KRpCOdXZ2Vg%2Fimage.png?alt=media&amp;token=c59a185b-9676-40e4-ab7a-8f91ee56ee30" alt="" width="563"><figcaption></figcaption></figure>

Füge weitere Spalten zur Selektion hinzu, indem Du entweder die **Zeile selbst** anklickst, um eine **einzelne Spalte** auszuwählen, oder die **Checkbox**, um **mehrere Spalten** auszuwählen. Eine neu hinzugefügte Spalte wird unten aufgelistet (hier die Spalte **„Handelsregister-Kennung“**).

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fcl0xOt4VN2nVHNL4wobf%2Fimage.png?alt=media&amp;token=75397d9b-53c7-4baa-a40c-d64dfe1c4371" alt="" width="563"><figcaption></figcaption></figure>

### Empfohlene Spalten

Für die **korrekte Darstellung** der Datagrids in den verschiedenen Bereichen sind bestimmte Spalten notwendig. Ein Beispiel hierfür sind die Spalten **„Belegstatus“** und **„Veröffentlichungsstatus“** in der Belegverwaltung. Fehlt eine dieser Spalten in der Selektion, können die **Status-Symbole** zu den Belegen nicht korrekt angezeigt werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F16IyWyxf8qSqAVIhnkm7%2Fimage.png?alt=media&amp;token=344e2e9c-48da-4ac2-acb5-9f5f55bf68d6" alt="" width="563"><figcaption></figcaption></figure>

Aus diesem Grund sind diese Spalten mit einem **Stern** als **empfohlene Spalten** gekennzeichnet. Nach dem Entfernen einer oder mehrerer empfohlener Spalten weist Dich beim Speichern der Selektion eine Meldung auf die fehlenden Spalten hin. Du hast dann die Möglichkeit, den Vorgang abzubrechen, zu speichern oder die fehlenden Spalten hinzuzufügen und zu speichern. Mit dem Button **»+Empfohlene Spalten«** können alle entfernten empfohlenen Spalten wieder hinzugefügt werden. Je nach Spalte werden diese ein-/ausgeblendet eingefügt und können über das **Auge**-Symbol für die Ansicht im Datagrid wieder eingeblendet werden.

Je nach Bedarf können auch Selektionen ohne diese Spalten ihren Zweck erfüllen, daher ist das Hinzufügen dieser Spalten nur eine Empfehlung und keine Pflicht. In den Verwendungszwecken **Statistik** und **Kreuztabelle** sowie im Modus **VQL** werden **keine empfohlenen Spalten** gekennzeichnet, da die Darstellung in diesen Fällen vom Standard-Datagrid abweicht.

### Spalte „ID“

Die Spalte **„ID“** wird benötigt, um bei einem Klick auf einen Datensatz in diesen weitergeleitet zu werden. Sie kann jedoch über das **Auge**-Symbol ausgeblendet werden, sodass sie im Datagrid nicht sichtbar ist. Je nach C-Unit hat diese außerdem Einfluss auf die **Darstellung** der aufgelisteten Datensätze.

<details>

<summary><strong>Beispiel</strong> für den Einsatz von ID-Spalten</summary>

Beispielsweise können im Menüpunkt **Aktivitäten** der **Benutzername** und das **Profilbild der Benutzer** innerhalb der **Time-Line-Darstellung** nur durch das Hinzufügen der **Benutzer-ID** angezeigt werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FGvBGfmdRTi24cD4zEqKY%2Fimage.png?alt=media&amp;token=dcf9dfdc-5f8f-4ce0-ae8e-1b6b6a8e0138" alt=""><figcaption></figcaption></figure>

Ohne diese Angabe ist diese Darstellung nicht möglich.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fup0fDMtjNgTVU8CLWiCQ%2Fimage.png?alt=media&amp;token=9a80772b-fcba-4a6a-87f0-67fe3953f10f" alt=""><figcaption></figcaption></figure>

</details>

Innerhalb einer C-Unit bzw. Selektion kannst Du die **Reihenfolge** der ID-Spalten flexibel festlegen, was sich auf die **Navigation** auswirkt. Sind **mehrere ID-Spalten** vorhanden, wird die an **erster Stelle** stehende ID **priorisiert**. Mit anderen Wörtern: Die **ID**-Spalte, die an **erster Stelle** platziert wird, bestimmt, welcher **Datensatztyp** mit einem **Linksklick** auf den Datensatz geöffnet werden soll.

<details>

<summary><strong>Beispiel</strong> für mehrere ID-Spalten in Offene Posten</summary>

Beispiel für eine Selektion in **Finanzen → Offene Posten**:

Wenn die Reihenfolge auf **Offene Posten ID**, **Adress ID** und **Auftrags ID** festgelegt ist, wird diese Reihenfolge auch bei der Navigation berücksichtigt:

* **Linksklick:** Öffnet den Datensatz basierend auf der priorisierten ID (in diesem Fall den **OP**).
* **Rechtsklick:** Öffnet das **Kontextmenü**, in dem die **weiteren Datensatztypen** in der festgelegten Reihenfolge aufgelistet werden, die darüber geöffnet werden können.

Falls eine für die Navigation **erforderliche ID-Spalte** fehlt, erscheint beim Auswählen eines Datensatzes eine entsprechende Meldung. Statt die C-Unit-Einstellungen manuell zu öffnen, kannst Du die fehlende ID-Spalte direkt über den **Stift**-Symbol hinzufügen.

Wenn in einem Datensatz die für die Navigation **erforderlichen Angaben nicht vorhanden sind**, wird kein Stift-Symbol angezeigt.

</details>

### Spaltenbreite einstellen

Mit der Option **»Skalieren«** unten rechts kannst Du die Spaltenbreite aller für die Selektion ausgewählten Spalten festlegen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FNRseUvYGhq53Eshoeck7%2Fimage.png?alt=media&amp;token=1e2c091f-e17a-4567-a3ac-bfddb7646fa0" alt="" width="563"><figcaption></figcaption></figure>

Daraufhin werden die Einstellungen vorübergehend geschlossen und das Datagrid im Skalieren-Modus angezeigt. Dies erkennst Du am eingefärbten **Zahnrad**-Symbol und daran, dass nun unter jeder Spaltenüberschrift der **doppelseitige Pfeil** angezeigt wird. Um die Spaltenbreite einzelner Spalten zu verändern, **klicke auf den Spaltenkopf** und **halte ihn gedrückt**, während Du ihn nach **links oder rechts** verschiebst. Über das eingefärbte **Zahnrad**-Symbol gelangst du zurück in die C-Unit-Einstellungen, in denen Du die Anpassungen speichern kannst. Das **rosa Männchen** zeigt an, dass eine Spalte individuell angepasst wurde und mit dem **kreisenden Pfeil** kann die Änderung wieder **aufgehoben** werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fsd0tiKQGIRNQJY3teELs%2Fimage.png?alt=media&amp;token=a1d29ffd-19e2-4478-9b71-b240518d02e4" alt="" width="563"><figcaption></figcaption></figure>

### Spalte fixieren

Mit dem **Schloss**-Symbol hast Du die Möglichkeit, die Spalten so zu fixieren, dass sie auch beim horizontalen Scrollen nach rechts **stets angezeigt** werden.

#### Mehrere Spalten gleichzeitig fixieren

Beachte: Wenn Du auf das **Fixieren**-Symbol einer Spalte klickst, die z. B. an dritter Stelle steht, werden immer auch die Spalten darüber bzw. links davon fixiert.

Der Screenshot zeigt ein Beispiel, bei dem durch das Fixieren der Spalte „Nummer“, auch die Spalte „ID“ fixiert wird.

So sieht das Ergebnis im Datagrid aus:

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FCXAwnvY14NyGtxhr0461%2Fimage.png?alt=media&amp;token=9f230162-38e9-43ad-938a-5d89ecb9255f" alt="" width="563"><figcaption></figcaption></figure>

### Funktionen

Auf die anzuzeigenden Spalten kannst Du verschiedene Funktionen anwenden. Mit diesen kannst Du bestimmen, wie der Inhalt in der Spalte angezeigt werden soll. **Je nach Inhalt** stehen Dir unterschiedliche Funktionen zur Verfügung. Diese können auch in den Reitern **»Sortierungen«** und **»Aggregationen«** eingesetzt werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FHGHQaFzIVV7Li4cwmvEO%2Fimage.png?alt=media&amp;token=1ce7f175-0da5-494f-bec9-d801fa34b70c" alt="" width="563"><figcaption></figcaption></figure>

<details>

<summary><strong>Beispiel:</strong> Gesamtbetrag von Verkaufsbelege</summary>

Im Menüpunkt **Verkaufsbelege** können z. B. in einer Selektion **nur** mit **Spalten zu den Adressangaben** (siehe Bild) die Spalten **„Betrag Brutto“** bzw. **„Betrag Netto“** mit der Funktion **Summe** hinzugefügt werden. Die Standard-Sortierungen im Reiter **»Sortierungen«** müssen dabei **entfernt** werden.

Durch die Funktion **Summe** wird der Gesamtbruttobetrag bzw. der Gesamtnettobetrag aller Verkaufsbelege zu jeder Adresse aufgelistet.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FzX5yq1qZudOaIrdotsA7%2Fimage.png?alt=media&amp;token=3998e895-5857-4e00-8310-795a835580eb" alt=""><figcaption></figcaption></figure>

Wird zusätzlich die Spalte **zur Bezeichnung der Belegart** hinzugefügt, wird der Gesamtbetrag nicht nur in Abhängigkeit von der Adresse, sondern auch der Belegart angezeigt.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F3xBY4VqcGb7Howqim1zR%2Fimage.png?alt=media&amp;token=2b736fe9-2e2a-427c-a603-d0cb02c09da0" alt=""><figcaption></figcaption></figure>

</details>

Wie aus dem Beispiel bereits ersichtlich, wird bei der Verwendung von **Funktionen** der Inhalt der Spalte **in Abhängigkeit** von den **restlichen in der Selektion ausgewählten Spalten** dargestellt. In diesem Fall ist die Darstellung des Gesamtbruttobetrags bzw. des Gesamtnettobetrags nur dadurch möglich, dass **keine weiteren Spalten** als die für die Adressangaben bzw. die Bezeichnung der Belegarten ausgewählt werden.

#### Erklärung der Funktionen

**Absolutwert**: Negative Werte werden als positiv angezeigt. Positive Werte werden weiterhin normal angezeigt.

**Anzahl**: Anzahl der vorhandenen Inhalte in Bezug auf die übrigen Spalten, z. B. die Anzahl von Belegen in Bezug auf die Belegart.

**Default-if-null**: Wenn der Wert ein NULL ist, d. h. kein Wert vorhanden ist, dann wird stattdessen ein Standardwert verwendet. Bei Zahlen ist dies eine Zahl mit dem Betrag Null, bei Buchstaben eine leere Zeichenfolge.

**Durchschnitt**: der Durchschnitt der vorhandenen Werte.

**Maximum**: der höchste von mehreren vorhandenen Werten.

**Minimum**: der niedrigste von mehreren vorhandenen Werten.

**Summe**: die Summe der vorhandenen Werte.

**Großbuchstaben**: Der gesamte Inhalt wird in Großbuchstaben dargestellt.

**Kleinbuchstaben**: Der gesamte Inhalt wird in Kleinbuchstaben dargestellt.

**Liste**: Zeigt alle Werte an, wenn mehrere vorhanden sind.

**Liste (ohne Doppelnennung)**: Wie bei **Liste** werden alle vorhandenen Werte angezeigt, mehrfach vorkommende Werte jedoch nur einmal.

## Reiter »Sortierungen«

Wie bereits im Abschnitt „Sortierung der Datensätze“ beschrieben, kannst Du in der Übersicht der Datensätze die Sortierung der Tabelle anpassen, indem Du die Spaltenüberschriften anklickst. Hier in den C-Unit-Einstellungen kannst Du die Sortierung noch weiter anpassen und **mehrstufige Sortierungen** einstellen.

Nutze die Spaltensuche, um eine vorhandene Spalte hinzuzufügen. Die Spalte, die hier in der Liste weiter oben steht, wird bei der Sortierung zuerst beachtet. So werden z. B. bei der Einstellung auf dem Screenshot alle Adressen zunächst nach der **Stadt** sortiert und **innerhalb derselben Stadt** nach dem **Namen** sortiert.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FEeM7THrFzuP7ua3bMA5k%2Fimage.png?alt=media&amp;token=d1330e3e-d362-4bc9-836f-7ddc0c99bb31" alt="" width="563"><figcaption></figcaption></figure>

## Reiter »Filter«

Auf [**dieser Seite**](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/filteroptionen-in-c-units.md) lernst Du alles über die vielfältigen Möglichkeiten von Filteroptionen in unseren C-Units.

## Reiter »Variablen«

Hier kannst Du einstellen, wie die sichtbaren Filter (freie Variablen, Pflichtvariablen) auf den verschiedenen Endgeräten dargestellt werden. Du kannst die **Reihenfolge** der Variablen sowie die **Größe** ihrer Darstellung anpassen.

In der **Übersicht** kannst Du die Variablen über das **Filter**-Symbol oberhalb des Datagrids auf- und zuklappen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FJBINudRhmaXpUv80vyiE%2Fimage.png?alt=media&amp;token=4888f0ec-d4e5-4bae-b999-37faf89e0506" alt="" width="563"><figcaption></figcaption></figure>

## Reiter »Aggregationen«

Im Reiter »Aggregationen« kannst Du Aggregationen anlegen, die Dir Auskunft über die **gesamten ausgewählten Datensätze** geben, unabhängig von den Funktionen, die in den Reitern »Spalten« und »Sortierungen« verwendet werden. Beispielsweise kann mit der Spalte **„ID“** und der Aggregation **Anzahl** die gesamte Anzahl der vorhandenen Datensätze angezeigt werden.

Im folgenden Beispiel soll der **Gesamtbruttobetrag** sowie der **höchste, niedrigste** und **der durchschnittliche Bruttobetrag** der vorhandenen Verkaufsbelege ermittelt werden. Mit dem **Duplizieren**-Symbol können die Spalten dupliziert werden, was die Erstellung mehrerer Aggregationen mit derselben Spalte vereinfacht.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F4aGXRVLvFyIineJ2ziHI%2Fimage.png?alt=media&amp;token=0a72c6a9-e810-4460-9a9b-15bb887f1bf7" alt="" width="563"><figcaption></figcaption></figure>

Die Ergebnisse der Aggregationen erscheinen in der **Übersicht** unterhalb der Volltextsuche. Ohne Zeilenmarkierung beziehen sie sich auf die gesamte Abfrage mit den aktuellen Filtern und Variablen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FBGrG1yplpCJAVAfGz4wM%2Fimage.png?alt=media&amp;token=dd8a2378-8e80-4e7f-b31e-8d67c0d1e412" alt="" width="563"><figcaption></figcaption></figure>

### Kennzahlen nur für markierte Zeilen

Sind in Deiner Selektion **Aggregationen** eingerichtet, kannst Du damit auch eine selbst gewählte Teilmenge auswerten: Markiere die gewünschten Zeilen über die Checkboxen. Die Kennzahlen oberhalb der Tabelle wechseln automatisch auf diese Auswahl. Eine **farbige Linie links** kennzeichnet die Auswertung der Auswahl. Hebst Du alle Markierungen auf, erscheinen wieder die Werte der gesamten gefilterten Selektion.

Für die Auswertung einer Auswahl muss das zugrunde liegende Feld in den geladenen Zeilen enthalten sein. Fehlt es, füge es im Reiter **»Spalten«** hinzu; Du kannst die Spalte für die Anzeige ausblenden. Lässt sich eine Kennzahl aus den markierten Zeilen nicht berechnen, zeigt VARIO **keine Daten**. Das betrifft auch **Durchschnitt** und **Anzahl verschiedener Werte** bei bereits gruppierten Ergebnissen.

## Reiter »Markierungen«

In diesem Reiter kannst Du Werte festlegen, nach welchen Kriterien bestimmte Datensätze im Datagrid farblich hervorgehoben werden sollen. Die Konfiguration erfolgt ähnlich wie im Reiter **»Filter«**. Über den Button **»+Markierung hinzufügen«** kannst Du die erste Konfiguration für eine farbliche Markierung anlegen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fd4dm5kqzqGUXh9Tnn1TG%2Fimage.png?alt=media&amp;token=9e383c38-fdc4-40c9-ab0b-4f58d6b5eba2" alt="" width="563"><figcaption></figcaption></figure>

Zu jeder Konfiguration kannst Du Folgendes definieren:

* **„Ziel“**: Hier kannst Du entscheiden, ob die ganze **Zeile** oder nur die **Zelle** markiert werden soll. Wählst Du **Zelle** aus, wird das Feld **„Zielspalten“** eingeblendet. Damit kannst Du auswählen, welche Zelle markiert werden soll, z. B. ob die Adressnummer oder die Stadt. Dabei stehen Dir nur die Spalten zur Auswahl, die im Reiter **»Spalten«** hinzugefügt wurden. Markierung von Zellen ist besonders praktisch für mehrere Markierungen für den gleichen Datensatz.

{% hint style="info" %}
Als **Zielspalten** für die Markierung von **Zellen** kannst Du auch **mehrere Spalten** auswählen, um die Markierung deutlicher zu machen, ohne die ganze Zeile zu markieren.
{% endhint %}

* **„Hintergrundfarbe“**: Wähle die gewünschte Farbe für die Markierung aus. Über das **Pipetten**-Symbol kannst Du eine individuelle Farbe festlegen.
* **„Deckkraft“**: Stelle die Deckkraft der Farbe ein. So kannst Du besonders kräftige Farben transparenter darstellen und den Tabelleninhalt weiterhin gut sehen.
* **„Icon“**: Wähle aus der Liste an **Icons** ein Icon aus, das in der **markierten Zeile** oder **Zelle** angezeigt wird. Bei markierten **Zeilen** wird das Icon zur Datensatznummer angezeigt, bei markierten **Zellen** zur markierten Zelle. Im Feld **„Position“** kannst Du entscheiden, ob das Icon **vor** oder **nach** der Angabe angezeigt werden soll.
* **„Feld“**: Hier stehen Dir die Spalten zur Auswahl, die im Reiter [**Spalten**](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md#reiter-spalten) hinzugefügt wurden.
* **„Operation“**: Bestimme, ob die Markierung angewendet werden soll, wenn z. B. der Wert im Datensatz **größer** oder **kleiner** ist als der im Feld **„Wert“** angegebene Vergleichswert.
* **„Wert“**: Gib den Referenzwert ein, mit dem der Wert im Datensatz verglichen werden soll. Bei Datums- und Datum-Uhrzeit-Feldern kannst Du neben einem festen Datum auch eine relative Datumsangabe wie **„rd{\*.\*.\*}“ (heute)** oder **„rdt{\*.\*.\* \*:\*:\*}“ (jetzt)** verwenden. Sie wird beim Anzeigen der Tabelle neu ausgewertet, sodass Du beispielsweise überfällige Datensätze anhand des jeweils aktuellen Datums markieren kannst. Aufbau und Kürzel sind unter [Relative Datumsangabe](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/filteroptionen-in-c-units.md#relative-datumsangabe) beschrieben. Ergibt ein relativer Ausdruck kein gültiges Datum, trifft diese Bedingung nicht zu.

### Textmuster mit REGEX markieren

Mit **Entspricht Muster (REGEX)** kannst Du Textwerte nach einem gemeinsamen Muster hervorheben, zum Beispiel Artikelnummern mit unterschiedlichen Kennungen.

1. Öffne in der **Artikelübersicht** über das **Zahnrad** eine Selektion, die Du bearbeiten darfst. Nimm im Reiter **»Spalten«** die **Artikelnummer** auf, falls sie noch fehlt.
2. Wechsle zu **»Markierungen«** und klicke auf **»+Markierung hinzufügen«**. Wähle als **Ziel** **Zeile** und eine Hintergrundfarbe.
3. Wähle als **Feld** die **Artikelnummer** und als **Operation** **Entspricht Muster (REGEX)**.
4. Trage unter **„Wert“** das Muster `^(TMP|TEST)-` ein und klicke auf **»Speichern und anwenden«**.

Die Regel markiert Artikelnummern, die mit **TMP-** oder **TEST-** beginnen, etwa `TMP-001` und `TEST-42`. Das Zeichen `^` steht für den Anfang, der senkrechte Strich für die Alternative.

Die Operation steht für **Textspalten** zur Verfügung. Gib das Muster direkt **ohne umschließende Schrägstriche** ein. Groß- und Kleinschreibung werden unterschieden; `tmp-001` trifft im Beispiel nicht zu. Ist das Muster ungültig, trifft die Regel nicht zu.

Die Markierung ändert die Darstellung. Welche Datensätze angezeigt werden, bestimmst Du weiterhin im Reiter **»Filter«**.

{% hint style="info" %}
**Markierungen im Modus VQL**

Auch in Selektionen im Modus VQL kannst Du Markierungen anlegen. Beim Öffnen des Reiters führt VARIO Cloud die VQL-Anweisung zur Ermittlung der Spalten aus. Danach stehen im Feld „Feld“ die für Markierungen unterstützten Ergebnisspalten zur Auswahl.
{% endhint %}

Mit den Buttons **»+Oder«** und **»+Und«** kannst Du weitere Konfigurationen hinzufügen. Wenn **mehrere Konfigurationen** auf denselben Datensatz zutreffen, gilt die **oberste Konfiguration**. Sie hat **Priorität** bei der Darstellung der Markierung. Mehr zur **Filterkonfiguration** mit **Und**- und **Oder-Bedingungen** findest Du [**hier**](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/filteroptionen-in-c-units.md).

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FQyAaNvaUP5bTLY9eLtyg%2Fimage.png?alt=media&amp;token=339481bc-92a8-4026-b891-0aad7144daf2" alt="Markierungen" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Unterschied zwischen dem Wert 0 und einem leeren Feld**

Wenn im Feld **„Wert“** die Zahl **0** eingegeben wird, werden nur Datensätze mit dem **tatsächlichen Wert 0** berücksichtigt. **Leere Felder**, wie z. B. nicht befüllte Verkaufspreise, bleiben dagegen **unberücksichtigt**.

Um auch leere Felder in die Selektion einzubeziehen, wähle bei der **Operation** gezielt **Ist leer** aus.

<img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FGai1gaItJ0KhlNBUJN7r%2Fimage.png?alt=media&amp;token=d9b6d7f1-8a22-4f14-959b-cae13e6831d8" alt="" data-size="original">
{% endhint %}

<details>

<summary><strong>Beispiel</strong> für Zeilen-Markierungen</summary>

Im folgenden Beispiel werden **zwei** farbliche Markierungen innerhalb einer Selektion in der **Artikelverwaltung** konfiguriert. **Voraussetzung** ist, dass im Reiter **»Spalten«** die Spalten **„Bestand“** und **„Verkaufsartikel“** hinzugefügt wurden. Die Angabe, ob es sich um einen **Verkaufsartikel** handelt, wird aus dem Toggle **»Verkaufsartikel«** in den **Artikelstammdaten** übernommen. Nur wenn dieser aktiviert ist, greift die hier dargestellten Beispielmarkierung in der Selektion.

1. **Konfiguration:** Es werden **Verkaufsartikel rot** markiert, die einen Bestand kleiner als **10** haben.
2. **Konfiguration:** Es werden **Verkaufsartikel grün** markiert, die einen Bestand größer als **50** haben.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2F9ovnEzIWRKcl9aEPfPO8%2Fimage.png?alt=media&amp;token=26597dea-93a1-456c-a8fe-360c79f2a90b" alt="" width="563"><figcaption></figcaption></figure>

Nach **Anwendung der Selektion** werden die Markierungen folgendermaßen dargestellt:

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FyZ2sL1G47ZhIxTwi1xsL%2Fimage.png?alt=media&amp;token=0450ba0c-8c20-460c-b46b-a55c808b9a76" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Beispiel</strong> für Zellen-Markierungen</summary>

Der Vorteil von **Zellenmarkierungen** ist, dass Du verschiedene Markierungen für eine Zeile einstellen kannst. Z. B. kannst Du bestimmen, dass **Kundenadressen** in **grün** und **Lieferadressen** in **rot** angezeigt werden. Adressen aus **Neuwied** können zusätzlich in **gelb** angezeigt werden. So kann eine Kundenadresse aus Neuwied sowohl in **grün** als auch in **gelb** markiert werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FPeqqRaIkBAH49Jm9jHlR%2Fimage.png?alt=media&amp;token=9008097d-a68a-4eec-9345-39fd92572bc5" alt=""><figcaption></figcaption></figure>

</details>

## Reiter »Ausgabe«

Im Reiter **»Ausgabe«** verknüpfst Du die Selektion mit einem eigenen **Report** für **»Report drucken«** im Export-Menü der Tabelle. Ohne Verknüpfung verwendet VARIO den passenden Standardreport des Moduls **CUnit**, sofern einer eingerichtet ist, oder erzeugt das Layout automatisch. Die Dateidownloads **Excel**, **CSV**, **JSON** und **Markdown** verwenden dagegen die eingeblendeten Tabellenspalten; die Reportbindung verändert sie nicht.

Die Selektion muss **gespeichert** sein, bevor Du die folgenden Funktionen nutzen kannst:

Nach der Verknüpfung siehst Du im Reiter die **Reportgruppe**, ihren **Identifier** und die Anzahl der enthaltenen **Reports**. Wurde der verknüpfte Report unter System → Ausgabe gelöscht, weist Dich der Reiter darauf hin; lege ihn dann neu an oder löse die Verknüpfung. Weitere Informationen findest Du im Modul [CUnit](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe/modul-cunit.md).

| Button                          | Bedeutung                                                                                                                                      |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reportgruppe anlegen**        | Erzeugt aus den Spalten der Selektion einen neuen Report samt Reportgruppe im Modul CUnit und verknüpft ihn mit der Selektion.                 |
| **Reportgruppe verknüpfen**     | Verknüpft eine vorhandene Reportgruppe des Moduls CUnit. Wähle sie im Feld **„Reportgruppe“** aus.                                             |
| **Reportgruppe neu generieren** | Baut den Report aus den aktuellen Spalten neu auf. Anpassungen, die Du in JasperStudio am Layout vorgenommen hast, gehen dabei verloren.       |
| **Im Berichtsdesigner öffnen**  | Öffnet den Report unter **System → Ausgabe** im Reiter **»CUnit«**. Dort lädst Du das Template herunter, passt es an und lädst es wieder hoch. |
| **Verknüpfung lösen**           | Löst die Verbindung zwischen Selektion und Report. Der Report bleibt erhalten.                                                                 |

## Veraltete Selektionen

Es kann vorkommen, dass ältere Selektionen, die inzwischen **geänderte** oder **veraltete** Felder **bzw. Spalten enthalten**, nicht erfolgreich geladen werden können. In solchen Fällen ist es erforderlich, die **veralteten** oder nicht mehr passenden **Felder** zu **entfernen**, um sicherzustellen, dass die Selektion wieder ordnungsgemäß funktioniert und den aktuellen Anforderungen entspricht.

Beim Auswählen einer veralteten Selektion wird Dir eine **Fehlermeldung** eingeblendet. Klicke in dieser Fehlermeldung auf das **Stift**-Symbol, um die Selektion zu öffnen und zu bearbeiten.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FkLkFW2i67PdAiUhquVUW%2Fimage.png?alt=media&amp;token=d14a74a8-87ea-4ea0-91b2-a382a45dd785" alt=""><figcaption></figcaption></figure>

In den Einstellungen der C-Unit wird Dir dann angezeigt, welche Spalten bzw. Felder veraltet sind. Nachdem diese über den **Mülleimer**-Symbol entfernt wurden, kann die Selektion wieder gespeichert und angewendet werden.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FE1JxwYiooxfn5vIo2p2n%2Fimage.png?alt=media&amp;token=fe5e54a2-550b-4765-b0d8-22d2011bc36b" alt="" width="563"><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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
