Konzept: Paginierung von WQL-Abfrageergebnissen
Wenn Sie eine Abfrage zum ersten Mal ausführen, wird die Workday Query Language (WQL) im Abfrageparameter ausgeführt und erstellt einen Cache, der maximal 10.000 Zeilen zurückgibt. Sie können auf zusätzliche Zeilen zugreifen, indem Sie mit durch den Ergebnissatz paginieren
limit
und offset
-Parameter im REST-API-Aufruf für Ihre WQL-Abfrage.WQL speichert Anforderungen für Seitenbeschränkungen nur für die Dauer einer Benutzersitzung im Cache.
Verwenden Sie folgende Parameter, um verbleibende Ergebnisse anzuzeigen:
Parameter | Beschreibung |
|---|---|
limit
| Gibt die Anzahl der Zeilen in einer Ergebnisseite an. Die Werte müssen zwischen 0 und 10.000 liegen. |
offset
| Gibt die Startzeile für den Ergebnissatz an. Wird verwendet von limit Parameter.
Lassen Sie in der Erstanforderung für die erste Ergebnisseite die folgenden Felder weg: offset Parameter oder setzen Sie ihn auf 0. |
Workday reserviert das Schlüsselwort
LIMIT
sowohl für eine -Klausel als auch für einen Paginierungsparameter. Das Schlüsselwort LIMIT unterscheidet nicht zwischen Groß- und Kleinschreibung. Wir verwenden Groß- und Kleinbuchstaben, um zwischen -Klausen und Paginierungsparametern zu unterscheiden.
- Verwenden SieLIMIT-Klausel, um die Anzahl der Gesamtanzahl der Zeilen zu begrenzen, die in einer Abfrageantwort zurückgegeben werden.
- Verwenden Sielimit-Parameter, um anzugeben, wie viele Zeilen pro Seite der Abfrageantwort angezeigt werden sollen.
Beispiele
Je nachdem, von wo aus Sie WQL-Anforderungen stellen, ist die von Ihnen verwendete Basis-URL unterschiedlich.
WQL-Anforderungsquelle
| Zu verwendende Basis-URL
|
|---|---|
Mandantendefinierter Workday-Host | https://{hostname}/api/wql/{version}/{tenant}
|
WCP-API-Gateway | https://api.workday.com/wql/{version}
|
So geben Sie 1.000 Zeilen zurück, beginnend mit der ersten Zeile des Ergebnissatzes:
{baseURL}/data?limit=1000&offset=0&query=select worker, location from allWorkers
Um die nächsten 1.000 Zeilen zurückzugeben, erhöhen Sie den Zeitversatz auf 1.000:
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers