funzioneScopo
Questa funzione esegue la procedura di validazione del documento e dei suoi sotto-documenti. Oltre che essere chiamata dal Visual Code, viene invocata dai pannelli DO quando l'utente modifica il documento e dalla funzione SaveToDB prima di salvare i dati.
La procedura di validazione ha lo scopo di verificare se lo stato del documento e dei suoi sotto-documenti è corretto ed eventualmente di segnalare gli errori. La validazione standard del documento prevede una validazione formale automatica delle proprietà del documento (obbligatorietà, lunghezza massima, tipo di dati) e la notifica dell'evento OnValidate al documento.
Sintassi
//
OK := Documento.Validate(ragione, numero livelli)
Argomenti
| Ragione | E' un parametro intero con valore di default zero che indica al documento per quale motivo viene validato. |
| Numero Livelli | E' un parametro opzionale intero con valore di default 9999 che indica quanti livelli di sotto-documenti devono essere validati. |
Valore di ritorno
Questa funzione torna True se il documento è corretto e non sono stati segnalati errori durante l'esecuzione della procedura di validazione nè da lui nè dai suoi sotto-documenti che sono stati validati.
- Quando l'utente modifica un dato in un pannello DO, il pannello scrive i nuovi dati nel documento e poi chiama la funzione Validate con Ragione = 1 e Numero Livelli = 0 per effettuare una validazione "veloce" del documento per vedere se l'utente sta inserendo dei dati corretti.
- Quando l'utente salva i dati modificati in un pannello DO, prima del salvataggio viene eseguita una validazione completa cioè con Ragione = 0 e Numero Livelli = 9999.
- La funzione SaveToDB normalmente esegue una rivalidazione completa del documento da salvare.
- E' possibile utilizzare da codice degli ulteriori numeri come Ragione per indicare all'evento OnValidate del documento di effettuare algoritimi di rivalidazione particolare solo in certi casi.
- Si consiglia di vedere le funzioni descritte nel capitolo Error Handling per maggiori informazioni sulla gestione degli errori nel documento.
Ultima modifica: 20/09/2021 / Validità: da 6.5.2680