Concept: paginering van resultaten WQL-query's
Wanneer u een query voor het eerst uitvoert, wordt de Workday Query Language (WQL) in de queryparameter uitgevoerd en wordt een cache gemaakt die maximaal 10.000 rijen retourneert. U kunt aanvullende rijen openen door de resultaat te pagineren met behulp van de
limit
andoffset
in de REST-API -aanroep voor uw WQL-query.WQL slaat aanvragen voor paginabeperkingen alleen op in de cache voor de duur van een sessie, tot een maximum van 30 minuten.
Gebruik deze parameters om de resterende resultaten weer te geven:
Parameter | Omschrijving |
|---|---|
limit
| Hiermee wordt het aantal rijen op één pagina met resultaten opgegeven. Waarden moeten tussen nul en 10.000 liggen. |
offset
| Hiermee wordt de beginrij voor de resultaat aangegeven. Gebruikt door limit parameter.
Laat in de eerste aanvraag voor de eerste pagina met resultaten de weg offset parameter of stel deze in op nul. |
Workday reserveert het trefwoord
LIMIT
voor zowel een component als een pagineringsparameter. Het trefwoord LIMIT is niet hoofdlettergevoelig. We gebruiken hoofdletters en kleine letters om onderscheid te maken tussen clausules en pagineringsparameters.
- De . gebruikenLIMITom het totaal aantal rijen dat in een queryantwoord wordt geretourneerd te beperken.
- De . gebruikenlimitom op te geven hoeveel rijen per pagina met queryantwoorden moeten worden weergegeven.
Voorbeelden
De basis-URL die u gebruikt, verschilt afhankelijk van waar u WQL-aanvragen indient.
WQL-aanvraagbron
| Te gebruiken basis-URL
|
|---|---|
tenanted Workday host | https://{hostname}/api/wql/{version}/{tenant}
|
API gateway WCP | https://api.workday.com/wql/{version}
|
Ga als volgt te werk om 1000 rijen te retourneren die beginnen met de eerste rij van de resultaat :
{baseURL}/data?limit=1000&offset=0&query=select worker, location from allWorkers
Als u de volgende 1.000 rijen wilt retourneren, verhoogt u de tegenboeking naar 1.000:
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers