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. Rückgaben

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. Rückgaben

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. Rückgaben

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