Estrutura do NowSDK - iOS

A estrutura do NowSDK contém métodos que permitem a instanciação de vários serviços de recursos.

NowSDK - configura (com configuração: NowSDKConfiguration) lança

Configura o NowSDK para uso. Você deve chamar esta função antes de chamar qualquer um dos serviços do recurso dentro do Mobile SDK.

Nota:

Se a configuração aprovada for inválida, um NowSDKError será gerado.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
com configuração	NowSDKConfiguration	NowSDKConfiguration que contém as informações necessárias para inicializar o serviço.

Tabela 2. Retorna

Tipo	Descrição
Nenhum, NowSDKError	NowSDKError será gerado se a configuração aprovada for inválida.

O exemplo de código a seguir mostra como chamar esta função.

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

Retorna uma referência ao serviço principal do SDK.

Nota:

Aplicações host não precisam chamar esta função.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
Objeto	O objeto em conformidade com o protocolo NowCoreServiceProviding será retornado se o SDK tiver sido inicializado chamando o método NowSDK - configura (com configuração: NowSDKConfiguration) lança ; caso contrário, nulo.

O exemplo de código a seguir mostra como chamar esta função.

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

NowSDK - makeServiceConfiguration (para instanceUrl: URL)

Função de conveniência que os serviços de recursos podem usar para construir o objeto n NowServiceConfiguration.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
instanceUrl	URL	URL da instância ServiceNow que o serviço acessará.

Tabela 6. Retorna

Tipo	Descrição
NowServiceConfiguration	Se o URL especificado passar nas verificações básicas de validade e a configuração do serviço puder ser construída corretamente, retornará o objeto NowServiceConfiguration; caso contrário, nulo.

O exemplo de código a seguir mostra como chamar essa função.

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 
  }