Concetto: Impaginazione dei risultati delle query WQL
Quando si esegue una query per la prima volta, viene eseguito il Workday Query Language (WQL) nel parametro della query e viene creata una cache che restituisce un massimo di 10.000 righe. È possibile accedere a righe aggiuntive impaginando l'insieme risultato utilizzando
limit
eoffset
parametri nella chiamata API REST per la query WQL.WQL memorizza nella cache le richieste di limitazione delle pagine solo per la durata di una sessione utente , fino a un massimo di 30 minuti.
Per visualizzare i risultati rimanenti, utilizzare i seguenti parametri:
Parametro | Descrizione |
|---|---|
limit
| Specifica il numero di righe in una pagina di risultati. I valori devono essere compresi tra zero e 10.000. |
offset
| Specifica la riga iniziale per l'insieme risultato . Utilizzato da limit parametro.
Nella richiesta iniziale per la prima pagina dei risultati, omettere offset o impostarlo su zero. |
La parola chiave viene riservata
LIMIT
sia per una clausola che per un parametro di impaginazione. La parola chiave LIMIT non fa distinzione tra maiuscole e minuscole. Vengono utilizzate lettere maiuscole e minuscole per distinguere tra clausole e parametri di impaginazione.
- Utilizzare ilLIMITper limitare il numero totale di righe restituite in una risposta alla query.
- Utilizzare illimitper specificare il numero di righe da visualizzare per pagina di risposta alla query.
Esempi
A seconda della provenienza delle richieste WQL, l'URL di base utilizzato varia.
Origine richiesta WQL
| URL base da utilizzare
|
|---|---|
host definito nel tenant Workday | https://{hostname}/api/wql/{version}/{tenant}
|
Gateway API WCP | https://api.workday.com/wql/{version}
|
Per restituire 1.000 righe che iniziano con la prima riga dell'insieme di risultato :
{baseURL}/data?limit=1000&offset=0&query=select worker, location from allWorkers
Per restituire le 1.000 righe successive, aumentare l' spostamento a 1.000:
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers