---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Paginator-API -- iOS

# Paginator-API -- iOS {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die Klasse „Paginator" bietet Methoden zum Durchlaufen eines Datensatzes, der durch einen Aufruf der ServiceNow Tabellen -API über NowTableService zurückgegeben wird. Es handelt sich um das Objekt, das von den NowTableService- paginator()- Methoden zurückgegeben wird. Rufen Sie diese Methode nicht außerhalb dieser Umgebung auf.
{#PaginatorIOSAPI__table_vx2_klw_5pb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| hasNext | Boolean | Kennzeichnung, die angibt, ob eine nächste Seite abzurufen ist. Gültige Werte: * wahr: Nächste Seite ist verfügbar. * „falsch": Nächste Seite ist nicht verfügbar. |
| hatVorherige | Boolean | Kennzeichnung, die angibt, ob eine vorherige Seite abzurufen ist. Gültige Werte: * wahr: Vorherige Seite ist verfügbar. * „falsch": Vorherige Seite ist nicht verfügbar. |
| isBusy | Boolean | Kennzeichnung, die angibt, ob das Paginator-Objekt mit dem Abrufen von Daten ausgelastet ist. Gültige Werte: * „wahr": Herausgeber ist ausgelastet. * „falsch": Herausgeber ist nicht ausgelastet. |
| istFertig | Boolean | Kennzeichnung, die angibt, ob das Paginator-Objekt abgeschlossen ist. Wenn der Paginator zum Beenden konfiguriert ist, beendet der Herausgeber des Paginator-Objekts den Vorgang, wenn die letzte Seite abgerufen wurde. Ein Paginator-Objekt kann nach Abschluss keine Seiten mehr abrufen. Weitere Informationen finden Sie in der Beschreibung des Parameters publisherShouldFinish. Gültige Werte: * „wahr": Herausgeber ist abgeschlossen. * „falsch": Der Herausgeber ist nicht abgeschlossen. |
| itemProPage | Ganzzahl | Anzahl der pro Seite abzurufenden Elemente. Standard: 20 |
| AnzahlSeiten | Ganzzahl | Gesamtzahl der Seiten im Datensatzsatz. Wenn das Paginator-Objekt noch keine Seiten abgerufen hat, wird dieser Parameter auf `Int.max festgelegt`. Nachdem eine erste Anforderung an die Instanz ServiceNow gestellt wurde, wird die Anzahl der Seiten auf die tatsächliche Anzahl der von der Instanz ServiceNow empfangenen Seiten aktualisiert. |
| Seite | Ganzzahl | Aktuelle Seite im paginierten Datensatz. |
| publisher | Zeichenfolge | Herausgeber, der den Stream der paginierten Daten an die Abonnenten bereitstellt. Hinweis: Standardmäßig beendet der Herausgeber nicht. Um dieses Verhalten zu ändern, legen Sie die Eigenschaft publisherShouldFinish auf `true`fest. |
| HerausgeberSchuldenFinish | Boolean | Kennzeichnung, die angibt, ob der Herausgeber des Paginator-Objekts angehalten werden soll, wenn die letzte Seite abgerufen wurde. Ein Paginator-Objekt kann nach Abschluss keine Seiten mehr abrufen. Gültige Werte: * wahr: Sobald die letzte Seite abgerufen wurde, wird der Herausgeber von der Bereitstellung zusätzlicher Daten befreit. Die Methode „ reset() " funktioniert nicht mehr. * false: Der Herausgeber ist nie fertig und alle Methoden sind unabhängig von der Navigation voll funktionsfähig. Standardwert: false |
[Tabelle : 1. Eigenschaften]

{#PaginatorIOSAPI__table_vx2_klw_5pb}

## Paginator -- wird durch first() ausgelöst {#ariaid-title2}

Ruft die erste Seite der zurückgegebenen Ergebnisse ab.
Wenn diese Methode die erste Seite nicht abrufen kann, wird ein `PaginationError ausgelöst`.
{#Paginator-first__table_fpc_bgv_kqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 2. Parameter]

{#Paginator-first__table_fpc_bgv_kqb} {#Paginator-first__table_gpc_bgv_kqb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Ergebnisse]

{#Paginator-first__table_gpc_bgv_kqb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    class PaginatorTestViewModel<T: JSONRepresentable>: ObservableObject {
      @Published var result: Result<String, Error>?
      private let paginator: Paginator<T>
      private var subscriptions = Set<AnyCancellable>()

      init(paginator: Paginator<T>) {
        self.paginator = paginator
        subscribeToPaginator()
      }

      private func subscribeToPaginator() {
        paginator.publisher
          .receive(on: DispatchQueue.main)
          .sink { [weak self] comp in
            if case .failure(let error) = comp {
              self?.result = .failure(error)
            }
          } receiveValue: { [weak self] jsonRepresentable in
            self?.result = .success(jsonRepresentable.jsonDescription)
          }
          .store(in: &subscriptions)
      }

      func first() {
        result = nil
        do {
          try paginator.first()
        } catch {
          self.result = .failure(error)
        }
      }
    }

## Paginator -- last()-Auslösungen {#ariaid-title3}

Ruft die letzte Seite der zurückgegebenen Ergebnisse ab.
Wenn diese Methode die letzte Seite nicht abrufen kann, wird ein `PaginationError ausgelöst`.
{#Paginator-last__table_ipy_hgv_kqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 4. Parameter]

{#Paginator-last__table_ipy_hgv_kqb} {#Paginator-last__table_jpy_hgv_kqb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Ergebnisse]

{#Paginator-last__table_jpy_hgv_kqb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    ...
    func last() {
      result = nil
      do {
        try paginator.last()
      } catch {
        self.result = .failure(error)
      }
    }
    ...

## Paginator -- Next()-Auslöser {#ariaid-title4}

Ruft die nächste Seite der zurückgegebenen Ergebnisse ab.
Wenn keine weiteren Seiten abzurufen sind, löst die Methode einen `PaginationError`aus.
{#Paginator-next__table_kj5_5cv_kqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#Paginator-next__table_kj5_5cv_kqb} {#Paginator-next__table_lj5_5cv_kqb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Ergebnisse]

{#Paginator-next__table_lj5_5cv_kqb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    ...
    func next() {
      result = nil
      do {
        try paginator.next()
      } catch {
        self.result = .failure(error)
      }
    }
    ...

## Paginator -- previous()-Auslösungen {#ariaid-title5}

Ruft die vorherige Seite der zurückgegebenen Ergebnisse ab.
Wenn die Methode die vorherige Seite nicht abrufen kann, wird ein `PaginationError ausgelöst`.
{#Paginator-previous__table_lby_sfv_kqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 8. Parameter]

{#Paginator-previous__table_lby_sfv_kqb} {#Paginator-previous__table_mby_sfv_kqb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Ergebnisse]

{#Paginator-previous__table_mby_sfv_kqb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    ...
    func previous() {
      result = nil
      do {
        try paginator.previous()
      } catch {
        self.result = .failure(error)
      }
    }
    ...

## Paginator -- zurücksetzen () {#ariaid-title6}

Setzt den Paginator auf die erste Seite zurück, gibt jedoch nicht die erste Seite der zurückgegebenen Ergebnisse zurück.
{#Paginator-reset__table_u1y_mgv_kqb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 10. Parameter]

{#Paginator-reset__table_u1y_mgv_kqb} {#Paginator-reset__table_v1y_mgv_kqb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Ergebnisse]

{#Paginator-reset__table_v1y_mgv_kqb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    ...
    func reset() {
      result = nil
      paginator.reset()
    }
    ...