Concepto: paginación de resultados de consulta de WQL
Cuando ejecuta una consulta por primera vez, el lenguaje de consulta de Workday (WQL) del parámetro de consulta se ejecuta y crea una caché que devuelve un máximo de 10 000 filas. Puede acceder a filas adicionales paginando el conjunto de resultado con el
limit
yoffset
parámetros en la llamada a la API de REST para su consulta de WQL.WQL almacena en caché las solicitudes de limitación de página solo durante la duración de una sesión de usuario , hasta un máximo de 30 minutos.
Para consultar los resultados restantes, utilice los siguientes parámetros:
Parámetro | Descripción |
|---|---|
limit
| Especifica el número de filas en una página de resultados. Los valores deben estar comprendidos entre 0 y 10 000. |
offset
| Especifica la fila inicial del conjunto de resultado . Utilizada por limit parámetro
En la solicitud inicial de la primera página de resultados, omita el offset o defínalo como cero. |
Workday reserva la palabra clave
LIMIT
tanto para una cláusula como para un parámetro de paginación. La palabra clave LIMIT no distingue entre mayúsculas y minúsculas. Utilizamos mayúsculas y minúsculas para ayudar a diferenciar entre cláusulas y parámetros de paginación.
- Utilice elLIMITpara limitar el número de filas totales devueltas en una respuesta de consulta.
- Utilice ellimitpara especificar cuántas filas mostrar por página de respuesta a consulta.
Ejemplos
En función del lugar desde el que realice las solicitudes de WQL, la URL base que utilice será diferente.
Origen de solicitud de WQL
| URL base para utilizar
|
|---|---|
anfitrión definido por cliente Workday | https://{hostname}/api/wql/{version}/{tenant}
|
Pasarela de interfaz de programación de aplicaciones (API) de WCP | https://api.workday.com/wql/{version}
|
Para devolver 1000 filas a partir de la primera fila del conjunto de resultado :
{baseURL}/data?limit=1000&offset=0&query=select worker, location from allWorkers
Para devolver las siguientes 1000 filas, aumente el compensación a 1000:
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers