Zahlenwert

Das Zahlenwert-Objekt dient zur strukturierten Erfassung numerischer Daten. Es ist die Grundlage für Berechnungen, Grenzwertprüfungen und dynamische Formularlogik.

Voraussetzungen vor dem Start

Vor der Konfiguration eines Zahlenwert-Feldes sollten folgende Punkte geklärt sein:

Berechtigungen: Zugriff auf Layout-Editor und Formularanpassung ist vorhanden.
Feldlogik: Es ist definiert, wofür das Feld fachlich genutzt wird (z. B. Menge, Zählerstand, Anzahl).
Datentyp: Es ist klar, ob Ganzzahlen oder Dezimalwerte benötigt werden.
Grenzwerte: Min-/Max-Bereiche sind bekannt, falls Plausibilitätsprüfungen nötig sind.
Testkontext: Änderungen werden vor dem Go-Live in einem Testformular geprüft.

Häufige Fragen

Wofür wird ein Zahlenwert typischerweise genutzt?

Für Mengen, Zählerstände, Laufzeiten, Temperaturen und alle numerischen Kennzahlen, die berechnet oder ausgewertet werden sollen.

Was ist bei Nachkommastellen wichtig?

Ganzzahlen eignen sich für Stückzahlen, Dezimalstellen für Messwerte wie Liter, Stunden oder Temperaturen.

Darf der Zuordnungsschlüssel später geändert werden?

Nein. Der technische Schlüssel sollte nach Inbetriebnahme nicht mehr geändert werden.

Kann ein Zahlenwert Folgefelder steuern?

Ja. Über Ausdrücke lassen sich Felder abhängig von Schwellenwerten ein- oder ausblenden.

Was passiert wenn ...?

... ungültige Werte eingegeben werden?

Das Feld akzeptiert nur numerische Eingaben. Nicht numerische Zeichen werden abgefangen.

... kein Standardwert gesetzt ist?

Berechnungen können mit leeren Werten fehleranfälliger werden. Ein Startwert wie 0 verbessert die Stabilität.

... Grenzwerte nicht definiert sind?

Unplausible Werte (z. B. negative Kilometerstände) können unbemerkt gespeichert werden.

... Ausdruck und Zuordnungsschlüssel nicht zusammenpassen?

Dann greift die Bedingung nicht korrekt und abhängige Logik reagiert nicht wie erwartet.

Funktionen des Zahlenwert-Objekts

Numerische Erfassung und Validierung:

Sicherstellung, dass nur gültige numerische Werte erfasst werden.
Grundlage für konsistente Datenqualität bei Auswertungen.

Berechnungsgrundlage:

Nutzung in Formeln für Summen, Differenzen, Durchschnitte und Laufzeiten.
Typische Beispiele: Personalstärken, Verbräuche, Zählerdifferenzen.

Dynamische Steuerung:

Einsatz als Trigger für Sichtbarkeit, Freigaben oder Warnhinweise.
Reaktion auf Schwellwerte über Ausdruckslogik.

Typische Anwendungsbeispiele

Logistik und Technik: Kilometerstände, Betriebsstunden, Füllmengen.
Personal: Teilnehmeranzahl, ausgegebene Verpflegungsportionen.
Einsatzstatistik: Anzahl eingesetzter Geräte oder verbrauchter Materialien.
Infrastruktur: Temperaturwerte, Prüffristen, Bestandsmengen.

Details:

Die Abbildung zeigt ein Zahlenwert-Feld in der Formularansicht mit aktivierter numerischer Eingabe.
Sichtbar sind Feldbezeichnung, Eingabebereich und das Verhalten bei numerischen Werten.
Diese Ansicht dient zur täglichen Erfassung von Mengen, Zählerständen oder Stückzahlen.
Typischer Fehler: Das Feld wird fachlich als Zahl genutzt, aber ohne passende Nachkommastellen oder Wertegrenzen konfiguriert.
So vermeiden: Vor dem Einsatz Nachkommastellen und Min/Max-Bereich mit der Fachseite abstimmen und im Testfall validieren.

Wichtige Parameter

Die folgenden Einstellungen sollten im Editor geprüft werden:

Anzeigetitel: Nutzerfreundliche Bezeichnung des Feldes, z. B. "Kilometerstand".
Zuordnungsschlüssel: Technischer Schlüssel für Speicherung und Ausdrücke.
Nachkommastellen: Festlegung auf Ganzzahl oder Dezimalwert.
Min/Max-Werte: Optionale Eingabegrenzen zur Vermeidung von Fehleingaben.
Standardwert: Initialwert beim Öffnen neuer Formulare, empfohlen 0.

Praxis-Tipp:

Nutzen Sie Zahlenwerte als Eingabefelder für Formeln, z. B. Stand_Beginn und Stand_Ende. Ein drittes Feld berechnet automatisch die Differenz.

Beispiel: Visuelle Warnung per Schwellwert

Wenn Werte ab einem Grenzwert hervorgehoben werden sollen, konfigurieren Sie eine Bedingung unter Daten > Ausdruck.

Abbildungs-Details:

Die Abbildung zeigt die Konfiguration eines Zahlenwert-Feldes im Editor, insbesondere den Bereich für Ausdruckslogik.
Sichtbar sind technische Parameter wie Zuordnungsschlüssel, Bedingungsausdruck und Darstellungsoptionen.
Diese Ansicht dient dazu, Schwellenwerte zu definieren und visuelle Warnungen bei Grenzwertüberschreitung zu steuern.
Typischer Fehler: Im Ausdruck wird ein falscher Feldname verwendet oder die Bedingung mit unpassenden Operatoren formuliert.
So vermeiden: Ausdruck mit dem exakten Zuordnungsschlüssel aufbauen, dann mit Testwerten unterhalb und oberhalb des Schwellwerts prüfen.

Beispiel mit Schlüssel iACCNR:

Ausdruck: [iACCNR] > 10
Logik: Bei Werten größer als 10 wird der Ausdruck als wahr gewertet.

Darstellung konfigurieren

Weisen Sie dem Zustand "Bedingung erfüllt" ein abweichendes Erscheinungsbild zu:

BackColor: z. B. Rot oder Hellrot.
ForeColor: z. B. Weiß für besseren Kontrast.
FontStyle: z. B. Bold für höhere Aufmerksamkeit.

Für den Normalzustand (Ausdruck = false) bleiben Standardfarben erhalten.

Mehrstufige Ampelanzeige

Für mehrere Schwellenstufen können Sie drei identische Zahlenwert-Felder verwenden, die sich über Sichtbarkeitsbedingungen ablösen.

Stufe 1 (Normal):

Ausdruck: [iACCNR] <= 5
BackColor: Green, ForeColor: White, FontStyle: Regular

Stufe 2 (Warnung):

Ausdruck: [iACCNR] > 5 UND [iACCNR] < 10
BackColor: Yellow, ForeColor: Black, FontStyle: Bold

Stufe 3 (Kritisch):

Ausdruck: [iACCNR] >= 10
BackColor: Red, ForeColor: White, FontStyle: Bold

Alle drei Felder erhalten denselben Anzeigetitel, damit die Ansicht für den Nutzer wie ein einziges dynamisches Feld wirkt.

Umsetzungsschritte im Editor

Zahlenwert-Feld anlegen und technische Basisparameter setzen.
Feld bei Bedarf zweimal duplizieren, um mehrere Warnstufen abzubilden.
Felder klar benennen, z. B. iACCNR_Stufe_Gruen, iACCNR_Stufe_Gelb, iACCNR_Stufe_Rot.
Pro Feld Ausdruck und Sichtbarkeit hinterlegen.
Positiven Zustand je Stufe optisch definieren, negativen Zustand als Standard belassen.
Standardwert setzen und die Konfiguration in Testszenarien prüfen.

Qualitätscheck

Numerik korrekt: Sind Eingaben als Ganzzahl/Dezimalwert wie gewünscht möglich?
Schlüssel stabil: Wurde der Zuordnungsschlüssel nicht nachträglich geändert?
Logik wirksam: Greifen Ausdrücke und Sichtbarkeitsregeln korrekt?
Darstellung eindeutig: Sind Warnstufen klar unterscheidbar?
Startwert gesetzt: Ist ein sinnvoller Standardwert (z. B. 0) hinterlegt?

Häufige Fehler und schnelle Lösung

Bedingung reagiert nicht: Ausdruck auf korrekten Zuordnungsschlüssel prüfen.
Falsche Werteformate: Nachkommastellen und Eingabegrenzen kontrollieren.
Warnung erscheint zu früh/spät: Vergleichsoperatoren (<, <=, >, >=) prüfen.
Uneinheitliche Darstellung: Appearance-Einstellungen der Stufen angleichen.

Go-Live-Check (Kurz)

[ ] Fachlogik und Grenzwerte abgestimmt
[ ] Zuordnungsschlüssel dokumentiert und fixiert
[ ] Ausdrücke inkl. Sichtbarkeit getestet
[ ] Warnfarben und Lesbarkeit geprüft
[ ] Stichprobe mit realen Eingaben erfolgreich