Concept : pagination des résultats de requête WQL
Lorsque vous exécutez une requête pour la première fois, Workday Query Language (WQL), dans le paramètre de requête, s'exécute et crée un cache qui renvoie un maximum de 10 000 lignes. Vous pouvez accéder à des lignes supplémentaires en parcourant les ensembles de résultat à l'aide de
limit
etoffset
dans l'appel API REST pour votre requête WQL.WQL met en cache les demandes de restriction de page uniquement pour la durée de la session utilisateur , dans la limite de 30 minutes maximum.
Pour afficher les résultats restants, utilisez les paramètres suivants :
Paramètre | Description |
|---|---|
limit
| Indique le nombre de lignes dans 1 page de résultats. Les valeurs doivent être comprises entre zéro et 10 000. |
offset
| Indique la ligne de début de l'ensemble de résultat . Utilisé par le limit Paramètre .
Dans la demande initiale pour la première page des résultats, omettez les offset paramètre ou définissez-le sur zéro. |
Workday réserve le mot-clé
LIMIT
pour une clause et un paramètre de pagination. Le mot-clé LIMIT n'est pas sensible à la casse. - Utilisez leLIMITclause pour limiter le nombre total de lignes renvoyées dans une réponse à une requête.
- Utilisez lelimitpour indiquer le nombre de lignes à afficher par page de réponse à la requête.
Exemples
Selon l'endroit où vous effectuez des demandes WQL, l'URL de base que vous utilisez diffère.
Source de la demande WQL
| URL de base à utiliser
|
|---|---|
défini par l'environnement client / défini dans l'environnement client hôte Workday | https://{hostname}/api/wql/{version}/{tenant}
|
WCP API Gateway | https://api.workday.com/wql/{version}
|
Pour renvoyer 1 000 lignes en commençant par la première ligne de l'ensemble de résultat :
{baseURL}/data?limit=1000&offset=0&query=select worker, location from allWorkers
Pour renvoyer les 1 000 lignes suivantes, augmentez le contrepartie à 1 000 :
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers