funzioneScopo
Questa funzione ritorna True se il documento o uno dei suoi sotto-documenti è in stato modificato, cioè se è in stato Inserted, Updated o Deleted. E' spesso utilizzata nei cicli di salvataggio per sapere se il documento attuale è stato sottoposto a modifiche e quindi dovrà essere in qualche modo salvato.
Sintassi
boolean b = 0 // documento modificato?
//
b := Documento.IsModified(numero livelli)
//
b := Documento.IsModified(numero livelli)
Argomenti
| Numero Livelli | Parametro opzionale intero che indica il numero dei livelli dei documenti figli che devono essere controllati per le modifiche. Se lasciato vuoto verranno controllati tutti i documenti "figli". |
Valore di ritorno
Viene ritornato True se il documento o uno dei suoi sotto-documenti contenuti nelle sue collection, fino al livello di profondità indicato nel parametro Numero Livelli, è in stato Updated, Inserted o Deleted.
Esempio di codice
// ***********************************************************
// Fired by the validation procedure to validate this document
// ***********************************************************
event Ordine.OnValidate(
int Reason // Reason to validate
inout boolean Error // Set to TRUE to cancel validation
inout boolean Skip // Set to TRUE to skip internal validation
)
{
// Se l'ordine è stato modificato, non voglio che non abbia nemmeno una riga, a meno che non lo
// stia cancellando
if IsModified(??) AND NOT(IsDeleted()) AND Reason = ZERO
{
if RigheOrdini.Count() = ZERO
{
Error := True
this.AddDocumentError(MSG Almeno una riga)
}
}
}
// Fired by the validation procedure to validate this document
// ***********************************************************
event Ordine.OnValidate(
int Reason // Reason to validate
inout boolean Error // Set to TRUE to cancel validation
inout boolean Skip // Set to TRUE to skip internal validation
)
{
// Se l'ordine è stato modificato, non voglio che non abbia nemmeno una riga, a meno che non lo
// stia cancellando
if IsModified(??) AND NOT(IsDeleted()) AND Reason = ZERO
{
if RigheOrdini.Count() = ZERO
{
Error := True
this.AddDocumentError(MSG Almeno una riga)
}
}
}
- Mentre il metodo IsDeleted guarda i "padri" del documento attuale, IsModified guarda i sotto-documenti, cioè i documenti contenuti nelle collection del documento attuale.
Ultima modifica: 25/10/2016 / Validità: da 6.5.2680