Scopo
Questa procedura carica il documento dal database, sfruttando anche una cache di documenti a livello di sessione web. Può essere utile se uno o più algoritmi utilizzano più volte gli stessi documenti; in questo modo infatti non è necessario caricarli sempre dal database ma vengono recuperati dalla cache in modo più veloce e senza far lavorare il database server.
Sintassi
Documento.LoadFromCache()
Argomenti
Questa procedura non ha argomenti. A differenza dalla LoadFromDB, che permette di scegliere se caricare i sotto-documenti o meno, qui nessun sotto-documento viene caricato. Se si desidera caricare i sotto-documenti è necessario chiamare la LoadFromDB dopo aver usato la LoadFromCache.- La ricerca del documento nella cache avviene per tutte le proprietà diverse da NULL oppure derivate da campi chiave del database. E' buona norma valorizzare le proprietà PK prima di chiamare questa procedura.
- Se il documento è già in cache, esso viene copiato dalla cache e la procedura finisce. Da notare che il documento è una copia di quello in cache e può quindi essere manipolato liberamente.
- Se il documento non è in cache viene notificato l'evento di BeforeLookup al documento, poi esso viene caricato dal database tramite una chiamata a LoadFromDB(0), ed infine viene notificato l'evento di AfterLookup. Al termine una copia del documento viene memorizzata nella cache dei documenti.
- Questa stessa procedura viene utilizzata in automatico dai pannelli DO per eseguire le query di decodifica DO.
- Qualora fosse necessario resettare la cache dei documenti per poter mostrare all'utente l'eventuale nuova versione salvata sul database, è possibile utilizzare il metodo di applicazione RefreshAllLookups.
Ultima modifica: 20/09/2021 / Validità: da 6.5.2680