flexi-input

Das Eingabefeld nimmt freie Text- oder Zahlenwerte entgegen. Je nach Konfiguration verhält es sich wie ein klassisches Textfeld, ein Zahlenfeld mit Einheit und Nachkommastellen oder als gesperrtes Anzeigefeld, das seinen Wert aus einer anderen Stelle des Dokuments übernimmt.

Einstellungen

Einstellung	Beschreibung
Bezeichnung	Der angezeigte Text über dem Feld
Name	Eindeutiger Bezeichner des Feldes (wird automatisch aus der Bezeichnung abgeleitet)
Eingabe deaktivieren	Sperrt das Eingabefeld, sodass es nicht bearbeitet werden kann
Abhängige Sperre	Sperre wird nur unter einer bestimmten Bedingung wirksam (siehe Eingabe deaktivieren)
Typ	Text für Freitext, Zahl für numerische Werte
Einheit	(Nur Typ Zahl) Optionale Einheit, die rechts neben dem Wert angezeigt wird (z. B. kg, °C, mm)
Auswahl der Einheit erlauben	(Nur Typ Zahl, mit Einheit) Erlaubt dem Anwender, die Einheit aus einer Liste zu wählen
Optionen	(Nur bei Auswahl der Einheit) Liste der verfügbaren Einheiten
Nachkommastellen aktiv	(Nur Typ Zahl) Begrenzt die Eingabe auf eine feste Anzahl Dezimalstellen
Nachkommastellen	(Nur Typ Zahl) Anzahl der zulässigen Dezimalstellen
Pflichtfeld	Wenn aktiv, muss das Feld ausgefüllt werden
Min	(Pflichtfeld) Mindestwert (Zahl) bzw. Mindestlänge (Text)
Max	(Pflichtfeld) Höchstwert (Zahl) bzw. Höchstlänge (Text)
Fehlertext	(Pflichtfeld) Meldung, die bei nicht erfüllter Pflicht angezeigt wird

Erweiterte Einstellungen

Einstellung	Beschreibung
Standardwert	Vorbelegung des Feldes beim Öffnen eines neuen Dokuments
Platzhalter	Hinweistext, der im leeren Feld angezeigt wird
Prüfungsregeln	Regeln zur Bewertung des eingetragenen Werts (siehe Abschnitt Validierungsregeln)
Lookup-Pfad	Pfad zu einem anderen Feld, dessen Wert automatisch übernommen wird
Lookup-Wert	(Bei Lookup auf eine Liste) Name des Eintrags, dessen Wert übernommen wird
Typeahead-Quelle	(Nur Typ Text) Datenliste, aus der Vorschläge während der Eingabe angeboten werden
Typeahead-Schlüsselwort	(Nur Typ Text) Spalte der Datenliste, aus der die Vorschläge stammen

Eingabetypen

Text

Nimmt beliebigen Text entgegen. Mit aktiviertem Pflichtfeld kann zusätzlich eine Mindest- und Höchstlänge verlangt werden.

Für Textfelder steht zusätzlich der Typeahead zur Verfügung: Während der Eingabe werden passende Einträge aus einer Datenliste vorgeschlagen. Neben dem Feld erscheint dann ein Statussymbol:

• Grünes Server-Symbol – der eingetragene Wert stammt aus der Datenliste
• Gelbes Hand-Symbol – der Wert wurde manuell eingegeben (kein Treffer in der Datenliste)

Zahl

Nimmt nur Zahlen entgegen. Zusätzliche Optionen:

• Einheit: Wird die Einheit aktiviert, erscheint sie rechts neben dem Eingabefeld. Sie hat keinen Einfluss auf den Wert selbst.
• Auswahl der Einheit erlauben: Statt einer fest hinterlegten Einheit kann der Anwender die Einheit aus der unter Optionen gepflegten Liste wählen.
• Nachkommastellen: Bei 0 sind nur ganze Zahlen erlaubt; bei höheren Werten wird die Eingabe auf die angegebene Anzahl Dezimalstellen begrenzt.

Mit aktiviertem Pflichtfeld kann zusätzlich ein Mindest- und Höchstwert verlangt werden.

Eingabe deaktivieren

Mit dieser Einstellung lässt sich das Feld sperren. Drei Varianten sind möglich:

Dauerhaft gesperrt – Ist nur Eingabe deaktivieren aktiv, kann das Feld nicht bearbeitet werden. Geeignet für Anzeigefelder, deren Wert über Standardwert oder Lookup gesetzt wird.

Abhängig von einem anderen Feld – Ist zusätzlich die abhängige Sperre aktiv, lässt sich festlegen, unter welcher Bedingung das Feld gesperrt sein soll:

Einstellung	Beschreibung
Abhängiges Feld	Name des Feldes, das geprüft wird. Für ein Feld im selben Abschnitt genügt der Name (auswahl); für ein Feld in einem anderen Abschnitt: abschnitt.feld
Vergleichswert	(Optional) Bestimmter Wert, den das abhängige Feld haben soll
Sperren wenn	Bedingung für die Sperre. Ohne Vergleichswert: Feld leer oder Feld gesetzt. Mit Vergleichswert: Wert stimmt überein oder Wert stimmt nicht überein

Ändert sich das abhängige Feld, wird die Sperre sofort neu ausgewertet.

Lookup

Mit einem Lookup übernimmt das Feld seinen Wert automatisch aus einer anderen Stelle des Dokuments. Das Feld wird dabei gesperrt — der Anwender kann den Wert nicht ändern.

Einstellung	Beschreibung
Lookup-Pfad	Pfad zum Quellfeld im Format abschnitt.feld oder kapitel.abschnitt.feld
Lookup-Wert	(Optional) Wenn der Lookup-Pfad auf eine Liste oder Tabelle zeigt, wird hier der Spalten- bzw. Eintragsname angegeben, dessen Wert übernommen werden soll

Standardwert

Der Standardwert wird beim Anlegen eines neuen Dokuments in das Feld geschrieben.

Beginnt der Standardwert mit $, wird er als Verweis auf ein Feld in einem anderen Kapitel ausgewertet — der dortige Wert wird beim Anlegen übernommen. Beispiel: $kapitel1.kopf.auftragsnummer.

Validierungsregeln

Über die erweiterten Einstellungen können Prüfungsregeln definiert werden. Wenn Regeln konfiguriert sind, zeigt das Feld ein Statussymbol:

• Grüner Haken – alle Regeln sind erfüllt
• Rotes Kreuz – mindestens eine Regel ist nicht erfüllt

flexi-input unterstützt — wenn der Eingabetyp Zahl ist — alle Regeln, die auch für andere Zahlenfelder gelten. Bei Eingabetyp Text sind im Wesentlichen die COMPONENT-Regeln nutzbar (Längenprüfungen anderer Felder).

Werteprüfung — VALUE (Zahl)

Vergleicht den eingetragenen Wert direkt gegen einen Grenzwert oder einen Toleranzbereich.

Regel	Bedeutung
VALUE>=100	Wert muss mindestens 100 sein
VALUE<=200	Wert darf höchstens 200 sein
VALUE<n	Wert muss strikt kleiner als n sein
VALUE==n	Wert muss genau n sein
VALUE!=n	Wert darf nicht n sein
VALUE>n	Aus historischen Gründen identisch mit VALUE>=n. Für einen strikten größer als stattdessen COMPARE:VALUE>n verwenden

Toleranzbereich

Regel	Bedeutung
VALUE%5:sollwert	Wert muss innerhalb von ± 5 % des Wertes von sollwert liegen
VALUE%MIN5:istwert	istwert darf nicht mehr als 5 % unter dem eigenen Wert liegen
VALUE%MAX5:istwert	istwert darf nicht mehr als 5 % über dem eigenen Wert liegen

Ist das Referenzfeld leer, wird die Regel übersprungen und das Feld als Leer markiert.

Vergleich — COMPARE (Zahl)

Vergleicht zwei Ausdrücke. VALUE steht für den eigenen Wert, andere Feldnamen werden direkt verwendet. Konstanten sowie + und - sind erlaubt. Innerhalb von COMPARE sind alle Operatoren strikt.

Regel	Bedeutung
COMPARE:VALUE>=sollwert	Eigener Wert muss mindestens dem sollwert entsprechen
COMPARE:VALUE<=(sollwert+5)	Eigener Wert darf sollwert + 5 nicht überschreiten
COMPARE:VALUE>=(sollwert-5)	Eigener Wert darf sollwert - 5 nicht unterschreiten
COMPARE:VALUE>n	Eigener Wert muss strikt größer als n sein
COMPARE:VALUE==sollwert	Eigener Wert muss exakt dem sollwert entsprechen
COMPARE:VALUE!=vorgabewert	Eigener Wert darf nicht dem vorgabewert entsprechen

Komponentenlänge — COMPONENT

Prüft, ob ein anderes Feld einen bestimmten Inhalt hat. Wirkt typischerweise als Alternative zu einer Werteprüfung — wenn das andere Feld ausgefüllt ist, gilt die Prüfung als erfüllt.

Regel	Bedeutung
COMPONENT:bemerkung.length>0	bemerkung enthält mindestens ein Zeichen
COMPONENT:bemerkung.length>10	bemerkung enthält mindestens 11 Zeichen

Beispiel: Toleranz oder Bemerkung erforderlich

"rules": [
  "VALUE%5:sollwert",
  "COMPONENT:bemerkung.length>0"
]

Der Wert liegt innerhalb ± 5 % vom Sollwert oder es ist eine Bemerkung eingetragen → OK.

Mehrere Regeln kombinieren

• Mehrere COMPARE-Regeln müssen alle erfüllt sein.
• Wird sowohl eine VALUE- als auch eine COMPARE-Regel hinterlegt, hat die COMPARE-Regel Vorrang.
• Werden mehrere VALUE-Regeln in einem Zahlenfeld hinterlegt, entscheidet die letzte über das Ergebnis. Für klare Prüfungen besser nur eine VALUE-Regel setzen und mit COMPARE oder COMPONENT ergänzen.

Eine vollständige Übersicht aller Regeln und ihrer Schreibweisen findet sich unter Prüfungsregeln.

Pflichtfeld vs. Validierungsregel

Pflichtfeld und Validierungsregeln wirken unabhängig voneinander:

• Das Pflichtfeld verhindert das Speichern bzw. die Freigabe, solange das Feld leer ist (oder die Mindest-/Höchstlänge bzw. der Mindest-/Höchstwert verletzt sind). Bei einer Verletzung erscheint der hinterlegte Fehlertext unter dem Feld.
• Validierungsregeln bewerten den eingetragenen Wert inhaltlich und werden über das Statussymbol (Haken/Kreuz) angezeigt. Ein leeres Feld wird hier als Leer behandelt und blockiert die Freigabe nicht.