eventoCondizioni di notifica
Questo evento viene notificato dal pannello durante la gestione di ogni risposta del server una volta per ogni riga visibile del pannello se per tale riga è vera una delle seguenti condizioni:
- La riga è nuova ed è in fase di inserimento, cioè almeno un campo è stato modificato
- Uno dei campi della riga è in fase di errore, oppure è stato appena modificato
- La riga si trova in stato di errore.
Utilizzo consigliato
L'evento di OnValidateRow può essere utilizzato per validare o inizializzare i dati immessi dall'utente nel pannello, considerati a livello di riga intera. E' quindi analogo all'evento di OnUpdatingRow solo che scatta a livello di riga piuttosto che a livello di campo.
Argomenti
| Cancel | Non utilizzare questo argomento. Per segnalare una condizione di errore, utilizzare le funzioni SetErrorText del campo di pannello o del pannello stesso. |
Esempio di codice
// ******************************************
// Called to validate an updated row in panel
// ******************************************
event Ordini.Ordini.OnValidateRow(
inout boolean Cancel // Non usare!
)
{
// Controllo che la data di consegna non sia prima dell'ordine.
// N.B. potevo anche utilizzare un controllo a livello di DB e in
// questo caso non avrei dovuto effettuare questo controllo.
if Ordini.DataRichiestaOrdine < Ordini.DataOrdine
{
Ordini.SetErrorText(MSG Consegna Antecedente Ordine)
}
}
// Called to validate an updated row in panel
// ******************************************
event Ordini.Ordini.OnValidateRow(
inout boolean Cancel // Non usare!
)
{
// Controllo che la data di consegna non sia prima dell'ordine.
// N.B. potevo anche utilizzare un controllo a livello di DB e in
// questo caso non avrei dovuto effettuare questo controllo.
if Ordini.DataRichiestaOrdine < Ordini.DataOrdine
{
Ordini.SetErrorText(MSG Consegna Antecedente Ordine)
}
}
- Spesso è consigliabile utilizzare il solo evento di OnUpdatingRow per concentrare tutte le validazioni all'interno della stessa funzione.
- Nel caso di pannelli Document Oriented, non è consigliabile l'uso di questo evento, ma si devono preferire gli eventi di validazione a livello di documento.
- Questo evento può essere lanciato diverse volte nell'ambito della risposta del server al browser, per garantire che tutte le condizioni di notifica siano coperte. Per questo deve essere utilizzato in modalità stateless, e non dovrebbe contenere query o algoritmi complessi al suo interno.
- I dati della riga per cui viene chiamato l'evento possono essere letti e scritti utilizzando la tabella IMDB sottesa al pannello. Se si modificano i dati, essi verranno resi subito disponibili al pannello.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680