NowSDK フレームワーク - iOS

NowSDK フレームワークには、さまざまな機能サービスのインスタンス化を可能にするメソッドが含まれています。

NowSDK - configure(構成:NowSDKConfiguration) throws

使用する NowSDK を構成します。この関数は、 Mobile SDK内のフィーチャ サービスを呼び出す前に呼び出す必要があります。

注:

渡した構成が無効な場合は、 NowSDKError がスローされます。

表 : 1. パラメーター

名前	タイプ	Description (説明)
構成あり	NowSDK 構成	NowSDK サービスの初期化に必要な情報を含む構成。

表 : 2. 返される内容

タイプ	Description (説明)
なし、NowSDKError	NowSDKError は、渡された構成が無効な場合にスローされます。

次のコード例は、この関数を呼び出す方法を示しています。

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

SDK コアサービスへの参照を返します。

注:

ホスト アプリケーションは、この関数を呼び出す必要はありません。

表 : 3. パラメーター

名前	タイプ	説明
なし

表 : 4. 返される内容

タイプ	説明
オブジェクト	NowSDK - configure(構成:NowSDKConfiguration) throws メソッドを呼び出して SDK が初期化された場合は、NowCoreServiceProviding プロトコルに準拠するオブジェクトが返されます。それ以外の場合は nil です。

次のコード例は、この関数を呼び出す方法を示しています。

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

NowSDK - makeServiceConfiguration(instanceUrl:URL 用)

機能サービスが n 個の NowServiceConfiguration オブジェクトを構築するために使用できる便利な関数。

表 : 5. パラメーター

名前	タイプ	Description (説明)
instanceUrl	URL	サービスがアクセスする ServiceNow インスタンスの URL。

表 : 6. 返される内容

タイプ	Description (説明)
NowServiceConfiguration	指定された URL が基本的な有効性チェックに合格し、サービス構成を適切に構築できる場合は、NowServiceConfiguration オブジェクトを返します。そうでなければ nil です。

次のコード例は、この関数を呼び出す方法を示しています。

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 
  }