Scopo
Questa proprietà rappresenta lo stato di inserimento di un documento.
Sintassi
Documento.Inserted := True
Quando letta
Restituisce True se il documento è in stato inserito, False altrimenti. Se il documento è in stato inserito significa che non esistono ancora i relativi record nel database e che, al momento del salvataggio, verranno generate query di Insert piuttosto che di Update.
Quando scritta
Imposta lo stato di inserimento del documento. Se il documento non ha gli eventi congelati, come spiegato nella proprietà FreezeEvents, allora la modifica di questa proprietà attiva la richiesta di un lock sul documento, inoltre dopo la modifica della proprietà viene notificato al documento l'evento di OnInserting. Per preparare un nuovo documento normalmente è meglio chiamare il metodo Init che, oltre alla proprietà Inserted, inizializza anche le proprietà pubbliche ai valori di default e notifica al documento che è in stato di preparazione tramite l'evento OnInit.
Esempio di codice
// Fired after this document is saved to DB
// ****************************************
event RigaOrdine.AfterSave()
{
if Inserted
{
La riga è stata appena inserita... aggiorno il resto del sistema informativo
{
}
}
}
- Questa proprietà viene spesso utilizzata negli eventi di BeforeSave e AfterSave per propagare l'informazione del salvataggio di un nuovo documento al resto del sistema.
- Si consiglia di vedere anche la documentazione relativa al metodo Init per vedere come preparare nuovi documenti per l'inserimento.
- Dopo aver duplicato un documento tramite il metodo Duplicate, la copia ha la proprietà Inserted a True.
Ultima modifica: 03/01/2022 / Validità: da 6.5.2680