Classe NowCoreService : iOS

NowCoreService : accessTokenDidFail(pour service : NowService)

Notifie le noyau du SDK que le jeton d’accès utilisé pour autoriser les demandes d’API à l’instance ServiceNow pour le service spécifié n’est plus valide.

Le SDK Core renvoie un jeton d’accès valide s’il est capable d’en générer un ou renvoie une erreur.

Remarque :

Cette méthode est obsolète. Vous devez plutôt utiliser l’implémentation async/await de la méthode.

Tableau 1. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité demandant le jeton d’accès.

Tableau 2. Renvoie
Type	Description
AnyPublisher<NowSDK.AccessToken, AccessTokenProviderError>	Réussite : jeton d’accès valide. Échec : AccessTokenProviderError Valeurs possibles : userSessionError accessTokenRetrievalFailed hostReturnedNoTokens : indique un utilisateur invité

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

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

NowCoreService : gnèves asynchrones accessTokenDidFail(pour service : NowService)

Notifie le noyau du SDK que le jeton d’accès utilisé pour autoriser les demandes d’API à l’instance ServiceNow pour le service spécifié n’est plus valide.

Le SDK Core renvoie un jeton d’accès valide s’il est capable d’en générer un ou renvoie une erreur.

Tableau 3. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité demandant le jeton d’accès.

Tableau 4. Renvoie
Type	Description
NowSDK.Jetond’accès	Renvoyé lorsque la méthode est efficace. Jeton d’accès valide.
AccessTokenProviderError	Lancé en cas d’échec de la méthode. Indique une erreur lors de la récupération d’un jeton d’accès. Valeurs possibles : userSessionError accessTokenRetrievalFailed hostReturnedNoTokens : indique un utilisateur invité

Les exemples de code suivants montrent comment appeler cette méthode.

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

NowCoreService : canRequestPermission(_ permission : DevicePermission)

Demande à l’application hôte si le service est autorisé à demander l’autorisation de l’appareil.

Cette fonction ne demande pas l’autorisation, mais seulement si elle est autorisée à interroger l’autorisation de l’appareil. Les services de fonctionnalités doivent appeler cette fonction pour déterminer s’ils sont autorisés à demander une autorisation d’appareil souhaitée.

Tableau 5. Paramètres
Nom	Type	Description
autorisation	Autorisation de l’appareil	Appareil pour lequel la demande est effectuée. Valeurs possibles (sensibles à la casse) : appareil photo Emplacement Microphone Photothèque speachRecognition

Tableau 6. Renvoie
Type	Description
Booléen	Marqueur indiquant si l’application hôte autorise le SDK à demander l’autorisation d’appareil spécifiée. Valeurs possibles : vrai : l’autorisation de l’appareil peut être demandée. faux : l’autorisation de l’appareil ne peut pas être demandée.

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

NowCoreService : isGuestUser(pour service : NowService) asynchrone

Vérifie si l’utilisateur actuel est un utilisateur invité.

Tableau 7. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité pour lequel effectuer la vérification de l’utilisateur invité.

Tableau 8. Renvoie
Type	Description
Booléen	Marqueur indiquant si l’utilisateur actuel est un utilisateur invité. Valeurs possibles : vrai : l’utilisateur actuel du service spécifié est un utilisateur invité. Faux : l’utilisateur actuel du service spécifié n’est pas un utilisateur invité.

L’exemple de code suivant montre comment appeler cette méthode.

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

NowCoreService : refreshAllSettings()

Actualise tous les paramètres SDK pour tous les services en les récupérant à partir des serveurs actifs.

Pour recevoir les valeurs des paramètres SDK mises à jour chaque fois qu’elles sont actualisées, abonnez-vous à l’éditeur fourni par la NowCoreService : settingsPublisher(pour le service : NowService) fonction.

Tableau 9. Paramètres
Nom	Type	Description
Néant

Tableau 10. Renvoie
Type	Description
Néant

NowSDK.core()?.refreshAllSettings()

NowCoreService : refreshSettings(pour service : NowService)

Actualise les paramètres SDK pour le service spécifié en les récupérant à partir du serveur.

Remarque :

Cette méthode est obsolète. Vous devez plutôt utiliser l’implémentation async/await de la méthode.

Tableau 11. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité, tel que NowChat ou NowAnalytics, demandant l’actualisation des paramètres.

Tableau 12. Renvoie
Type	Description
AnyPublisher<Settings, SettingsError>	Réussite : Dictionnaire des paramètres SDK actualisés. Les services d’entités doivent examiner les données renvoyées pour les paramètres pertinents pour leurs entités spécifiques. Échec : SettingsError : type et description de l’erreur rencontrée. Valeurs possibles : fetchError fetchFailed invalidJSON invalidProvider non autorisé sdkNotLicensed settingNotFound Inconnu

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 : refreshSettings(pour service : NowService) lève une asynchronisation

Actualise les paramètres SDK pour le service spécifié en les récupérant à partir du serveur.

