# 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. ### 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:
Danach kannst Du über **„+Zusatzfeld“** einzelne Zusatzfelder innerhalb der Gruppe anlegen.

Zusatzfeldgruppe mit Zusatzfeldern

#### 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 * **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. * **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/tipps-zur-bedienung.md#zusatzliche-optionen-in-texteditoren). * **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 * **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**: Durch Aktivierung kann das Zusatzfeld bei der Erstellung und Bearbeitung von Selektionen verwendet werden (z. B. für das Anlegen von Filtern). * **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![](/files/yj2Z9eD7itQB8oCo7F1q)-Symbol kannst Du eine Zusatzfeldzeile löschen und mit diesem![](/files/GW5T0gRqOlnT0TQ43Ka0)-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 %} ### 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.

Anpassung von Größe und Position je Endgerät

{% 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. ### 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. Durch Aktivierung des Toggles **„Automatisches Anfügen“** können später individuelle Einträge direkt im Datensatz ergänzt werden (s. unten).
Nach dem Speichern gibst Du über **„+Eintrag“** die gewünschten Auswahlwerte ein und fügst diese Aufzählungsgruppe Deinem Zusatzfeld hinzu.

Aufzählungsgruppe für eine Mehrfachauswahl

#### Anwendungsbeispiele für einen Artikel #### Beispiel für eine Mehrfachauswahl
**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
**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“** --- # Agent Instructions: 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: ``` GET https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-allgemein/zusatzfelder.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.