eventoCondizioni di notifica
Questo evento viene notificato ad un documento prima di caricare una collection del suo tipo. Se, ad esempio, si sta caricando la collection Righe del documento Ordine, allora l'evento viene notificato ad un'istanza del documento Riga. La procedura di caricamento delle collection, infatti, prima di caricare una collection crea un'istanza fittizia del documento che deve essere contenuto nella collection e lo usa per notificare il metodo. L'evento viene notificato nei seguenti casi:
- prima di caricare una collection tramite il metodo LoadCollectionByExample;
- prima di caricare una collection tramite il metodo LoadCollectionFromDB;
- quando pannelli o alberi DO caricano collection di documenti dal database.
Utilizzo consigliato
Questo evento viene utilizzato per personalizzare la procedura di caricamento della collection dal servizio qualora la richiesta composta dal framework sia errata o incompleta.
Argomenti
| Document | Documento tipo della collection. |
| Parent | È il documento padre che ha richiesto il caricamento della collection. Può essere Null Object se l'evento viene notificato dalla procedura LoadCollectionByExample. |
| Collection | Collection da caricare. |
| Skip | Parametro di output booleano. Se impostato a true, il caricamento standard non verrà effettuato. |
| Url Path | Parte di URL che verrà appeso all'endpoint del servizio per effettuare la chiamata. |
| Parameters | Parametri che verranno inviati durante la chiamata. |
- Se il parametro Parent è valorizzato, occorre usarlo per sapere quali documenti devono essere caricati nella collection.
- Se il parametro Parent NON è valorizzato, occorre verificare le proprietà dell'oggetto a cui viene notificato l'evento per determinare quali documenti caricare.
- Qualora il servizio richieda l'autenticazione OAuth e l'Access Token sia scaduto, il framework tenta di rinnovarlo automaticamente se è valorizzato anche il Refresh Token.
- Quando viene notificato questo evento, il framework ha già preparato la chiamata valorizzando opportunamente i parametri UrlPath e Parameters.
- Internamente verrà usata la funzione GetHTTP per effettuare la chiamata con la mappa dei parametri così com'è. Essa contiene già il parametro ID_HEADERS con gli header da aggiungere alla richiesta, tra cui l'header per l'autenticazione (
Authorization: Bearer AccessToken).
Ultima modifica: 15/11/2021 / Validità: da 13.1.5700