Classe NowWebService : Android

L’API NowWebService fournit une fonction qui lance un NowWebActivity qui héberge une vue Web.

Tableau 1. Propriétés

Nom	Type	Description
configuration	Classe NowServiceConfiguration : Android	Informations de configuration pour le service associé, telles que l’URL d’instance ServiceNow et le nom du package.

NowWebService – launch(context : Context, url : URL, theme : NowWebTheme)

Crée un NowWebActivity qui héberge la vue Web.

Tableau 2. Paramètres

Nom	Type	Description
contexte	Contexte	Contexte à utiliser pour le lancement de l’activité associée.
URL	URL	URL de la page Web à charger. Cette page Web doit se trouver sur l’instance cible ServiceNow avec laquelle le service a été initialisé.
Thème	NowWebTheme	Facultatif. NowWebTheme à appliquer aux éléments d’interface utilisateur du contrôleur de vue. Valeur par défaut : Thème par défaut

Tableau 3. Renvoie

Type	Description
Néant

L’exemple de code suivant montre comment appeler cette fonction.

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 : List<URI>)

Précharge une liste d’URI java.net.URI spécifiés dans un webview sans en-tête pour pré-remplir le cache webview avec des ressources pouvant être mises en cache sur la page.

Remarque :

L’achèvement de cet appel de fonction est basé sur l’appel de onPageFinished() dans le webview, qui ne prend pas en compte les redirections ou les ressources sur la page. Pour cette raison, le préchargement peut ne pas être entièrement terminé lorsque cette méthode revient.

Tableau 4. Paramètres

Nom	Type	Description
URI de préchargement	Liste	Liste des java.net.URI à précharger. Tous les java.net.URI doivent être relatifs ou correspondre à l’hôte actuel configuré dans le NowSDK.

Tableau 5. Renvoie

Type	Description
Néant

L’exemple suivant montre comment utiliser la fonction webService.preloadWebCache() pour précharger la page mesp .

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