> 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/einstellungen/einstellungen-allgemein/zusatzfelder.md).

# Zusatzfelder

Für die Verwendung in Adressen, Artikeln, Belegen, im CRM-Bereich und in Verkaufskanälen können hier **Zusatzfeldgruppen mit Zusatzfeldern** sowie **Aufzählungsgruppen** definiert werden. Dabei können jeweils individuelle Namen vergeben werden. Über die **Zuordnung(en)** wird festgelegt, in welchem Bereich die Zusatzfeldgruppe angezeigt werden soll. So ist z. B. die Zusatzfeldgruppe “Kosmetik (Verpackung)” für den Bereich Artikel interessant, nicht aber für die Adresse. Anhand unseres Beispiels erklären wir Dir Schritt für Schritt, wie man eigene Zusatzfeldgruppen mit Zusatzfeldern und Aufzählungsgruppen definiert, welche Funktionen und Auswahlmöglichkeiten man dabei hat und wie diese dann im entsprechenden Bereich (z. B. Artikel) angezeigt werden.

Hier ein kurzer **Deep Dive** zur Verwendung und Konfiguration von **Zusatzfeldgruppen**:

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

Weiter unten findest Du einen **weiteren Video** zu der **Gruppensichbarkeit** und den **Aufzählungsgruppen**.

## Zusatzfeldgruppe und Zusatzfeld

Mit Auswahl von **“+Zusatzfeldgruppe”** wird eine neue **Zusatzfeldgruppe** angelegt. Im **Feld** “**Kürzel**” sollte ein eindeutiger Name und im **Feld** “**Beschreibung**” ein Tooltip eingegeben werden. Das **Feld** “**Schlüssel**” dient ausschließlich dem technischen Zugriff über die Community-API, VQL oder den Workflow. Falls kein Wert eingegeben wird, wird das Feld automatisch mit group\_1 bzw. field\_1 usw. gefüllt. Das **Feld “Schlüssel”** kann **in der Zusatzfeldgruppe** nur bei Neuanlage vergeben werden, **danach** ist es **readonly**. Aus der Liste der **Zuordnungen** ist der Bereich auszuwählen, in dem diese Zusatzfeldgruppe angezeigt werden soll. Auch hier ist eine Mehrfachauswahl möglich:

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fgh6pWBMpyfNWeqef5txm%2Fimage.png?alt=media&amp;token=bd1a9249-9619-4d74-8532-3a80e5c03e08" alt=""><figcaption></figcaption></figure>

Danach kannst Du über **„+Zusatzfeld“** einzelne Zusatzfelder innerhalb der Gruppe anlegen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FmowDtEZRgyC0EYZJjc4b%2Fimage.png?alt=media&amp;token=d931aad5-6385-4964-b32a-e1f9c69bb851" alt=""><figcaption><p>Zusatzfeldgruppe mit Zusatzfeldern</p></figcaption></figure>

#### Die Bedeutung der Felder und Toggle

