---
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


---

# Now GraphQLServiceklasse: IOS

# Now GraphQLServiceklasse: IOS {#ariaid-title1}

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

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.
{#NowGraphQLServiceiOSAPI__table_vx2_klw_5pb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| konfigurieren | [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/m~vU6ffKznzmlhUz94FBmw#NowServiceConfigurationiOSStruct "Die Jetzt Servicekonfiguration Struktur definiert Konfigurationsinformationen für einen Funktionsservice.") | Konfigurationseinstellungen, die bei der Initialisierung des Service bereitgestellt wurden. |
[Tabelle : 1. Eigenschaften]

{#NowGraphQLServiceiOSAPI__table_vx2_klw_5pb}

## NowGraphQLService -- asynchrone Auslöse von Execute(query: GraphQLQuery) {#ariaid-title2}

Führt die angegebene GraphQL-Abfrage aus.
{#NGQLServ-execute-async_S__table_sfm_c4h_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Auszuführende GraphQL-Abfrage. |
[Tabelle : 2. Parameter]

{#NGQLServ-execute-async_S__table_sfm_c4h_ppb} {#NGQLServ-execute-async_S__table_tfm_c4h_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| Daten | Wird zurückgegeben, wenn die Methode erfolgreich ist. Abfragedaten, die aus der angegebenen Abfrage generiert wurden. |
| Jetzt Datenfehler | Wird ausgelöst, wenn die Methode fehlschlägt. * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NGQLServ-execute-async_S__NowDataErroriOS-ul-enum} |
[Tabelle : 3. Rückgaben]

{#NGQLServ-execute-async_S__table_tfm_c4h_ppb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    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
            }
          }
        }
      }
    }
    """

## NowGraphQLService -- EXECUTE(query: GraphQLQuery, Abschluss: @Escaping (Result\<Data, NowDataError\>)) {#ariaid-title3}

Führt die angegebene GraphQL-Abfrage aus.
{#NGQLServ-execute_S_O__table_sfm_c4h_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Auszuführende GraphQL-Abfrage. |
| Abschluss | @Escaping (Result\<Data, NowDataError\>) | Abschlusshandler, der nach Abschluss der Abfrage ausgeführt werden soll. Rückgabewerte: * Erfolg: Gibt Abfragedaten zurück. * Fehler: Now DataError {#NGQLServ-execute_S_O__ul_tst_1qh_ppb} |
[Tabelle : 4. Parameter]

{#NGQLServ-execute_S_O__table_sfm_c4h_ppb} {#NGQLServ-execute_S_O__table_tfm_c4h_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Rückgaben]

{#NGQLServ-execute_S_O__table_tfm_c4h_ppb}  
<br />

    gqlService.execute(GraphQLQuery(query: myQuery)) { result in 
      switch result { 
      case .success(let data): 
        // use data 
      case .failure(let error): 
        // handle error 
      } 
    }

## NowGraphQLService -- init(Konfiguration: NowServiceConfiguration, coreServiceProvider: NowCoreServiceProviding) {#ariaid-title4}

Erstellt einen NowGraphQLService basierend auf den angegebenen Parametern.
{#NGQLServ-init_O_O__table_k4t_mnh_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| konfigurieren | [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/m~vU6ffKznzmlhUz94FBmw#NowServiceConfigurationiOSStruct "Die Jetzt Servicekonfiguration Struktur definiert Konfigurationsinformationen für einen Funktionsservice.") | Konfigurationsparameter, die bei der Initialisierung des Service verwendet werden sollen, z. B. die Paket-ID der Anwendung, die in den Service integriert wird, und die URL von ServiceNowInstanz, auf die der NowGraphQLService zugreifen möchte. |
| CoreServiceanbieter | Jetzt CoreServicebereitstellung | Optional. Core-Service Provider. Hinweis: Derzeit ist dieser Parameter erforderlich, auch wenn er als optional angezeigt wird. Standard: Null |
[Tabelle : 6. Parameter]

{#NGQLServ-init_O_O__table_k4t_mnh_ppb}  
<br />

```

```

## NowGraphQLService -- Herausgeber (für Abfrage: GraphQLQuery) {#ariaid-title5}

Erstellt einen Herausgeber, um GraphQL-Daten anzufordern.
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NGQLServ-publisher_S__table_jsv_5wh_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Abfrage | GraphQLQuery | Auszuführende GraphQL-Abfragezeichenfolge. |
[Tabelle : 7. Parameter]

{#NGQLServ-publisher_S__table_jsv_5wh_ppb} {#NGQLServ-publisher_S__table_ksv_5wh_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyPublisher\<Data, NowDataError\> | Erfolg: GraphQL-Datensatz. Fehler: Now DataError |
[Tabelle : 8. Rückgaben]

{#NGQLServ-publisher_S__table_ksv_5wh_ppb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    private func fetchArticles() -> AnyPublisher<[Article], ArticleListError> {
      guard let graphQLService = graphQLService else {
        return Fail(error: .invalidGraphQLService).eraseToAnyPublisher()
      }
            
      return graphQLService.publisher(for: GraphQLQuery(query: recentlyPublishedQuery))
        .mapError({ dataError -> ArticleListError in
          .fetchError(dataError)
        })
        .flatMap(dataToArticleList)
        .eraseToAnyPublisher()
    }


