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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Interagieren Sie mit Tabellendaten in einem ServiceNowInstanz

# Interagieren Sie mit Tabellendaten in einem ServiceNowInstanz {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

Die Mobile SDKErmöglicht Ihnen die Interaktion mit Daten in Tabellen, die sich auf befinden ServiceNowInstanz. Sie können mit diesen Daten über interagieren ServiceNowREST Tabelle API, die verwendet Now TableService() API, die direkt die REST-Schnittstelle oder über aufruft Now GraphQLService() API, die eine angegebene GraphQL-Abfrage für den REST ausführt GraphQL API.
Wenn Sie Daten aus mehreren Tabellen innerhalb eines einzigen Anrufs zurückgeben möchten, müssen Sie verwenden Now GraphQLService() API. Wenn Sie mit anderen interagieren müssen ServiceNowREST-APIs, siehe [Interagieren Sie mit der öffentlichen REST-API auf einem ServiceNowInstanz](https://servicenow-prod.fluidtopics.net/khn~GSAGu_zBDF4MmVd07A "Die Mobile SDKBietet Funktionen, mit denen iOS-Anwendungen die öffentliche REST-API auf aufrufen können ServiceNowInstanz.").

## Verwenden von NowGraphQLService zur Interaktion mit ServiceNowTabellen {#mobsdk-ios-interact_data_instance__section_kxm_wdf_hqb}

Die [Now GraphQLService](https://servicenow-prod.fluidtopics.net/DEbwT4qdVt6n1BRoRZ38Dw#NowGraphQLServiceiOSAPI "Die Now GraphQLService Die Klasse bietet Funktionen, mit denen Sie Anforderungen mithilfe von GraphQL-Abfragen für Daten auf stellen können ServiceNowInstanz über ITS GraphQL REST-API.")Die Klasse bietet Methoden, mit denen Sie GraphQL-Abfragen für eine angegebene Tabelle in erstellen und ausführen können ServiceNowInstanz, wenn der angemeldete Anwender über die richtige Autorisierung verfügt. Sie können alle CRUD-Vorgänge in Ihrer GraphQL-Abfrage definieren.  
Now GraphQLService Unterstützt das Abrufen von Ergebnissen für eine Abfrage durch Rückgabe eines Abschlusshandlers:

    func execute(_ query: GraphQLQuery, completion: @escaping (Result<Data, NowDataError>) → Void)

Durch asynchrone/warten:

    func execute(_ query: GraphQLQuery) async throws -> Data

Oder, A [Kombinieren](https://developer.apple.com/documentation/combine)Herausgeber (der derzeit veraltet ist):

    func publisher(for query: GraphQlQuery) → AnyPublisher<Data, NowDataError>

Das folgende Beispiel zeigt, wie Sie das NowData-Framework importieren und dann ein NowGraphQLService-Objekt initialisieren, das Sie dann für die Interaktion mit Tabellen in verwenden können ServiceNowInstanz.

    // Import the NowData framework
    import NowData

    // Initialize a NowGraphQLService
    // The makeGraphQLService completion handler returns a result that wraps 
    // the NowGraphQLService upon success or error. 

    private func initializeGraphQLService(instanceUrl: URL) {
      makeGraphQLService(instanceUrl: instanceUrl) { [weak self] result in
        switch result {
        case .success(let service):
          self?.graphQLService = service
        case .failure(let error):
          debugPrint("Creating GraphQL service failed with error: \(error.localizedDescription)")
          self?.graphQLService = nil
        }
      }
    }

Dieses Beispiel zeigt, wie eine asynchrone Funktion erstellt wird, die die zuletzt veröffentlichten KB-Artikel abruft und veröffentlicht.

    private func fetchArticles() async throws -> [Article] { 
        guard let graphQLService = graphQLService else { 
            throw ArticleListError.invalidGraphQLService 
        }         

        do {
            let data = try await graphQLService.execute(GraphQLQuery(query: recentlyPublishedQuery))
            let articles = try dataToArticleList(data)
        } catch let error as NowDataError {
            throw ArticleListError.fetchError(error)
        } catch {
            throw error
        }
    } 
      
    private let recentlyPublishedQuery = 
    """ 

    {
      GlideRecord_Query {
        kb_knowledge(queryConditions: "active=true^ORDERBYpublishedDESC" pagination: { limit: 10, offset: 0 }) {
          _results { 
            sys_id {
              value
            },
            number {
              displayValue
            },
            short_description {
              displayValue
            },
            author {
              displayValue
            }
            published {
              displayValue
            }
          }
        }
      }
    }
    """

## Verwenden von Now TableService für die Interaktion mit ServiceNowTabellen {#mobsdk-ios-interact_data_instance__section_fgn_gy2_hqb}

Die [Now TableService](https://servicenow-prod.fluidtopics.net/TZK7N9q1hgZLZdzO1Jn10w#NowTableServiceiOSAPI "Die Now TableService Die Klasse bietet Funktionen, mit denen Sie Erstellungs-, Lese-, Aktualisierungs- und Löschvorgänge für Datensätze vorhandener ausführen können ServiceNowTabellen.")Die Klasse bietet Methoden zum Ausführen von CRUD-Vorgängen für die Datensätze in Tabellen, die sich auf befinden ServiceNowInstanz. Über diese Schnittstelle können Sie direkt auf jeden der Datensätze in jedem zugreifen ServiceNowTabelle, für die der angemeldete Anwender berechtigt ist. Now TableService Unterstützt Dot-Walking für Referenzfelder. Beispiel: Wenn eine Tabelle einen Verweis auf die Anwendertabelle enthält, der Dot-Walking-Wert `user.name `Gibt den Namen des Anwenders zurück.

Bei der Rückgabe der angeforderten Daten werden alle anwendbaren Zugriffssteuerungslisten (ACLs) auf die Daten angewendet, was zu weniger Ergebnissen als erwartet oder Autorisierungsfehlern führen kann, wenn der authentifizierte Anwender keine Zugriffsrechte für die angegebene Tabelle hat.

Am Meisten Now TableService Methoden bieten drei Implementierungen für die Rückgabe von Ergebnisdaten. Eine, die asynchron/warten verwendet, eine, die einen Abschlusshandler mit einem aufruft ResultUnd eine Aufzählung, die einen zurückgibt [Kombinieren](https://developer.apple.com/documentation/combine)Herausgeber, der derzeit veraltet ist.

Beispiel: Alle CreateRecord() Methoden fügen einen erstellten Datensatz in eine angegebene Tabelle ein, jedoch die

[Now TableService -- createRecord(mit Feldern: [Fieldname: FieldValue], in tableName: Zeichenfolge, writeOptions: FieldWriteOptions, Konfiguration: FieldReadConfiguration, Abschluss: @Escaping (Ergebnis<Daten, jetzt Datenfehler>)](TZK7N9q1hgZLZdzO1Jn10w#NTblServ-createRecord_S_O_O_O "Fügt den angegebenen Datensatz in die angegebene Tabelle ein und führt dann aus completionHandler, nachdem der Datensatz gespeichert wurde.")

Methode ruft einen Abschlusshandler mit auf ResultAufzählung (die `.Erfolg `Fall enthält die Ergebnisse als zugeordneten Wert).

Die zugehörigen Listen namens
[Now TableService -- createRecord(mit Feldern: [Fieldname: FieldValue], in tableName: Zeichenfolge, writeOptions: FieldWriteOptions? = Nil, Konfiguration: FeldReadConfiguration? = Nil) asynchrone Auslöser](TZK7N9q1hgZLZdzO1Jn10w#NTblServ-createRecord-async_S_O_O "Fügt einen Datensatz in die angegebene Tabelle ein, der die angegebenen Felder enthält.")

Die Methode führt eine asynchrone/warten-Funktion aus. Während

[Now TableService -- createRecord(mit Feldern: [Fieldname: FieldValue], in tableName: Zeichenfolge, writeOptions: FieldWriteOptions? = Nil, Konfiguration: FeldReadConfiguration? = Null)](TZK7N9q1hgZLZdzO1Jn10w#NTblServ-createRecord_S_O_O "Fügt einen Datensatz in die angegebene Tabelle ein, der die angegebenen Felder enthält.")`
`

Methode gibt einen kombinierten Herausgeber zurück, ist jedoch derzeit veraltet.

Darüber hinaus Now TableService Stellt zwei verschiedene Implementierungen von CRUD-Methoden bereit, eine, die Rohdaten zurückgibt, und eine, die codierbare Modelle zurückgibt. Beispiel: Beide Aktualisieren () Und UpdateRecord() Methoden aktualisieren einen angegebenen Datensatz in einer angegebenen Tabelle, aber die Aktualisieren () Methoden geben ein codierbares Modell und zurück UpdateRecord() Methoden geben Rohdaten zurück. In einigen Fällen sind codierbare Methoden vorzuziehen, da eine stark typisierte codierbare Struktur mehr Flexibilität bietet als eine Sammlung von Rohdatenfeldern.  
Das folgende Beispiel zeigt, wie importiert wird Jetzt Daten Framework und initialisieren Sie dann ein NowTableService-Objekt, mit dem Sie dann interagieren können ServiceNowInstanztabellen.

    // Import the NowData framework
    import NowData

    // Initialize a NowTableService
    // The makeTableService completion handler returns a result that wraps 
    // the NowTableService upon success or error. 

    makeTableService(instanceUrl: instanceUrl) { [weak self] result in
      guard let self = self else { return }
      
      switch result {
      case .success(let tableService):
        debugPrint("Successfully created a table service \(tableService)")
        self.tableService = tableService
      case .failure(let error):
        debugPrint("Creating table service failed with error: \(error.localizedDescription)")
      }
    }

Für zusätzliche Codebeispiele mit der verfügbaren Now TableService Methoden, siehe [Now TableServiceklasse: IOS](https://servicenow-prod.fluidtopics.net/TZK7N9q1hgZLZdzO1Jn10w#NowTableServiceiOSAPI "Die Now TableService Die Klasse bietet Funktionen, mit denen Sie Erstellungs-, Lese-, Aktualisierungs- und Löschvorgänge für Datensätze vorhandener ausführen können ServiceNowTabellen.")` `API-Dokumentation.

