API NowWeb : iOS

L’API NowWeb est une API globale de haut niveau qui permet aux utilisateurs d’instancier une instance de service NowWeb.

NowWeb : makeWebService(instanceUrl : URL) lèves asynchrones

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

Crée une instance de NowWebService à l’aide de la configuration spécifiée précédemment. Lorsque vous avez terminé, appelle le gestionnaire de complétion 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 de complétion appelé avec un résultat <NowWebService, NowServiceError> contenant soit une instance NowWebService initialisée, soit une NowServiceError indiquant la raison de l’échec de l’initialisation.

Tableau 4. Renvoie

Type	Description
Aucun

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 a été déconseillée. 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)
  }