NowWebService-Klasse – Android

Die NowWebservice Die API stellt eine Funktion bereit, die einen startet NowWebActivity Die eine Webansicht hostet.

Tabelle : 1. Eigenschaften

Name	Typ	Beschreibung
konfigurieren	NowServiceConfiguration-Klasse – Android	Konfigurationsinformationen für den zugehörigen Service, z. B. ServiceNow Instanz-URL und der Name des Pakets.

NowWebservice – Start(Kontext: Kontext, url: URL, nowWebTheme: NowWebTheme)

Erstellt eine NowWebActivity, die die Webansicht hostet.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
context	Kontext	Kontext, der zum Starten der zugehörigen Aktivität verwendet werden soll.
URL	URL	URL der zu ladenden Webseite. Diese Webseite muss sich im Ziel befinden ServiceNow Instanz, mit der der Service initialisiert wurde.
NowWebTheme	NowWebTheme	Optional. NowWebTheme Objekt, das auf die UI-Elemente des Ansichts-Controllers angewendet werden soll. Standard: Standarddesign

Tabelle : 3. Rückgaben

Typ	Beschreibung
Keine

Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

suspend fun launchNowWeb() {
    val webService = getNowWebService()

    val webTheme = object : NowWebTheme {
        override val brand: Int
            get() = Color.BLUE

        override val textPrimary: Int
            get() = Color.BLACK

        //Override remaining theme colors
    }
    webService?.launch(activity, URL("https://instance-name.service-now.com"), webTheme)
}

NowWebservice – preloadWebCache(preloadUris: List<URI>)

Lädt eine Liste der angegebenen java.net.URIs in einer kopflosen Webansicht vorab, um den Webansichts-Cache mit zwischenspeicherbaren Ressourcen auf der Seite vorab auszufüllen.

Hinweis:

Der Abschluss dieses Funktionsaufrufs basiert auf OnPageFinished() Wird in der Webansicht aufgerufen, die keine Umleitungen oder Ressourcen auf der Seite berücksichtigt. Daher ist das Vorladen möglicherweise nicht vollständig abgeschlossen, wenn diese Methode zurückgegeben wird.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
PreloadUris	Liste	Liste von java.net.URIs, die vorab geladen werden sollen. Alle java.net.URIs müssen relativ sein oder mit dem aktuell im NowSDK konfigurierten Host übereinstimmen.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt die Verwendung von Webservice.preloadWebCache() Funktion zum Vorladen von Mesp Seite.

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

NowWebservice – updateTheme(nowWebTheme: NowWebTheme)

Aktualisiert das NowWeb-UI-Design mit dem angegebenen UI-Design. Verwenden Sie diese Funktion, um das Web-UI-Design zu aktualisieren, nachdem es ursprünglich mit festgelegt wurde Starten () Funktion, z. B. beim Ändern des Designs von hell nach dunkel.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
NowWebTheme	NowWebTheme	NowWebTheme Objekt, das auf die UI-Elemente des Ansichts-Controllers angewendet werden soll.

Tabelle : 7. Rückgaben

Typ	Beschreibung
Keine

Das folgende Codebeispiel zeigt, wie Sie ein leichtes UI-Design aktualisieren, das mit implementiert wurde Starten () Funktion zum dunklen UI-Design mit UpdateTheme() Funktion.

val webService = getNowWebService()

val lightTheme = object : NowWebTheme {
    override val brand: Int
        get() = Color.BLUE

    override val textPrimary: Int
        get() = Color.BLACK

    override val backgroundPrimary: Int
        get() = Color.WHITE

    // Override remaining theme colors
}

val darkTheme = object : NowWebTheme {
    override val brand: Int
        get() = Color.BLUE

    override val textPrimary: Int
        get() = Color.WHITE

    override val backgroundPrimary: Int
        get() = Color.BLACK

    // Override remaining theme colors
}

//launch NowWeb with light theme
webService?.launch(activity, URL("https://instance-name.service-now.com"), lightTheme)

//update NowWeb with dark theme
webService?.updateTheme(darkTheme)