funzioneScopo
Questa funzione consente di recuperare il valore originale di una delle proprietà pubbliche del documento riferenziandola per indice.
Può quindi essere utile per controllare nelle fasi di validazione e salvataggio del documento se una determinata proprietà è stata cambiata ed agire di conseguenza.
Sintassi
string valore = "" // Valore Originale
//
valore := Doc.GetOriginalValue(indice proprietà)
//
valore := Doc.GetOriginalValue(indice proprietà)
Argomenti
| Indice Proprietà | E' un numero intero da 1 al numero di proprietà pubbliche del documento e indica quale proprietà deve essere ritornata. Se l'indice è al di fuori dei valori indicati si otterrà un eccezione. |
Valore di ritorno
Viene ritornato il valore originale della proprietà pubblica indicata del documento. Questa funzione definisce String come tipo del valore ritornato, tuttavia esso dipende dal tipo di proprietà referenziata: se ad esempio si richiede una proprietà intera, verrà ritornato un valore intero.
Esempio di codice
// ****************************************
// Fired after this document is saved to DB
// ****************************************
event Prodotto.AfterSave()
{
// Se ho cambiato il prezzo, allora aggiorno le righe ordine relative al prodotto
if PrezzoUnitario <> GetOriginalValue(ToPropertyIndex(PrezzoUnitario)) AND NOT(Deleted)
...
}
// Fired after this document is saved to DB
// ****************************************
event Prodotto.AfterSave()
{
// Se ho cambiato il prezzo, allora aggiorno le righe ordine relative al prodotto
if PrezzoUnitario <> GetOriginalValue(ToPropertyIndex(PrezzoUnitario)) AND NOT(Deleted)
...
}
- Il valore originale di una proprietà è quello ottenuto al momento del caricamento dal database. Se un documento non è stato caricato, ad esempio perchè deve essere inserito come nuovo, il valore originale è NULL.
- Tramite la procedura SetOriginal si può imporre che il valore originale delle proprietà sia uguale al valore attuale delle stesse.
- Normalmente l'indice della proprietà si ottiene tramite la funzione ToPropertyIndex oppure GetPropertyIndex.
Ultima modifica: 25/10/2016 / Validità: da 6.5.2680