Classe NowWebService - Android

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 1 min. de leitura
  • A API NowWebService fornece uma função que inicia uma NowWebActivity que hospeda uma exibição da web.

    Tabela 1. Propriedades
    Nome Tipo Descrição
    configuração Classe NowServiceConfiguration - Android Informações de configuração do serviço associado, como o URL da instância ServiceNow e o nome do pacote.

    NowWebService - launch(contexto: Contexto, URL: URL, tema: NowWebTheme)

    Cria uma NowWebActivity que hospeda a exibição da Web.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    contexto Contexto Contexto a ser usado para iniciar a atividade associada.
    url URL URL da página da Web a ser carregada. Esta página da Web deve estar na instância de destino ServiceNow com a qual o serviço foi inicializado.
    tema NowWebTheme Opcional. NowWebTheme a ser aplicado aos elementos de IU do controlador de exibição.

    Padrão: tema padrão

    Tabela 3. Retorna
    Tipo Descrição
    Nenhum

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

    lifecycleScope.launch {
      sdkManager.getNowWebService()?.launch(this@MainActivity, URL("https://instance-name.service-now.com"), object : NowWebTheme {
        override val brand: NowUIAdaptiveColor
          //Setting lightColor only. For dark theme default color will be used
          get() = NowUIAdaptiveColor(lightColor = Color.BLACK)
    
        override val primary: NowUIAdaptiveColor
          //Setting both lightColor and darkColor
          get() = NowUIAdaptiveColor(lightColor = Color.BLACK, darkColor = Color.WHITE)
    
        //override the rest of color variables
      })
    }

    NowWebService – preloadWebCache(preloadUris: Lista<URI> )

    Pré-carrega uma lista de java.net.URIs especificados em uma exibição da web sem interface com o usuário para preencher previamente o cache de exibição da web com recursos armazenáveis em cache na página.

    Nota:
    A conclusão desta chamada de função é baseada em onPageFinished() que está sendo chamado na exibição da Web, que não leva em conta redirecionamentos ou recursos na página. Por isso, o pré-carregamento pode não estar totalmente concluído quando este método retornar.
    Tabela 4. Parâmetros
    Nome Tipo Descrição
    preloadUris Lista Lista de java.net.URIs para pré-carregar. Todos os java.net.URIs devem ser relativos ou corresponder ao host atual configurado no NowSDK.
    Tabela 5. Retorna
    Tipo Descrição
    Nenhum

    O exemplo a seguir mostra como usar a função webService.preloadWebCache() para pré-carregar a página do mesp.

    suspend fun preloadNowWeb() {
      val webService = serviceProvider.webService()
      webService.preloadWebCache(
        listOf(
          URI("mesp")
        )
      )
    }