Diese Dokumentation wurde automatisch von KI übersetzt.
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
URL
UUID
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.