NowWeb-API: IOS

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

NowWeb: Asynchrone Auslöse von makeWebService(instanceUrl: URL)

Erstellt eine Instanz von NowWebService mit der zuvor angegebenen Konfiguration.

Sie müssen das SDK initialisieren, bevor Sie diese Funktion aufrufen, oder der Abschlussblock wird mit aufgerufen SdkNotConfigured Fehler. Um das SDK zu initialisieren, rufen Sie auf NowSDK.configure() Mit der gewünschten Konfiguration.

Tabelle : 1. Parameter

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

Tabelle : 2. Rückgaben

Typ	Beschreibung
NowWebservice	Wenn erfolgreich, wird ein initialisiertes NowWebService-Objekt zurückgegeben.
NowServiceError	Löst einen der folgenden Fehler aus, wenn die Methode fehlschlägt. Mögliche Werte: SdkNotConfigured ServiceConfigurationUngültige Service deaktiviert ServiceSettingsUngültige ServiceSettingsnicht gefunden 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. Wenn abgeschlossen, wird der angegebene Abschlusshandler aufgerufen.

Sie müssen das SDK initialisieren, bevor Sie diese Funktion aufrufen, oder der Abschlussblock wird mit aufgerufen SdkNotConfigured Fehler. Um das SDK zu initialisieren, rufen Sie auf NowSDK.configure() Mit der gewünschten Konfiguration.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
instanceUrl	URL	URL von ServiceNow Instanz, auf deren Webservices der Service zugreifen soll.
Abschluss	@Escaping ((Ergebnis< NowWebservice , Now-​Servicefehler​>) -> Ungültig)	Abschlusshandler, der mit aufgerufen wird Result<NowWebService, NowServiceError> Enthält entweder einen initialisierten NowWebservice Instanz oder ein NowServiceError Gibt an, 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 asynchrone/wartet-Implementierung der Methode verwenden.

Sie müssen das SDK initialisieren, bevor Sie diese Funktion aufrufen, oder der Abschlussblock wird mit aufgerufen SdkNotConfigured Fehler. Um das SDK zu initialisieren, rufen Sie auf NowSDK.configure() Mit der gewünschten Konfiguration.

Tabelle : 5. Parameter

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

Tabelle : 6. Rückgaben

Typ	Beschreibung
AnyPublisher< NowWebservice , NowServiceError>	Wenn erfolgreich, 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)
  }