NowSDK-Framework – iOS

Das NowSDK- Framework enthält Methoden, die die Instanziierung verschiedener Funktionsservices ermöglichen.

NowSDK –configure(with configuration: NowSDKConfiguration) löst aus

Konfiguriert NowSDK für die Verwendung. Sie müssen diese Funktion aufrufen, bevor Sie einen der Funktionsservices in Mobile SDKaufrufen.

Hinweis:

Wenn die von Ihnen übergebene Konfiguration ungültig ist, wird ein NowSDKError ausgelöst.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
mit Konfiguration	NowSDK-Konfiguration	NowSDKConfiguration, die die zum Initialisieren des Service erforderlichen Informationen enthält.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Keine, NowSDKError	NowSDKError wird ausgelöst, wenn die übergebene Konfiguration ungültig ist.

Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

guard 
  let jwtUrl = URL(string: "http://13.57.38.237:8080"),
  let instanceUrl = URL(string: "https://mobilecoresdk.service-now.com") else {
    return
  }

// AuthorizationProvider – struct conforming to NowSDKAuthorizationProviding protocol
let authorizationProvider = AuthorizationProvider(userEmail: "[e-mail]", jwtProviderUrl: jwtUrl, clientId: "deb8756b452d201039231ca568f26511")
        
// PermissionProvider – class conforming to DevicePermissionDelegate protocol
let permissionProvider = PermissionProvider()
let config = NowSDKConfiguration(authorizationProvider: authorizationProvider, permissionDelegate: permissionProvider, logLevel: .debug)

do {
  try NowSDK.configure(with: config)
            …
} catch {
   print(“error is \(error.localizedDescription)”)
}

NowSDK – core()

Gibt einen Verweis auf den SDK-Core-Service zurück.

Hinweis:

Hostanwendungen müssen diese Funktion nicht aufrufen.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Objekt	Objekt, das dem NowCoreServiceProvider- Protokoll entspricht, wird zurückgegeben, wenn das SDK durch Aufrufen der Methode NowSDK –configure(with configuration: NowSDKConfiguration) löst aus initialisiert wurde; ansonsten nil.

Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

guard let coreService = NowSDK.core() else {
  // Error with NowServiceError.sdkNotConfigured
  return
}

NowSDK – makeServiceConfiguration(for instanceUrl: URL)

Komfortfunktion, die von Funktionsservices zum Erstellen eines NowServiceConfiguration-Objekts verwendet werden kann.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
instanceUrl	URL	URL der Instanz ServiceNow, auf die der Service zugreift.

Tabelle : 6. Ergebnisse

Typ	Beschreibung
NowServiceConfiguration	Wenn die angegebene URL grundlegende Gültigkeitsprüfungen besteht und die Servicekonfiguration ordnungsgemäß erstellt werden kann, wird das NowServiceConfiguration-Objekt zurückgegeben. ansonsten nil.

Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

guard 
  let instanceUrl = URL(string: "https://mobilecoresdk.service-now.com"),
  let serviceConfig = NowSDK.makeServiceConfiguration(for: instanceUrl) else {
    logger.error(message: "Could not create service - service configuration invalid")
    return 
  }