Concepto: paginación de resultados de consulta WQL
Cuando ejecuta una consulta por primera vez, el lenguaje de consulta de Workday (WQL) en el 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 resultados con el
limit
y offset
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.
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 entre cero y 10 000. |
offset
| Especifica la fila inicial del conjunto de resultados. Utilizado por el 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 usar
|
|---|---|
Host definido por Workday | https://{hostname}/api/wql/{version}/{tenant}
|
Pasarela de API de WCP | https://api.workday.com/wql/{version}
|
Para devolver 1000 filas a partir de la primera fila del conjunto de resultados:
{baseURL}/data?limit=1000&offset=0&query=select worker, location from allWorkers
Para devolver las siguientes 1000 filas, aumente el desplazamiento a 1000:
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers