NowWeb-API – iOS

Die NowWeb -API ist eine globale API der obersten Ebene, mit der Benutzer eine NowWeb-Serviceinstanz instanziieren können.

NowWeb – makeWebService(instanceUrl: URL) async löst aus

Erstellt eine Instanz von NowWebService mit der zuvor angegebenen Konfiguration.

Sie müssen das SDK vor dem Aufruf dieser Funktion initialisieren. Andernfalls wird der Abschlussblock mit einem sdkNotConfigured- Fehler 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
Now Web Service	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 serviceDeaktiviert serviceSettingsInvalid serviceSettingsNotFound serviceSettingsRetrievalFehlgeschlagen

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 ((Result<NowWebService, NowServiceError> ) -> Ungültig))

Erstellt eine Instanz von NowWebService mit der zuvor angegebenen Konfiguration. Ruft nach Abschluss den angegebenen Abschluss-Handler auf.

Sie müssen das SDK vor dem Aufruf dieser Funktion initialisieren. Andernfalls wird der Abschlussblock mit einem sdkNotConfigured- Fehler 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 ((Result<NowWebService, Now​Service​Error>) -> Ungültig)	Abschluss-Handler, 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 async/wait-Implementierung der Methode verwenden.

Sie müssen das SDK vor dem Aufruf dieser Funktion initialisieren. Andernfalls wird der Abschlussblock mit einem sdkNotConfigured- Fehler 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. Wenn dies fehlschlägt, 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)
  }