NowWeb API - iOS

NowWeb API는 NowWeb 서비스 인스턴스를 인스턴스화하는 데 사용할 수 있는 최상위 글로벌 API입니다.

NowWeb - makeWebService(instanceUrl: URL) 비동기 throws

이전에 지정한 구성을 사용하여 NowWebService의 인스턴스를 작성합니다.

이 함수를 호출하기 전에 SDK를 초기화해야 하며, 그렇지 않으면 완료 블록이 sdkNotConfigured 오류와 함께 호출됩니다. SDK를 초기화하려면 원하는 구성으로 NowSDK.configure() 를 호출합니다.

표 1. 매개변수

이름	유형	설명
instanceUrl	URL	ServiceNow 서비스에서 웹 서비스에 액세스할 인스턴스의 URL입니다.

표 2. 반환

유형	설명
나우웹서비스	성공하면 초기화된 NowWebService 객체를 반환합니다.
NowServiceError	메서드가 실패하면 다음 오류 중 하나가 발생합니다. 가능한 값: sdkNotConfigured serviceConfigurationInvalid serviceDisabled serviceSettingsInvalid serviceSettingsNotFound serviceSettingsRetrievalFailed

다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

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, completion: @escaping ((Result<NowWebService, NowServiceError>) -> Void))

이전에 지정한 구성을 사용하여 NowWebService의 인스턴스를 작성합니다. 완료되면 지정된 완료 핸들러를 호출합니다.

이 함수를 호출하기 전에 SDK를 초기화해야 하며, 그렇지 않으면 완료 블록이 sdkNotConfigured 오류와 함께 호출됩니다. SDK를 초기화하려면 원하는 구성으로 NowSDK.configure() 를 호출합니다.

표 3. 매개변수

이름	유형	설명
instanceUrl	URL	ServiceNow 서비스에서 웹 서비스에 액세스할 인스턴스의 URL입니다.
완료	@escaping((결과<NowWebService, NowServiceError>) -> 무효)	초기화된 NowWebService 인스턴스 또는 초기화가 실패한 이유를 나타내는 NowServiceError를 포함하는 Result<NowWebService, NowServiceError>와 함께 호출되는 완성 처리기입니다.

표 4. 반환

유형	설명
없음

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)

이전에 지정한 구성을 사용하여 NowWebService의 인스턴스를 작성합니다.

주:

이 메서드는 더 이상 사용되지 않습니다. 대신 메서드의 async/await 구현을 사용해야 합니다.

이 함수를 호출하기 전에 SDK를 초기화해야 하며, 그렇지 않으면 완료 블록이 sdkNotConfigured 오류와 함께 호출됩니다. SDK를 초기화하려면 원하는 구성으로 NowSDK.configure() 를 호출합니다.

표 5. 매개변수

이름	유형	설명
instanceUrl	URL	ServiceNow 서비스에서 웹 서비스에 액세스할 인스턴스의 URL입니다.

표 6. 반환

유형	설명
AnyPublisher<NowWebService, NowServiceError>	성공하면 초기화된 NowWebService 객체를 반환합니다. 실패하면 NowServiceError 객체를 반환합니다.

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