API NowWeb : iOS

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • L’API NowWeb est une API globale de niveau supérieur qui permet aux utilisateurs d’instancier une instance de service NowWeb.

    NowWeb : makeWebService(instanceUrl : URL) lève une asynchronisation

    Crée une instance de NowWebService à l’aide de la configuration spécifiée précédemment.

    Vous devez initialiser le SDK avant d’appeler cette fonction ou le bloc de complétion est appelé avec une erreur sdkNotConfigured . Pour initialiser le SDK, appelez NowSDK.configure() avec la configuration souhaitée.

    Tableau 1. Paramètres
    Nom Type Description
    instanceUrl URL URL de l’instance ServiceNow dont les services Web doivent être accessibles par le service.
    Tableau 2. Renvoie
    Type Description
    NowWebService En cas de réussite, renvoie un objet NowWebService initialisé.
    NowServiceError Lève l’une des erreurs suivantes en cas d’échec de la méthode.
    Valeurs possibles :
    • sdkNotConfigured
    • serviceConfigurationInvalid
    • serviceDisabled
    • serviceSettingsInvalid
    • serviceSettingsNotFound
    • serviceSettingsRetrievalFailed

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

    do {
    let service = try await NowWeb.makeWebService(instanceUrl: instanceUrl)
    self.webService = service
} catch {
    debugPrint("Web Service creation failed with error: \(error.localizedDescription)") 
}

    NowWeb : makeWebService(instanceUrl : URL, complétion : @escaping (Résultat<NowWebService, NowServiceError>) > Annulé))

    Crée une instance de NowWebService à l’aide de la configuration spécifiée précédemment. Lorsque vous avez terminé, appelle le gestionnaire d’achèvement spécifié.

    Vous devez initialiser le SDK avant d’appeler cette fonction ou le bloc de complétion est appelé avec une erreur sdkNotConfigured . Pour initialiser le SDK, appelez NowSDK.configure() avec la configuration souhaitée.

    Tableau 3. Paramètres
    Nom Type Description
    instanceUrl URL URL de l’instance ServiceNow dont les services Web doivent être accessibles par le service.
    Achèvement @escaping (Résultat<NowWebService, NowServiceError>) > Annulé) Gestionnaire d’achèvement appelé avec un résultat <NowWebService, NowServiceError> contenant soit une instance NowWebService initialisée, soit une erreur NowService, indiquant la raison de l’échec de l’initialisation.
    Tableau 4. Renvoie
    Type Description
    Néant 

    func initializeNowSDK(userEmail: String) {
  currentUser = userEmail
  let sdkConfig = NowSDKConfiguration(authorizationProvider: self, permissionDelegate: self, logLevel: .debug)
        
  do {
      try NowSDK.configure(with: sdkConfig)
      configureAnalytics()
  } catch {
      debugPrint("Could not initialize NowSDK. Error: \(error.localizedDescription)")
  }
}

    NowWeb : makeWebService(instanceUrl : URL)

    Crée une instance de NowWebService à l’aide de la configuration spécifiée précédemment.

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

    Vous devez initialiser le SDK avant d’appeler cette fonction ou le bloc de complétion est appelé avec une erreur sdkNotConfigured . Pour initialiser le SDK, appelez NowSDK.configure() avec la configuration souhaitée.

    Tableau 5. Paramètres
    Nom Type Description
    instanceUrl URL URL de l’instance ServiceNow dont les services Web doivent être accessibles par le service.
    Tableau 6. Renvoie
    Type Description
    AnyPublisher<NowWebService, NowServiceError> En cas de réussite, renvoie un objet NowWebService initialisé. En cas d’échec, renvoie un objet NowServiceError. 

    func initializeWebService() {
  NowWeb.makeWebService(instanceUrl: instanceUrl)
    .sink { completion in
      if case .failure(let error) = completion {
        debugPrint("Web Service creation failed with error: \(error.localizedDescription)")
      }
    } receiveValue: { [weak self] service in
        self?.webService = service
    }
    .store(in: &subscriptions)
  }