Classe NowCoreService : iOS

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 7 minutes de lecture

    • La classe NowCoreService fournit des services fondamentaux aux différents services de fonctionnalité du SDK. Cette classe ne doit être instanciée que par NowSDK.

    Les services de fonctionnalités, tels que Now Analytics et NowChat, peuvent accéder à une instance principale partagée via la propriété NowSDK.core.

    NowCoreService : accessTokenDidFail(pour le service : NowService)

    Notifie le SDK Core 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 retourne un jeton d’accès valide s’il est capable d’en générer un ou renvoie une erreur.

    Remarque :
    Cette méthode a été déconseillée. 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(for service : NowService)

    Notifie le SDK Core 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 retourne 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.AccessToken Renvoyé en cas de réussite de la méthode. Jeton d’accès valide.
    AccessTokenProviderError Levée 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)

    Interroge l’application hôte pour savoir 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 de périphérique 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 de l’appareil spécifié.
    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 le 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 vedette 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 de tous les services en les récupérant à partir des serveurs actifs.

    Pour recevoir les valeurs de 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
    Aucun
    Tableau 10. Renvoie
    Type Description
    Aucun 

    NowSDK.core()?.refreshAllSettings()

    NowCoreService : refreshSettings(pour le service : NowService)

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

    Remarque :
    Cette méthode a été déconseillée. 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
    • Fournisseur invalide
    • notAuthorized
    • 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(for service : NowService) lèves asynchrones

    Actualise les paramètres SDK du service spécifié en les récupérant à nouveau à 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é en cas de réussite de la méthode. 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.
    SettingsError Levée en cas d’échec de la méthode.
    Valeurs possibles :
    • fetchError
    • fetchFailed
    • invalidJSON
    • Fournisseur invalide
    • notAuthorized
    • 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 a été déconseillée. 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 adressé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 : demandes asynchrones requestAccessToken(pour le service : NowService)

    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.AccessToken Renvoyé en cas de réussite de la méthode. Jeton d’accès à utiliser pour autoriser les demandes d’API adressées à une ServiceNow instance.
    AccessTokenProviderError Levée 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 le 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’arrêt 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 d’entité demandant le service réseau.
    Tableau 20. Renvoie
    Type Description
    Service réseau 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 du service de fonctionnalités spécifié.

    Remarque :
    Cette méthode a été déconseillée. 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 de fonctionnalités spécifié.

    Échec : SettingsError : type et description de l’erreur associée.

    Valeurs possibles :
    • fetchError
    • fetchFailed
    • invalidJSON
    • Fournisseur invalide
    • notAuthorized
    • sdkNotLicensed
    • settingNotFound
    • Inconnu
    		 

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

    NowCoreService : requestSettings(pour le service : NowService) lèves asynchrones

    Renvoie les paramètres SDK du 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é en cas de réussite de la méthode. Tableau des paramètres SDK pour le service de fonctionnalités spécifié.
    SettingsError Levée en cas d’échec de la méthode. Type et description de l’erreur associée.
    Valeurs possibles :
    • fetchError
    • fetchFailed
    • invalidJSON
    • Fournisseur invalide
    • notAuthorized
    • 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 de fonctionnalité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)