Zum Inhalt

Attributvalidierung und Pflichtfelder#

Info

Ein Praxisbeispiel finden Sie auf unserem Blog

Wer die Eindeutigkeit von Attributen sicherstellen möchte oder bei der Pflege von bestimmten Feldern nur definierte Werte erwartet oder Felder zu Pflichtfeldern machen möchte, findet bei i-doit die entsprechenden Funktionen.

Überblick#

Folgende Anforderungen erfüllt die Validierung:

  • Festlegung vorgeschriebener Werte für einzelne Felder
  • Festlegung einer Eindeutigkeit des Feldwerts pro Objekt (Listen-Kategorie)/Objekttyp/Mandant (global)
  • Definition des Feldes als Pflichtfeld bei der Erzeugung eines neuen Objekts/Bearbeitung der Informationen

Konfiguration#

Du findest die Möglichkeit zur Festlegung dieser Einstellungen Verwaltung → Datenansicht → Attribut Einstellungen. Im Ausgangszustand werden einige vorgefertigte Attribute angezeigt. Sollte eine fehlen, kann dieses über Hinzufügen hinzugefügt werden.

attribute-validieren

Zuerst bekommst du die Möglichkeit die Sichtbarkeit des Attributs mit drei Auswahlmöglichkeiten einzustellen. Eine detaillierte Einsicht über diese Option findest du unter dem Artikel Attributsichtbarkeit

attribute-sichtbarkeit

Nun stehen die Attribute der Kategorie zur Konfiguration der Validierung bereit. Mit einem Haken im Kästchen Pflichtfeld kannst du eine Eingabe in dieses Feld durch die Benutzer voraussetzen. Es ist nicht möglich, die Kategorie zu speichern, wenn das Feld leer ist. Die Kennzeichnung in der Kategorie erfolgt über ein rotes Sternchen (*) neben der Bezeichnung des Attributs.

Weiterhin kannst du angeben, ob das Attribut in deiner IT-Dokumentation eindeutig sein muss, also maximal einmal vorhanden sein darf. Dies erfolgt über folgende Schaltflächen:

  • Eindeutig (pro Objekt): Diese Option steht nur in Listen-Kategorien (Multi-Value-Kategorien) zur Verfügung. Wenn du sie aktivierst, ist es innerhalb dieses Objekts nicht möglich, denselben Wert in zwei Einträgen dieser Kategorie wiederholt zu verwenden. Es ist jedoch möglich, den eingetragenen Wert in anderen Objekten erneut zu pflegen.
  • Eindeutig (pro Objekttyp): Wenn du die Option pro Objekttyp aktivierst, darf derselbe Wert nicht in einem weiteren Objekt dieses Typs vorhanden sein.
  • Eindeutig (Global): Der eingetragene Wert ist im gesamten Mandanten eindeutig und kann in diesem Attribut in keinem anderen Objekt erneut verwendet werden.

Sollte ein Wert für ein Feld bereits in Verwendung sein, wird der Benutzer durch einen Hinweis darüber informiert, dass die doppelte Verwendung dieses Wertes nicht möglich ist, wenn er den Eintrag speichern möchte.

attribut-muss

Die Auswahl Attribut muss steht dort zur Verfügung, wo nicht bereits eine Kategorie-interne Validierung besteht. Ein Datumsfeld ist beispielsweise generell nur in der Lage ein Datum aufzunehmen und zu speichern. Dialog-Plus-Felder lassen ausschließlich die festgelegten Werte zur Auswahl zu. Derartige Felder können daher nicht auf einen bestimmten Feldwert beschränkt werden.

Insofern keine Kategorie-interne Validierung vorliegt, kannst du entweder bestimmte Inhaltstypen festlegen, denen der Wert entsprechen muss oder eigene Textwerte vorgeben, aus denen die Anwender auswählen können.

Spezialfälle

Es gibt Kategorien, die bereits über eine interne Validierung verfügen, die sich weder abschalten, noch anpassen lässt. Beispielsweise wird in der Kategorie "Hostadresse" die Angabe einer IP-Adresse überprüft, ob sie entweder dem Standard für IPv4 oder IPv6 entspricht.

Falls du den Anwendern eigene Werte vorgibst, kannst du optional eine Drop-Down-Liste erzeugen, aus der die Anwender die Werte wählen können. So kann der Feldwert ausschließlich aus einer Liste ausgewählt werden, deren Inhalt nur in der Verwaltung in der Konfiguration der Validierung verändert werden kann.

validierung-dropdown

Wenn du alle Felder der Kategorie gemäß deiner Vorgaben konfiguriert hast, speichere die Einstellungen über die Schaltfläche Speichern. Wiederhole diese Schritte für alle Kategorien, in denen du Werte validieren und/oder als Pflichtfeld deklarieren möchtest.

Pro Kategorie, für die du eine Validierung anlegst, wird ein Bereich in der Konfiguration erzeugt. Diese Bereiche enthalten alle gesetzten Einstellungen. Solltest du eine Konfiguration einer Kategorie nicht länger benötigen, kannst du diese über das Entfernen/Mülleimer Symbol vollständig entfernen.

validierung-speichern

Vorsicht beim Entfernen

Wenn du die Konfiguration einer Kategorie entfernst, gehen die Attribut Einstellungen unwiderruflich verloren.

Validierungs-/Attributs-Cache erneuern#

In der Regel wird der Validierungs-/Attributs-Cache beim Anlegen einer neuen Konfiguration automatisch geleert. In seltenen Fällen kann es jedoch vorkommen, dass das System diese Aufgabe nicht übernimmt. Wenn du also feststellst, dass eine Attributskonfiguration in einer Kategorie nicht greift oder eine entfernte Validierung weiterhin aktiv zu sein scheint, leere den gesamten Cache unter Verwaltung > [Mandanten Name] Verwaltung > Systemreparatur und Bereinigung, damit das System die veränderten Einstellungen erkennt.

validierung-erneuern

Reguläre Ausdrücke testen#

Um reguläre Ausdrücke im Voraus zu überprüfen, verwenden Sie bitte Ihr bevorzugtes Testwerkzeug. Um die Syntax zu testen, verwenden Sie zum Beispiel regex101.