eventoCondizioni di notifica
Questo evento viene notificato dal documento prima della gestione del riempimento di una lista valori di un campo di pannello a cui è stata associata una query value source basata su documenti.
Utilizzo consigliato
Questo evento può essere utilizzato per personalizzare la chiamata di caricamento della lista valori o qualora la richiesta composta dal framework sia errata o incompleta.
Argomenti
| Document | Documento tipo usato come fonte della lista valori. |
| Recordset | Oggetto recordset che è possibile riempire con le coppie codice-valore da visualizzare nel campo. |
| Skip | Parametro di output booleano. Se impostato a true indica al framework di non eseguire la procedura di recupero standard. |
| Url Path | Parte di URL che verrà appeso all'endpoint del servizio per effettuare la chiamata. |
| Parameters | Parametri che verranno inviati durante la chiamata. |
- Per riempire il recordset occorre utilizzare la procedura AddValueSourceRow dell'oggetto Recordset.
- Se non si specifica nulla, verrà eseguita una chiamata che seleziona il primo campo primary key come codice e il primo campo describe row come descrizione. Come filtri verranno impostate tutte le proprietà valorizzate del documento. L'ordinamento dei dati verrà espresso secondo l'ordinamento naturale dei documenti, ottenuto selezionando la prima proprietà che esprime il concetto di DO_SEQUENCE, DO_CODE, DO_DATE o DO_NAME nell'ordine.
- 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