NowWeb-API – iOS

Die NowWeb -API ist eine globale API der obersten Ebene, mit der mithilfe von eine NowWeb-Serviceinstanz instanziiert werden kann.

NowWeb: makeWebService(instanceUrl: URL) asynchrone Auslösungen

Erstellt eine Instanz von NowWebService mit der zuvor angegebenen Konfiguration.

Sie müssen das SDK initialisieren, bevor Sie diese Funktion aufrufen. Andernfalls wird der Abschlussblock mit dem Fehler „ sdkNotConfigured “ aufgerufen. Um das SDK zu initialisieren, rufen Sie NowSDK.configure() mit der gewünschten Konfiguration auf.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
instanceUrl	URL	URL der Instanz ServiceNow, auf deren Webservices der Service zugreifen soll.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
NowWebService	Bei Erfolg wird ein initialisiertes NowWebService-Objekt zurückgegeben.
NowServiceError	Löst einen der folgenden Fehler aus, wenn die Methode fehlschlägt. Mögliche Werte: sdkNotConfigured serviceConfigurationInvalid serviceDisabled serviceSettingsInvalid serviceSettingsNotFound „serviceSettingsRetrieval“ ist fehlgeschlagen

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

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, Abschluss: @escaping ((Ergebnis<NowWebService, NowServiceError> ) -> ungültig))

Erstellt eine Instanz von NowWebService mit der zuvor angegebenen Konfiguration. Wenn der Vorgang abgeschlossen ist, ruft den angegebenen Abschluss-Handler auf.

Sie müssen das SDK initialisieren, bevor Sie diese Funktion aufrufen. Andernfalls wird der Abschlussblock mit dem Fehler „ sdkNotConfigured “ aufgerufen. Um das SDK zu initialisieren, rufen Sie NowSDK.configure() mit der gewünschten Konfiguration auf.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
instanceUrl	URL	URL der Instanz ServiceNow, auf deren Webservices der Service zugreifen soll.
Abschluss	@escaping ((Ergebnis<NowWebService, Now​Service​Error>) -> Ungültig)	Abschlusshandler, der mit einem Ergebnis aufgerufen wird<NowWebService, NowServiceError> enthält entweder eine initialisierte NowWebService- Instanz oder einen NowServiceError, der angibt, warum die Initialisierung fehlgeschlagen ist.

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Keine

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)

Erstellt eine Instanz von NowWebService mit der zuvor angegebenen Konfiguration.

Hinweis:

Diese Methode ist veraltet. Sie sollten stattdessen die Implementierung der Methode „async/wait“ verwenden.

Sie müssen das SDK initialisieren, bevor Sie diese Funktion aufrufen. Andernfalls wird der Abschlussblock mit dem Fehler „ sdkNotConfigured “ aufgerufen. Um das SDK zu initialisieren, rufen Sie NowSDK.configure() mit der gewünschten Konfiguration auf.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
instanceUrl	URL	URL der Instanz ServiceNow, auf deren Webservices der Service zugreifen soll.

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Beliebiger Herausgeber<NowWebService, NowServiceError>	Bei Erfolg wird ein initialisiertes NowWebService-Objekt zurückgegeben. Bei einem Fehler wird ein NowServiceError-Objekt zurückgegeben.

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