Tableau 13. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité, tel que NowChat ou NowAnalytics, demandant l’actualisation des paramètres.

Tableau 14. Renvoie
Type	Description
Paramètres	Renvoyé lorsque la méthode est efficace. Dictionnaire des paramètres actualisés du SDK. Les services d’entités doivent examiner les données renvoyées pour les paramètres pertinents pour leurs entités spécifiques.
SettingsError	Lancé en cas d’échec de la méthode. Valeurs possibles : fetchError fetchFailed invalidJSON invalidProvider non autorisé sdkNotLicensed settingNotFound Inconnu

Les exemples de code suivants montrent comment appeler cette méthode.

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(pour le service : NowService)

Acquiert un jeton d’accès pour le service spécifié.

Remarque :

Cette méthode est obsolète. Vous devez plutôt utiliser l’implémentation async/await de la méthode.

Tableau 15. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité demandant le jeton d’accès.

Tableau 16. Renvoie
Type	Description
AnyPublisher<NowSDK.AccessToken, AccessTokenProviderError>	Réussite : NowSDK.AccessToken : jeton d’accès à utiliser pour autoriser les demandes d’API effectuées à une ServiceNow instance. Échec : AccessTokenProviderError : type et description de l’erreur rencontrée. Valeurs possibles : `accessTokenRetrievalFailed` `hostReturnedNoTokens` : indique un utilisateur invité `userSessionError`

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

NowCoreService : requestAccessToken(pour service : NowService) lèves asynchrones

Acquiert un jeton d’accès pour le service spécifié.

Tableau 17. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité demandant le jeton d’accès.

Tableau 18. Renvoie
Type	Description
NowSDK.Jetond’accès	Renvoyé lorsque la méthode est efficace. Jeton d’accès à utiliser pour autoriser les demandes d’API effectuées à une ServiceNow instance.
AccessTokenProviderError	Lancé en cas d’échec de la méthode. Indique une erreur lors de la récupération d’un jeton d’accès. Valeurs possibles : `accessTokenRetrievalFailed` `hostReturnedNoTokens` : indique un utilisateur invité `userSessionError`

Les exemples de code suivants montrent comment appeler cette méthode.

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

NowCoreService : requestNetworkService (pour service : NowService)

Renvoie une référence à un service réseau partagé que vous pouvez utiliser pour effectuer des demandes d’API.

Remarque :

Il s’agit d’un service partagé. La modification des paramètres ou l’interruption de la session peut entraîner des problèmes pour d’autres services de fonctionnalités qui partagent cette session.

Tableau 19. Paramètres
Nom	Type	Description
pour le service	NowService	Service de fonctionnalité demandant le service réseau.

Tableau 20. Renvoie
Type	Description
NetworkService (en anglais)	Service réseau partagé que vous pouvez utiliser pour effectuer des appels d’API.

L’exemple de code suivant montre comment appeler cette fonction.

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)

Renvoie les paramètres SDK pour le service de fonctionnalités spécifié.

Remarque :

Cette méthode est obsolète. Vous devez plutôt utiliser l’implémentation async/await de la méthode.

Tableau 21. Paramètres
Nom	Type	Description
pour le service	NowService	Service d’entités demandant les paramètres.

Tableau 22. Renvoie
Type	Description
AnyPublisher<Settings, SettingsError>	Réussite : paramètres : tableau des paramètres SDK pour le service d’entités spécifié. Échec : SettingsError : type et description de l’erreur associée. Valeurs possibles : fetchError fetchFailed invalidJSON invalidProvider non autorisé sdkNotLicensed settingNotFound Inconnu

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

NowCoreService : requestSettings(pour service : NowService) lève une vue asynchrone

Renvoie les paramètres SDK pour le service de fonctionnalités spécifié.

Tableau 23. Paramètres
Nom	Type	Description
pour le service	NowService	Service d’entités demandant les paramètres.

Tableau 24. Renvoie
Type	Description
Paramètres	Renvoyé lorsque la méthode est efficace. Tableau des paramètres SDK pour le service de fonctionnalités spécifié.
SettingsError	Lancé en cas d’échec de la méthode. Type et description de l’erreur associée. Valeurs possibles : fetchError fetchFailed invalidJSON invalidProvider non autorisé sdkNotLicensed settingNotFound Inconnu

Les exemples de code suivants montrent comment appeler cette méthode.

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

NowCoreService : settingsPublisher(pour le service : NowService)

Récupère les paramètres de l’éditeur du service spécifié.

Tableau 25. Paramètres
Nom	Type	Description
pour le service	Protocole NowService : iOS	Service de fonctionnalité demandant l’abonnement de l’éditeur.

Tableau 26. Renvoie
Type	Description
AnyPublisher<Settings, jamais>	Réussite : paramètres : tableau des paramètres SDK pour le service d’entités spécifié.

L’exemple de code suivant montre comment appeler cette fonction.

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)