Classe NowWebService : Android

L’API NowWebService fournit une fonction qui lance une 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 de l’instance ServiceNow et le nom du package.

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

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

Tableau 2. Paramètres

Nom	Type	Description
contexte	Contexte	Contexte à utiliser pour lancer 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. 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 de java.net.URI spécifiés dans une vue web sans en-tête pour préremplir le cache de la vue web avec des ressources pouvant être mises en cache sur la page.

Remarque :

La complétion de cet appel de fonction est basée sur l’appel de onPageFinished() dans la vue web, ce 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é lors du retour de cette méthode.

Tableau 4. Paramètres

Nom	Type	Description
preloadUris	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")
    )
  )
}