#Validazione dei Campi

Per garantire l'accuratezza, la sicurezza e la coerenza dei dati nelle collezioni, NocoBase offre la funzionalità di validazione dei campi. Questa funzionalità si divide principalmente in due parti: la configurazione delle regole e l'applicazione delle regole.

#Configurazione delle Regole

I campi di sistema di NocoBase integrano le regole di Joi, con il seguente supporto:

#Tipo Stringa

I tipi stringa di Joi corrispondono ai seguenti tipi di campo NocoBase: Testo a riga singola, Testo lungo, Numero di telefono, Email, URL, Password e UUID.

#Regole Comuni

• Lunghezza minima
• Lunghezza massima
• Lunghezza
• Pattern (Espressione regolare)
• Obbligatorio

#Email

Visualizza più opzioni

#URL

Visualizza più opzioni

#UUID

Visualizza più opzioni

#Tipo Numero

I tipi numerici di Joi corrispondono ai seguenti tipi di campo NocoBase: Intero, Numero e Percentuale.

#Regole Comuni

• Maggiore di
• Minore di
• Valore massimo
• Valore minimo
• Multiplo di

#Intero

Oltre alle regole comuni, i campi di tipo intero supportano anche la validazione di interi e la validazione di interi non sicuri.

#Numero e Percentuale

Oltre alle regole comuni, i campi di tipo numero e percentuale supportano anche la validazione della precisione.

#Tipo Data

I tipi data di Joi corrispondono ai seguenti tipi di campo NocoBase: Data (con fuso orario), Data (senza fuso orario), Solo data e Timestamp Unix.

Regole di validazione supportate:

• Maggiore di
• Minore di
• Valore massimo
• Valore minimo
• Formato timestamp
• Obbligatorio

#Campi di Relazione

I campi di relazione supportano solo la validazione "obbligatorio". Si noti che la validazione "obbligatorio" per i campi di relazione non è attualmente supportata negli scenari di sotto-form o sotto-tabella.

#Applicazione delle Regole di Validazione

Dopo aver configurato le regole per i campi, le regole di validazione corrispondenti verranno attivate quando si aggiungono o si modificano i dati.

Le regole di validazione si applicano anche ai componenti di sotto-tabella e sotto-form:

Si noti che negli scenari di sotto-form o sotto-tabella, la validazione "obbligatorio" per i campi di relazione non ha effetto.

#Differenze dalla Validazione dei Campi Lato Client

La validazione dei campi lato client e lato server si applicano a scenari d'uso diversi, presentando differenze significative nelle modalità di implementazione e nei tempi di attivazione delle regole. Per questo motivo, devono essere gestite separatamente.

#Differenze nel Metodo di Configurazione

• Validazione lato client: Si configurano le regole nei moduli di modifica (come mostrato nella figura seguente).
• Validazione dei campi lato server: Si impostano le regole dei campi in Fonte dati → Configurazione collezione.

#Differenze nei Tempi di Attivazione della Validazione

• Validazione lato client: Attiva la validazione in tempo reale mentre gli utenti compilano i campi e visualizza immediatamente i messaggi di errore.
• Validazione dei campi lato server: Dopo l'invio dei dati, il server esegue la validazione prima che i dati vengano memorizzati, e i messaggi di errore vengono restituiti tramite le risposte API.
• Ambito di applicazione: La validazione dei campi lato server non solo ha effetto durante l'invio dei moduli, ma si attiva anche in tutti gli scenari che comportano l'aggiunta o la modifica dei dati, come i flussi di lavoro e le importazioni di dati.
• Messaggi di errore: La validazione lato client supporta messaggi di errore personalizzati, mentre la validazione lato server attualmente non li supporta.