API NowWeb - iOS

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

NowWeb - makeWebService(instanceUrl : URL) async lève

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

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

Tableau 1. Paramètres

Nom	Type	Description
instanceUrl	URL	URL de l’instance dont le ServiceNow service doit accéder aux services Web.

Tableau 2. Renvoie

Type	Description
Service Web Now	En cas de réussite, renvoie un objet NowWebService initialisé.
Erreur NowServiceError	Génère l’une des erreurs suivantes si la méthode échoue. Valeurs possibles : sdkNotConfigured serviceConfigurationNon valide serviceDésactivé serviceSettingsNon valide 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, completion : @escaping ((Result<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 Kit de développement logiciel (SDK) avant d’appeler cette fonction ou le bloc de complétion est appelé avec une erreur sdkNotConfigured (sdkNotCondated ). Pour initialiser le Kit de développement logiciel (SDK ), appelez NowSDK.configure() avec la configuration souhaitée.

Tableau 3. Paramètres

Nom	Type	Description
instanceUrl	URL	URL de l’instance dont le ServiceNow service doit accéder aux services Web.
Achèvement	@escaping ((Result<NowWebService, NowServiceError>) > Annulé)	Gestionnaire de complétion appelé avec un Result<NowWebService, NowServiceError> contenant soit une instance NowWebService initialisée, soit une NowServiceError indiquant pourquoi l’initialisation a échoué.

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 a été déconseillée. Vous devez utiliser l’implémentation async/await de la méthode à la place.

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

Tableau 5. Paramètres

Nom	Type	Description
instanceUrl	URL	URL de l’instance dont le ServiceNow service doit accéder aux services Web.

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