API NowWeb - iOS

A API do NowWeb é uma API global de nível superior que permite que os usuários instanciem uma instância de serviço do NowWeb.

NowWeb - lançamentos assíncronos de makeWebService(instanceUrl: URL)

Cria uma instância do NowWebService usando a configuração especificada anteriormente.

Você deve inicializar o SDK antes de chamar esta função ou o bloco de conclusão será chamado com um erro sdkNotConfigured. Para inicializar o SDK, chame NowSDK.configure() com a configuração desejada.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
instanceUrl	URL	URL da instância ServiceNow cujos serviços web serão acessados pelo serviço.

Tabela 2. Retornos

Tipo	Descrição
NowWebService	Se for bem-sucedido, retornará um objeto NowWebService inicializado.
NowServiceError	Lança um dos seguintes erros se o método falhar. Valores possíveis: sdkNãoConfigurado serviceConfigurationInválido serviço desabilitado serviceSettingsInvalid serviceSettingsNotFound serviceSettingsRetrievalFailed

O exemplo de código a seguir mostra como chamar este método.

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, conclusão: @escaping ((Resultado<NowWebService, NowServiceError> ) -> Vazio))

Cria uma instância do NowWebService usando a configuração especificada anteriormente. Quando terminar, chama o manipulador de conclusão especificado.

Você deve inicializar o SDK antes de chamar esta função ou o bloco de conclusão será chamado com um erro sdkNotConfigured. Para inicializar o SDK, chame NowSDK.configure() com a configuração desejada.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
instanceUrl	URL	URL da instância ServiceNow cujos serviços web serão acessados pelo serviço.
conclusão	@escaping ((Resultado<NowWebService, Now​Service​Error>) -> Void)	Manipulador de conclusão que é chamado com um Resultado <NowWebService, NowServiceError> contendo uma instância NowWebService inicializada ou um NowServiceError indicando o motivo da falha na inicialização.

Tabela 4. Retornos

Tipo	Descrição
Nenhum

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)

Cria uma instância do NowWebService usando a configuração especificada anteriormente.

Nota:

Este método foi descontinuado. Em vez disso, você deve usar a implementação assíncrona/aguardar do método.

Você deve inicializar o SDK antes de chamar esta função ou o bloco de conclusão será chamado com um erro sdkNotConfigured. Para inicializar o SDK, chame NowSDK.configure() com a configuração desejada.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
instanceUrl	URL	URL da instância ServiceNow cujos serviços web serão acessados pelo serviço.

Tabela 6. Retornos

Tipo	Descrição
AnyPublisher<NowWebService, NowServiceError>	Se for bem-sucedido, retornará um objeto NowWebService inicializado. Se falhar, retornará um objeto 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)
  }