---
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 CoreService-Klasse: IOS

# Now CoreService-Klasse: IOS {#ariaid-title1}

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

Die Jetzt CoreService Klasse stellt grundlegende Services für die verschiedenen SDK-Funktionsservices bereit. Diese Klasse darf nur von Now SDK instanziiert werden.

Funktionsservices wie Now Analytics und NowChat können über die Eigenschaft „NowSDK.Core" auf eine freigegebene Core-Instanz zugreifen.

## NowCoreService -- AccessTokenDidFail (für Service: NowService) {#ariaid-title2}

Benachrichtigt den SDK-Kern über das Zugriffstoken, das zum Autorisieren der API-Anforderungen an verwendet wird ServiceNowInstanz für den angegebenen Service ist nicht mehr gültig.
Der SDK-Kern gibt ein gültiges Zugriffstoken zurück, wenn er eines generieren kann, oder gibt einen Fehler zurück.  
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NCoreServ-accessTokenDidFail_O__table_p5n_vcb_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | [Now Service](https://servicenow-prod.fluidtopics.net/oubz3kQEejS2UcH5XbjbkQ#NowServiceiOSProtocol "Die Now Service das protokoll bietet eine einzige Schnittstelle zum Now SDK für alle Funktionsservices. Definiert die Konfigurationsparameter, die für den Zugriff auf erforderlich sind ServiceNowInstanz.") | Funktionsservice, der das Zugriffstoken anfordert. |
[Tabelle : 1. Parameter]

{#NCoreServ-accessTokenDidFail_O__table_p5n_vcb_npb} {#NCoreServ-accessTokenDidFail_O__table_q5n_vcb_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyPublisher\<NowSDK.AccessToken, AccessTokenProviderError\> | Erfolg: Gültiges Zugriffstoken. Fehler: AccessTokenProviderError Mögliche Werte: * UserSessionError * AccessTokenRetrievalFehlgeschlagen * HostReturnedNoTokens: Gibt einen Gastanwender an |
[Tabelle : 2. Rückgaben]

{#NCoreServ-accessTokenDidFail_O__table_q5n_vcb_npb}  
<br />

    NowSDK.core()?.accessTokenDidFail(for: someService)
      .mapError { YourCustomError.accessTokenFailed($0) }

    .flatMap(self.handleFailedAccessToken())
      .eraseToAnyPublisher()

## Now CoreService -- asynchrone Auslöse durch AccessTokenDidFail (für Service: NowService) {#ariaid-title3}

Benachrichtigt den SDK-Kern über das Zugriffstoken, das zum Autorisieren der API-Anforderungen an verwendet wird ServiceNowInstanz für den angegebenen Service ist nicht mehr gültig.
Der SDK-Kern gibt ein gültiges Zugriffstoken zurück, wenn er eines generieren kann, oder gibt einen Fehler zurück.
{#NCoreServ-accessTokDidFail-async_O__table_p5n_vcb_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | [Now Service](https://servicenow-prod.fluidtopics.net/oubz3kQEejS2UcH5XbjbkQ#NowServiceiOSProtocol "Die Now Service das protokoll bietet eine einzige Schnittstelle zum Now SDK für alle Funktionsservices. Definiert die Konfigurationsparameter, die für den Zugriff auf erforderlich sind ServiceNowInstanz.") | Funktionsservice, der das Zugriffstoken anfordert. |
[Tabelle : 3. Parameter]

{#NCoreServ-accessTokDidFail-async_O__table_p5n_vcb_npb} {#NCoreServ-accessTokDidFail-async_O__table_q5n_vcb_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| NowSDK.Zugriffstoken | Wird zurückgegeben, wenn die Methode erfolgreich ist. Gültiges Zugriffstoken. |
| AccessTokenProviderError | Wird ausgelöst, wenn die Methode fehlschlägt. Gibt einen Fehler beim Abrufen eines Zugriffstoken an. Mögliche Werte: * UserSessionError * AccessTokenRetrievalFehlgeschlagen * HostReturnedNoTokens: Gibt einen Gastanwender an |
[Tabelle : 4. Rückgaben]

{#NCoreServ-accessTokDidFail-async_O__table_q5n_vcb_npb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    do {
        let accessToken = try await NowSDK.core()?.accessTokenDidFail(for: someService)
    } catch {
        self.handleFailedAccessToken(error)
    }

## NowCoreService -- canRequestPermission(_-Berechtigung: DevicePermission) {#ariaid-title4}

Fragt die Hostanwendung ab, ob der Service die Geräteberechtigung anfordern darf.
Diese Funktion fordert die Berechtigung nicht an, nur ob die Geräteberechtigung abgefragt werden darf. Funktionsservices sollten diese Funktion aufrufen, um zu bestimmen, ob sie eine gewünschte Geräteberechtigung anfordern dürfen.
{#NCoreServ-canReqPermission_S__table_t4p_c1b_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Berechtigung | Geräteberechtigung | Gerät, für das die Anforderung gestellt wird. Mögliche Werte (Groß-/Kleinschreibung beachten): * Kamera * location * Mikrofon * Fotobibliothek * Spracherkennung |
[Tabelle : 5. Parameter]

{#NCoreServ-canReqPermission_S__table_t4p_c1b_npb} {#NCoreServ-canReqPermission_S__table_u4p_c1b_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Hostanwendung dem SDK erlaubt, die angegebene Geräteberechtigung anzufordern. Mögliche Werte: * Wahr: Geräteberechtigung kann angefordert werden. * Falsch: Geräteberechtigung kann nicht angefordert werden. |
[Tabelle : 6. Rückgaben]

{#NCoreServ-canReqPermission_S__table_u4p_c1b_npb}  
<br />

    extension AppDelegate: DevicePermissionDelegate {
      func canRequestPermission(_ permission: DevicePermission) -> Bool {
        return true
      }
    }

## NowCoreService: Asynchron isGuestUser (für Service: NowService) {#ariaid-title5}

Überprüft, ob der aktuelle Anwender ein Gastanwender ist.
{#NCoreServ-isGuestUser-async_O__table_ugj_4w2_lxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | Now Service | Funktionsservice, für den die Gastanwenderprüfung durchgeführt werden soll. |
[Tabelle : 7. Parameter]

{#NCoreServ-isGuestUser-async_O__table_ugj_4w2_lxb} {#NCoreServ-isGuestUser-async_O__table_vgj_4w2_lxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der aktuelle Anwender ein Gastanwender ist. Mögliche Werte: * Wahr: Der aktuelle Anwender des angegebenen Service ist ein Gastanwender. * Falsch: Der aktuelle Anwender des angegebenen Service ist kein Gastanwender. |
[Tabelle : 8. Rückgaben]

{#NCoreServ-isGuestUser-async_O__table_vgj_4w2_lxb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    let isGuestUser = await NowSDK.core()?.isGuestUser(for: someService)

## Now CoreService -- refreshAllSettings() {#ariaid-title6}

Aktualisiert alle SDK-Einstellungen für alle Services, indem sie von den aktiven Servern erneut abgerufen werden.
Um aktualisierte SDK-Einstellungswerte zu erhalten, wenn sie aktualisiert werden, abonnieren Sie den von bereitgestellten Herausgeber [NowCoreService -- settingsPublisher (für Service: NowService)](https://servicenow-prod.fluidtopics.net/MZq3GkOUSubw2h62JuXUvA#NCoreServ-settingsPublisher_O "Ruft die Einstellungen für den Herausgeber des angegebenen Service ab.")Funktion.
{#NCoreServ-refreshAllSettings__table_ckb_zgb_npb__entry__3}

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

{#NCoreServ-refreshAllSettings__table_ckb_zgb_npb} {#NCoreServ-refreshAllSettings__table_dkb_zgb_npb__entry__2}

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

{#NCoreServ-refreshAllSettings__table_dkb_zgb_npb}  
<br />

    NowSDK.core()?.refreshAllSettings()

## NowCoreService -- Aktualisierungseinstellungen (für Service: NowService) {#ariaid-title7}

Aktualisiert die SDK-Einstellungen für den angegebenen Service, indem sie erneut vom Server abgerufen werden.
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NCoreServ-refreshSettings_S__table_qv3_knb_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | Now Service | Funktionsservice, z. B. NowChat oder NowAnalytics, der die Aktualisierung der Einstellungen anfordert. |
[Tabelle : 11. Parameter]

{#NCoreServ-refreshSettings_S__table_qv3_knb_npb} {#NCoreServ-refreshSettings_S__table_rv3_knb_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyPublisher\<Settings, SettingsError\> | Erfolg: Wörterbuch der aktualisierten SDK-Einstellungen. Funktionsservices müssen die zurückgegebenen Daten auf die Einstellungen überprüfen, die für ihre spezifischen Funktionen relevant sind. Fehler: Einstellungsfehler: Typ und Beschreibung des aufgetretenen Fehlers. Mögliche Werte: * Abruffehler * Abrufen fehlgeschlagen * InvalidJSON * Ungültiger Anbieter * Nicht autorisiert * SdkNichtlizenziert * Settingnicht gefunden * unbekannt |
[Tabelle : 12. Rückgaben]

{#NCoreServ-refreshSettings_S__table_rv3_knb_npb}  
<br />

    var subscriptions = Set<AnyCancellable>()
    NowSDK.core?.refreshSettings(for: someService)
      .sink(receiveCompletion: { completion in
        if case .failure(let error) = completion {
          print("Refresh failed with error:\ (error)")
        }
      }, receiveValue: { settings in
        print("Received refreshed settings:\ (settings)")
      })
      .store(in: &subscriptions)

## NowCoreService: Asynchrone Auslöse für Aktualisierungseinstellungen (für Service: NowService) {#ariaid-title8}

Aktualisiert die SDK-Einstellungen für den angegebenen Service, indem sie erneut vom Server abgerufen werden.
{#NCoreServ-refreshSettings-async_S__table_qv3_knb_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | Now Service | Funktionsservice, z. B. NowChat oder NowAnalytics, der die Aktualisierung der Einstellungen anfordert. |
[Tabelle : 13. Parameter]

{#NCoreServ-refreshSettings-async_S__table_qv3_knb_npb} {#NCoreServ-refreshSettings-async_S__table_rv3_knb_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| Einstellungen | Wird zurückgegeben, wenn die Methode erfolgreich ist. Wörterbuch der aktualisierten SDK-Einstellungen. Funktionsservices müssen die zurückgegebenen Daten auf die Einstellungen überprüfen, die für ihre spezifischen Funktionen relevant sind. |
| Einstellungsfehler | Wird ausgelöst, wenn die Methode fehlschlägt. Mögliche Werte: * Abruffehler * Abrufen fehlgeschlagen * InvalidJSON * Ungültiger Anbieter * Nicht autorisiert * SdkNichtlizenziert * Settingnicht gefunden * unbekannt |
[Tabelle : 14. Rückgaben]

{#NCoreServ-refreshSettings-async_S__table_rv3_knb_npb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    do {
        let settings = try await NowSDK.core()?.refreshSettings(for: someService)
        print("Received refreshed settings: \(settings)")
    } catch {
        print("Refresh failed with Settings error: \(error)")
    }

## NowCoreService -- requestAccessToken (für Service: NowService) {#ariaid-title9}

Ruft ein Zugriffstoken für den angegebenen Service ab.
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NCoreServ-requestAccessToken_O__table_dt1_ftb_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | [Now Service](https://servicenow-prod.fluidtopics.net/oubz3kQEejS2UcH5XbjbkQ#NowServiceiOSProtocol "Die Now Service das protokoll bietet eine einzige Schnittstelle zum Now SDK für alle Funktionsservices. Definiert die Konfigurationsparameter, die für den Zugriff auf erforderlich sind ServiceNowInstanz.") | Funktionsservice, der das Zugriffstoken anfordert. |
[Tabelle : 15. Parameter]

{#NCoreServ-requestAccessToken_O__table_dt1_ftb_npb} {#NCoreServ-requestAccessToken_O__table_et1_ftb_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyPublisher\<NowSDK.AccessToken, AccessTokenProviderError\> | Erfolg: NowSDK.AccessToken: Zugriffstoken, das zum Autorisieren von API-Anforderungen an verwendet werden soll ServiceNowInstanz. Fehler: AccessTokenProviderError: Typ und Beschreibung des aufgetretenen Fehlers. Mögliche Werte: * AccessTokenRetrievalFehlgeschlagen * HostReturnedNoToken -- Gibt einen Gastanwender an * UserSessionError |
[Tabelle : 16. Rückgaben]

{#NCoreServ-requestAccessToken_O__table_et1_ftb_npb}  
<br />

    NowSDK.core()?.requestAccessToken(for: someService)

## NowCoreService: Asynchrone Auslöse für requestAccessToken (für Service: NowService) {#ariaid-title10}

Ruft ein Zugriffstoken für den angegebenen Service ab.
{#NCoreServ-requestAccessToken-async_O__table_dt1_ftb_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | [Now Service](https://servicenow-prod.fluidtopics.net/oubz3kQEejS2UcH5XbjbkQ#NowServiceiOSProtocol "Die Now Service das protokoll bietet eine einzige Schnittstelle zum Now SDK für alle Funktionsservices. Definiert die Konfigurationsparameter, die für den Zugriff auf erforderlich sind ServiceNowInstanz.") | Funktionsservice, der das Zugriffstoken anfordert. |
[Tabelle : 17. Parameter]

{#NCoreServ-requestAccessToken-async_O__table_dt1_ftb_npb} {#NCoreServ-requestAccessToken-async_O__table_et1_ftb_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| NowSDK.Zugriffstoken | Wird zurückgegeben, wenn die Methode erfolgreich ist. Zugriffstoken, das zum Autorisieren von API-Anforderungen an einen verwendet werden soll ServiceNowInstanz. |
| AccessTokenProviderError | Wird ausgelöst, wenn die Methode fehlschlägt. Gibt einen Fehler beim Abrufen eines Zugriffstoken an. Mögliche Werte: * AccessTokenRetrievalFehlgeschlagen * HostReturnedNoToken -- Gibt einen Gastanwender an * UserSessionError |
[Tabelle : 18. Rückgaben]

{#NCoreServ-requestAccessToken-async_O__table_et1_ftb_npb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    do {
        let accessToken = try await NowSDK.core()?.requestAccessToken(for: someService)
    } catch {
        self.handleFailedAccessToken(error)
    }

## NowCoreService -- requestNetworkService (für Service: NowService) {#ariaid-title11}

Gibt einen Verweis auf einen gemeinsam genutzten Netzwerkservice zurück, mit dem Sie API-Anforderungen stellen können.
Hinweis:  
Dies ist ein gemeinsam genutzter Service. Das Ändern von Einstellungen oder das Beenden der Sitzung kann zu Problemen bei anderen Funktionsservices führen, die diese Sitzung teilen.
{#NCoreServ-reqNetworkService_O__table_zmb_tpb_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | [Now Service](https://servicenow-prod.fluidtopics.net/oubz3kQEejS2UcH5XbjbkQ#NowServiceiOSProtocol "Die Now Service das protokoll bietet eine einzige Schnittstelle zum Now SDK für alle Funktionsservices. Definiert die Konfigurationsparameter, die für den Zugriff auf erforderlich sind ServiceNowInstanz.") | Funktionsservice, der den Netzwerkservice anfordert. |
[Tabelle : 19. Parameter]

{#NCoreServ-reqNetworkService_O__table_zmb_tpb_npb} {#NCoreServ-reqNetworkService_O__table_dkb_zgb_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| Netzwerkservice | Gemeinsam genutzter Netzwerkservice, den Sie zum Durchführen von API-Aufrufen verwenden können. |
[Tabelle : 20. Rückgaben]

{#NCoreServ-reqNetworkService_O__table_dkb_zgb_npb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    NowSDK.core()?.settingsPublisher(for: chatService)
    .sink(receiveCompletion: { completion in
      if case .failure(let error) = completion {
        // Setting publisher failed with error
      }
    }, receiveValue: { updatedSettings in
      // Receive array of SDK settings for chatService
    })
    .store(in: &subscriptions)

## NowCoreService -- requestSettings(forservice: NowService) {#ariaid-title12}

Gibt die SDK-Einstellungen für den angegebenen Funktionsservice zurück.
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NCoreServ-requestSettings_O__table_qwv_s5b_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | Now Service | Funktionsservice, der die Einstellungen anfordert. |
[Tabelle : 21. Parameter]

{#NCoreServ-requestSettings_O__table_qwv_s5b_npb} {#NCoreServ-requestSettings_O__table_rwv_s5b_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyPublisher\<Settings, SettingsError\> | Erfolg: Einstellungen: Array von SDK-Einstellungen für den angegebenen Funktionsservice. Fehler: Einstellungsfehler: Typ und Beschreibung des zugeordneten Fehlers. Mögliche Werte: * Abruffehler * Abrufen fehlgeschlagen * InvalidJSON * Ungültiger Anbieter * Nicht autorisiert * SdkNichtlizenziert * Settingnicht gefunden * unbekannt |
[Tabelle : 22. Rückgaben]

{#NCoreServ-requestSettings_O__table_rwv_s5b_npb}  
<br />

    NowSDK.core()?.requestSettings(for: someService)

## Now CoreService: Asynchrone Auslöse für „requestSettings" (für Service: NowService) {#ariaid-title13}

Gibt die SDK-Einstellungen für den angegebenen Funktionsservice zurück.
{#NCoreServ-requestSettings-async_O__table_qwv_s5b_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | Now Service | Funktionsservice, der die Einstellungen anfordert. |
[Tabelle : 23. Parameter]

{#NCoreServ-requestSettings-async_O__table_qwv_s5b_npb} {#NCoreServ-requestSettings-async_O__table_rwv_s5b_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| Einstellungen | Wird zurückgegeben, wenn die Methode erfolgreich ist. Array von SDK-Einstellungen für den angegebenen Funktionsservice. |
| Einstellungsfehler | Wird ausgelöst, wenn die Methode fehlschlägt. Typ und Beschreibung des zugeordneten Fehlers. Mögliche Werte: * Abruffehler * Abrufen fehlgeschlagen * InvalidJSON * Ungültiger Anbieter * Nicht autorisiert * SdkNichtlizenziert * Settingnicht gefunden * unbekannt |
[Tabelle : 24. Rückgaben]

{#NCoreServ-requestSettings-async_O__table_rwv_s5b_npb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    do {
        let settings = try await NowSDK.core()?.requestSettings(for: someService)
        print("Received settings: \(settings)")
    } catch {
        print("Refresh saved with Settings error: \(error)")
    }

## NowCoreService -- settingsPublisher (für Service: NowService) {#ariaid-title14}

Ruft die Einstellungen für den Herausgeber des angegebenen Service ab.
{#NCoreServ-settingsPublisher_O__table_jbw_j1c_npb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für Service | [Now Service-Protokoll: IOS](https://servicenow-prod.fluidtopics.net/oubz3kQEejS2UcH5XbjbkQ#NowServiceiOSProtocol "Die Now Service das protokoll bietet eine einzige Schnittstelle zum Now SDK für alle Funktionsservices. Definiert die Konfigurationsparameter, die für den Zugriff auf erforderlich sind ServiceNowInstanz.") | Funktionsservice, der das Herausgeberabonnement anfordert. |
[Tabelle : 25. Parameter]

{#NCoreServ-settingsPublisher_O__table_jbw_j1c_npb} {#NCoreServ-settingsPublisher_O__table_kbw_j1c_npb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyPublisher\<Settings, Never\> | Erfolg: Einstellungen: Array von SDK-Einstellungen für den angegebenen Funktionsservice. |
[Tabelle : 26. Rückgaben]

{#NCoreServ-settingsPublisher_O__table_kbw_j1c_npb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    NowSDK.core()?.settingsPublisher(for: chatService)
    .sink(receiveCompletion: { completion in
      if case .failure(let error) = completion {
        // Setting publisher failed with error
      }
    }, receiveValue: { updatedSettings in
      // Receive array of SDK settings for chatService
    })
    .store(in: &subscriptions)