* **Schlüssel:** Wird nur für den technischen Zugriff über die Community-API, VQL oder den Workflow benötigt. Falls kein Wert eingegeben wird, wird das Feld automatisch gefüllt (field\_1,…). Erlaubt sind nur JSON-konforme Schlüsselnamen. Leer- und Sonderzeichen sind nicht erlaubt.
* **Kürzel**: Sollte einen eindeutigen Namen enthalten (z.B. Hilfsstoffe)
* **Beschreibung:** Die hier hinterlegte Beschreibung wird als Tooltip des Kürzels verwendet
* **Typ:**
  * **Boolesch:** Fügt einen Toggle zum Aktivieren/ Deaktivieren ein
  * **Datum:** Bietet einen Kalender zur Datumseingabe an (z.B. Hilfsstoffe aktualisiert am xx)
  * **Datum und Uhrzeit:** Bietet die Möglichkeit zur Eingabe von Datum und Uhrzeit
  * **Einfachauswahl:** Bietet eine entweder/oder Auswahl an (z.B. Glasflasche mit oder ohne Pipette) an. Siehe auch Aufzählungsgruppe!
  * **Ganzzahl**: Erlaubt nur die Eingabe von Zahlen
  * **Langer Text**: Ermöglicht das Hinzufügen von Text, Bildern und Verlinkungen innerhalb eines Editors. Weitere Informationen zu den Texteditoren findest Du [hier](/vario-cloud-handbuch/einfuhrung/administratives.md#texteditor-in-vario-cloud).
  * **Mehrfachauswahl:** Bietet eine Auswahl von mehreren Einträgen an (z.B. verschiedene Hilfsstoffe). Siehe auch Aufzählungsgruppe!
  * **Objekt**: Ermöglicht die Speicherung von JSON-Objekten (z. B. für Apps)
  * **Text**: alphanumerisches Eingabefeld
  * **URL:** Ermöglich die Erstellung eines Links anhand einer URL und einen Link-Text
  * **Währung**: für Betragseingaben
* **Ansicht:**
  * **Editierbar:** erlaubt die Eingabe im Zusatzfeld
  * **Schreibgeschützt:** Das Zusatzfeld kann nur gelesen, nicht bearbeitet werden.
  * **Unsichtbar:** Das Zusatzfeld ist nicht in der Cloud, aber in der API sichtbar.
* **Aufzählungsgruppe:** Erlaubt die Auswahl einer Auswahlgruppe bei den Typen Einfach- und/ oder Mehrfachauswahl (Details siehe Aufzählungsgruppe).
* **Toggle Volltextsuche**: Aktiviert die Volltextsuche für Zusatzfelder vom Typ Langer Text, Text, Einfach- und Mehrfachauswahl. Dadurch kannst Du hinterlegte Werte (z.B. Citronensäure) über die Suchfunktion in der Infoleiste oder im C-Unit-Filter "Volltext" durchsuchen.
* **Toggle Aktiv**: Durch Deaktivierung wird das Zusatzfeld bzw. die Eingabe in der Cloud und in der API ausgeblendet.
* **Toggle Indiziert:** Bei Aktivierung wird für das Zusatzfeld ein Datenbankindex erzeugt, der z.B. bei Abfragen als Suchkriterium verwendet werden kann.

Mit dem![](https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FaJSnG8q9qXJBlIqlVm1c%2Fimage.png?alt=media\&token=952eac14-3c9b-4ae0-9fe0-2a7db12b45bf)-Symbol kannst Du eine Zusatzfeldzeile löschen und mit diesem![](https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FWx9BMrbv3hO2XtyMankY%2Fimage.png?alt=media\&token=8f34953f-ddd8-474f-8d14-b2c252ce2984)-Symbol die Reihenfolg ändern.

{% hint style="info" %}
Sobald ein Zusatzfeld in einem Bereich (Beleg, Artikel) erstmals verwendet wurde, können **Zuordnungen** und **Typ** nicht mehr geändert oder gelöscht werden!
{% endhint %}

{% hint style="info" %}

## Formatierung von Objekte

Zusatzfelder mit dem **Typ "Objekt"** können innerhalb des Datensatzes aufgeklappt werden, um die zu bearbeiten und einzusehen. Über den **Button "JSON-Ansicht"** kannst Du die Einträge im **JSON-Format** einsehen und bearbeiten.

<p align="center"> <img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FLxkpWcN32JyCP5Dj5iZa%2Fimage.png?alt=media&amp;token=132063b4-e530-4f0b-bc51-1a67368db488" alt=""></p>
{% endhint %}

### Gruppensichtbarkeit

Wenn Du einer Zusatzfeldgruppe im **Feld „Zuordnungen“** **nur einen Bereich** zuweist, kannst Du Bedingungen festlegen, mit denen Du bestimmen kannst, in welchen Fällen die Zusatzfeldgruppe erscheinen soll. Klicke dazu im **Bereich „Gruppensichtbarkeit“** ganz **rechts** auf das **Auge-Icon** und dann auf **„Bedingung hinzufügen“**, um eine neue Bedingung anzulegen.

Ist bereits eine Gruppensichtbarkeit hinterlegt, wird diese durch einen gefüllten **Auge-Icon** gekennzeichnet.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FhhoUMr1jiL6PQMdWfnk5%2Fimage.png?alt=media&amp;token=cdf1d8b9-fb06-42b9-9bc9-49f859a13a24" alt=""><figcaption></figcaption></figure>

Du kannst Sichtbarkeitsregeln auch für einzelne **Zusatzfelder** innerhalb einer Zusatzfeldgruppe festlegen. Klicke dazu auf das **Auge-Icon** neben dem entsprechenden Zusatzfeld.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FUHEwCUsutJ3dtLIr5FCW%2Fimage.png?alt=media&amp;token=66971c95-9ea3-45ed-950d-d500de56659a" alt=""><figcaption></figcaption></figure>

Sowohl bei Zusatzfeldgruppen als auch bei Zusatzfeldern stehen Dir beim **Anlegen** einer Bedingung im **Feld „Quelle“** **zwei Optionen** zur Auswahl. Darüber legst Du die Art der Bedingung fest.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FqwUOsh1BgwsZFL7ZanqS%2Fimage.png?alt=media&amp;token=98c5185a-993c-4591-89d0-fb194d54164c" alt=""><figcaption></figcaption></figure>

#### Quelle Geschäftsobjekt

Mit der Quelle **„Geschäftsobjekt“** legst Du Bedingungen auf Basis des Bereichs fest, den Du im **Feld „Zuordnungen“** ausgewählt hast. So kannst Du zum Beispiel definieren, dass eine Zusatzfeldgruppe nur angezeigt wird, wenn ein **Artikel** eine **bestimmte Artikelart** hat. Im **Feld „Feld“** stehen Dir dafür die entsprechenden Felder zu gewählten Zuordnung zur Auswahl.

Über die **Felder „Feld“**, **„Operator“** und **„Wert“** legst Du fest, wann die Zusatzfeldgruppe angezeigt wird. In unserem Beispiel wählen wir im **Feld „Feld“** den Eintrag **„Artikelart“**, als **Operator** **„Ist gleich“** und als **Wert** **„Bestandsgeführt“**. Die Zusatzfeldgruppe wird damit nur bei **Artikeln** mit der **Artikelart „Bestandsgeführt“** angezeigt.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FdZeidfboDrhozfCEfm8C%2Fimage.png?alt=media&amp;token=1a3a2180-b2b6-41ea-b1b5-ed04ceb55b47" alt=""><figcaption></figcaption></figure>

#### Quelle Zusatzfeld

Mit der Quelle **„Zusatzfeld“** legst Du Bedingungen auf Basis bereits vorhandener Zusatzfeldgruppen fest.

Über die **Felder „Gruppe“** und **„Feld“** wählst Du die **Zusatzfeldgruppe** und das **Zusatzfeld** aus, auf die sich die Bedingung beziehen soll. Mit den **Feldern „Operator“** und **„Wert“** legst Du fest, wann die Zusatzfeldgruppe angezeigt wird.

In unserem Beispiel wählen wir die **Zusatzfeldgruppe „Kosmetik (Verpackung)“** und das darin enthaltene **Zusatzfeld „Verpackungsart“** aus. Als **Operator** wählen wir **„Ist gleich“** und als **Wert** **„Glasflasche mit Pipette“**. Die Zusatzfeldgruppe wird dann nur angezeigt, wenn in der entsprechenden Zusatzfeldgruppe dieser Wert ausgewählt ist.

So kannst Du festlegen, wie Zusatzfeldgruppen voneinander abhängig zur Auswahl stehen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fnidk5hpOpESJDFbVgqb0%2Fimage.png?alt=media&amp;token=a423c8c3-4a24-45f3-9dcb-5475d30957e3" alt=""><figcaption></figcaption></figure>

#### Und und Oder-Bedingungen

Über die **Buttons „+Oder“** und **„+Und“** kannst Du weitere Bedingungen anlegen. Mit **„Und“** kannst Du bestehende Bedingungen genauer definieren. Mit **„Oder“** legst Du alternative Bedingungen fest. Weitere Informationen zur Verwaltung von **Und-** und **Oder-Bedingungen** findest Du [**hier**](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units/filteroptionen-in-c-units.md#und-und-oder-filtergruppen).

<details>

<summary><mark style="color:$primary;">Beispiel</mark> für <strong>Und</strong></summary>

Als Beispiel für **„Und“-Bedingungen** kannst Du zusätzlich zur Bedingung für die **Artikelart** eine Bedingung dazu anlegen, ob es sich um einen **Einkaufsartikel** handelt.

Die Zusatzfeldgruppe wird dann nur angezeigt, wenn der Artikel **bestandsgeführt** ***und*** ein **Einkaufsartikel** ist.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FfiTAl3UVfNKyhsLc6Tbt%2Fimage.png?alt=media&amp;token=380d77c8-e0d9-46c7-8075-2e88749530a5" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$primary;">Beispiel</mark> für <strong>Oder</strong></summary>

Als Beispiel für **„Oder“-Bedingungen** kannst Du zusätzlich zur Bedingung für die **Artikelart „Bestandsgeführt“** eine Bedingung für die **Artikelart „Dienstleistung“** anlegen.

Die Zusatzfeldgruppe wird dann bei Artikeln mit der **Artikelart „Bestandsgeführt“** ***oder*****&#x20;„Dienstleistung“** angezeigt.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FFR10nAupRWpXZ9xy3fjL%2Fimage.png?alt=media&amp;token=da4cad56-31a8-4fa8-98a0-ffee782b523e" alt=""><figcaption></figcaption></figure>

</details>

Hier einen **Deep Dive** zu der **Gruppensichtbarkeit:**

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

### Anordnung der Zusatzfeldgruppen ändern

Nach dem Anlegen einer Zusatzfeldgruppe kannst Du über **„Anordnung anpassen“** die Darstellung wie **Größe** und **Position** für **verschiedene Endgeräte (Smartphone, Tablet, Desktop) individuell** konfigurieren.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FBTAAK5zq3SWog8SjM34c%2Fimage.png?alt=media&amp;token=87910ae5-9a6d-44ac-9b9f-72077ca7fa65" alt=""><figcaption></figcaption></figure>

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FAqDukm6qCUQzvzPDPH9a%2Fimage.png?alt=media&amp;token=677a052d-c8be-44b7-86bd-16e7cf001705" alt=""><figcaption><p>Anpassung von Größe und Position je Endgerät</p></figcaption></figure>

{% hint style="info" %}
Bei einem Zusatzfeld vom Typ **„Langer Text“** empfiehlt es sich, das Feld größer zu ziehen. So bleibt die komplette Menüleiste des Editors sichtbar.
{% endhint %}

Sind **mehrere Zusatzfeldgruppen** für **denselben** Bereich definiert, kannst Du deren Reihenfolge in den Benutzereinstellungen unter Zusatzfelder anpassen.

### Zusatzfeldgruppen deaktivieren

Wenn eine Zusatzfeldgruppe oder Zusatzfeld einmal verwendet wurde, kann diese oder dieser nicht mehr gelöscht werden. In diesem Fall können einzelne Zusatzfelder über den **Toggle "Aktiv" deaktiviert** werden. Wenn **alle Zusatzfelder einer Zusatzfeldgruppe** deaktiviert wurden, wird automatisch die gesamte Zusatzfeldgruppe deaktiviert, so dass diese **nicht weiter in den Datensätzen angezeigt** wird.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FnyZNBYniSUCWleidbMpp%2Fimage.png?alt=media&amp;token=9bae2e0e-9e05-4cfd-9773-531225b705b4" alt=""><figcaption></figcaption></figure>

## Aufzählungsgruppe und Eintrag

Eine **Aufzählungsgruppe** benötigst Du, wenn ein Zusatzfeld eine **Einfachauswahl** oder **Mehrfachauswahl** anbieten soll.

Über **„+Aufzählungsgruppe“** legst Du die Gruppe an. Wenn Du den **Toggle „Automatisches Anfügen“** aktivierst, kannst Du auch Werte einfügen und speichern, die nicht zur Auswahl stehen. Diese werden automatisch zu den hier hinterlegten Werten hinzugefügt. Mit dem **Toggle „Neue Werte sichtbar“** entscheidest Du, ob diese Werte anderen Datensätzen automatisch zur Auswahl stehen.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fb7S2tmDRKdMkr2keUiTF%2Fimage.png?alt=media&amp;token=05b39a41-a3f2-4eea-951b-81f2cd6fb598" alt="Aufzählungsgruppe anlegen" width="563"><figcaption></figcaption></figure>

Nach dem Speichern gibst Du über **„+Eintrag“** die gewünschten Auswahlwerte ein und fügst diese Aufzählungsgruppe Deinem Zusatzfeld hinzu.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fv7Qpw09f5SY79fB5IJ5e%2Fimage.png?alt=media&amp;token=2cc13508-7125-4f0d-a140-bb6a2a12edcc" alt=""><figcaption><p>Aufzählungsgruppe für eine Mehrfachauswahl</p></figcaption></figure>

### Anwendungsbeispiele für einen Artikel

#### Beispiel für eine Mehrfachauswahl

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FHRfXFR7ceROdJenUqYEI%2Fimage.png?alt=media&amp;token=b60432cd-bc72-4295-a166-1986b17242c9" alt="" width="563"><figcaption></figcaption></figure>

**Für das Beispiel wurden angelegt:**

* die **Aufzählungsgruppe** „Hilfsstoffe (Kosmetik)“ mit aktiviertem Toggle **„Automatisches Anfügen“** (individuelles Textfeld "Eintrag mit Enter bestätigen)
* die **Aufzählungsgruppe** „Wirkstoffe (Kosmetik)“
* die **Zusatzfeldgruppe** „Kosmetik (Hilfsstoffe & Wirkstoffe)“
* die **Zusatzfelder** „Hilfsstoffe“ **und** „Wirkstoffe“ mit Typ **„Mehrfachauswahl“**

#### Beispiel für eine Einfachauswahl mit Bild

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FqC5x23KUqNvwkxG4tBKm%2Fimage.png?alt=media&amp;token=ddaefe58-f1d4-4eb1-a990-01f67585ff0e" alt=""><figcaption></figcaption></figure>

**Für das Beispiel wurden angelegt:**

* die **Aufzählungsgruppe** „Verpackung (Kosmetik)“ mit zwei Einträgen
* die **Zusatzfeldgruppe** „Kosmetik (Verpackung)“
* das **Zusatzfeld** „Verpackung“ mit Typ **„Einfachauswahl“**
* das **Zusatzfeld** „Bild der Verpackung“ mit Typ **„Langer Text“**

Hier ein kurzes **Deep Dive** zu den Aufzählungsgruppen:

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


---

# 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/einstellungen/einstellungen-allgemein/zusatzfelder.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.