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 es wird ein Cache erstellt, der maximal 10.000 Zeilen zurückgibt. Sie können auf zusätzliche Zeilen zugreifen, indem Sie mithilfe von durch den Ergebnis paginieren
limit
undoffset
Parameter im REST-API -Aufruf für Ihre WQL-Abfrage.WQL speichert Anforderungen von Seitenbeschränkungen nur für die Dauer einer Sitzung im Cache von maximal 30 Minuten.
Um die verbleibenden Ergebnisse anzuzeigen, verwenden Sie die folgenden Parameter:
Parameter | Beschreibung |
|---|---|
limit
| Gibt die Anzahl der Zeilen auf einer Seite mit Ergebnissen an. Die Werte müssen zwischen 0 und 10.000 liegen. |
offset
| Gibt die Startzeile für den Ergebnis an. Wird verwendet von limit Parameter
Lassen Sie in der ersten Anforderung; Antrag für die erste Seite der Ergebnisse Folgendes 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, unterscheidet sich die von Ihnen verwendete Basis-URL.
WQL-Anforderungsquelle
| Zu verwendende Basis-URL
|
|---|---|
Von Workday mandantendefiniert Host | https://{hostname}/api/wql/{version}/{tenant}
|
WCP API (Application Programming Interface) Gateway | https://api.workday.com/wql/{version}
|
So geben Sie 1.000 Zeilen zurück, beginnend mit der ersten Zeile des Ergebnis :
{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 Gegenbuchung auf 1.000:
{baseURL}/data?limit=1000&offset=1000&query=select worker, location from allWorkers