#Feldvalidierung

Um die Genauigkeit, Sicherheit und Konsistenz Ihrer Sammlungen zu gewährleisten, bietet NocoBase eine Funktion zur Feldvalidierung. Diese Funktion gliedert sich hauptsächlich in zwei Bereiche: die Konfiguration von Regeln und die Anwendung dieser Regeln.

#Regelkonfiguration

Die NocoBase Systemfelder integrieren Joi-Regeln. Die Unterstützung sieht wie folgt aus:

#String-Typ

Joi String-Typen entsprechen den folgenden NocoBase Feldtypen: Einzeiliger Text, Mehrzeiliger Text, Telefonnummer, E-Mail, URL, Passwort und UUID.

#Allgemeine Regeln

• Minimale Länge
• Maximale Länge
• Länge
• Regulärer Ausdruck
• Erforderlich

#E-Mail

Weitere Optionen anzeigen

#URL

Weitere Optionen anzeigen

#UUID

Weitere Optionen anzeigen

#Zahlentyp

Joi Zahlentypen entsprechen den folgenden NocoBase Feldtypen: Ganzzahl, Zahl und Prozentsatz.

#Allgemeine Regeln

• Größer als
• Kleiner als
• Maximalwert
• Minimalwert
• Vielfaches

#Ganzzahl

Zusätzlich zu den allgemeinen Regeln unterstützen Ganzzahlfelder zusätzlich die Ganzzahlvalidierung und die unsichere Ganzzahlvalidierung.

#Zahl & Prozentsatz

Zusätzlich zu den allgemeinen Regeln unterstützen Zahlen- und Prozentsatzfelder zusätzlich die Genauigkeitsvalidierung.

#Datumstyp

Joi Datumstypen entsprechen den folgenden NocoBase Feldtypen: Datum (mit Zeitzone), Datum (ohne Zeitzone), Nur Datum und Unix-Zeitstempel.

Unterstützte Validierungsregeln:

• Größer als
• Kleiner als
• Maximalwert
• Minimalwert
• Zeitstempel-Formatvalidierung
• Erforderlich

#Beziehungsfelder

Beziehungsfelder unterstützen lediglich die Pflichtfeldvalidierung. Beachten Sie bitte, dass die Pflichtfeldvalidierung für Beziehungsfelder derzeit in Szenarien mit Unterformularen oder Untertabellen nicht unterstützt wird.

#Anwendung von Validierungsregeln

Nachdem Sie Feldregeln konfiguriert haben, werden die entsprechenden Validierungsregeln beim Hinzufügen oder Ändern von Daten ausgelöst. Validierungsregeln gelten auch für Untertabellen- und Unterformular-Komponenten: Beachten Sie bitte, dass in Szenarien mit Unterformularen oder Untertabellen die Pflichtfeldvalidierung für Beziehungsfelder derzeit nicht wirksam ist.

#Unterschiede zur clientseitigen Feldvalidierung

Clientseitige und serverseitige Feldvalidierung eignen sich für unterschiedliche Anwendungsszenarien. Beide unterscheiden sich erheblich in ihrer Implementierung und im Zeitpunkt der Regelauslösung und müssen daher separat verwaltet werden.

#Unterschiede in der Konfigurationsmethode

• Clientseitige Validierung: Konfigurieren Sie Regeln in Bearbeitungsformularen (wie in der Abbildung unten gezeigt).
• Serverseitige Feldvalidierung: Legen Sie Feldregeln in der Datenquelle → Sammlungskonfiguration fest.

#Unterschiede im Zeitpunkt der Validierungsauslösung

• Clientseitige Validierung: Löst die Validierung in Echtzeit aus, während Benutzer Felder ausfüllen, und zeigt Fehlermeldungen sofort an.
• Serverseitige Feldvalidierung: Validiert serverseitig nach der Datenübermittlung, aber vor der Datenspeicherung. Fehlermeldungen werden über API-Antworten zurückgegeben.
• Anwendungsbereich: Die serverseitige Feldvalidierung wird nicht nur bei der Formularübermittlung wirksam, sondern auch in allen Szenarien, die das Hinzufügen oder Ändern von Daten betreffen, wie z. B. Workflows und Datenimporte.
• Fehlermeldungen: Die clientseitige Validierung unterstützt benutzerdefinierte Fehlermeldungen, während die serverseitige Validierung derzeit keine benutzerdefinierten Fehlermeldungen unterstützt.