NowSDK – Android

Die NowSDK -Klasse ist ein Singleton, das die öffentliche API für NowSDK bereitstellt. Diese Klasse ist das Gateway für alle Android SDK-Funktionsservices.

Bevor Sie einen Funktionsservice initialisieren, müssen Sie das SDK selbst initialisieren, indem Sie NowSDK.configure()aufrufen. Weitere Informationen für die ersten Schritte mit dem Android NowSDK finden Sie im ServiceNow Mobile SDK-Entwicklerhandbuch – Android.

NowSDK – konfigurieren (Anwendung: Anwendung, Konfiguration: NowSDKConfiguration)

Konfiguriert das NowSDK für die Verwendung.

Sie müssen diese Funktion aufrufen, bevor Sie versuchen, einen der vom SDK bereitgestellten Funktionsservices zu verwenden.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Anwendung	Anwendung	Verweis auf das Hosting-Anwendungsobjekt.
konfigurieren	NowServiceKonfiguration	Objekt mit den Informationen, die zum Initialisieren von NowSDK erforderlich sind

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Keine	NowSDKError wird ausgelöst, wenn die angegebene Konfiguration ungültig ist.

Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

class SampleApplication : Application(), NowSDKAuthorizationProviding, DevicePermissionDelegate {

    private val nowSdkSettings = NowSDKSettings(
        instanceBaseURL = "https://instance-name.service-now.com",
        clientId = "client_id",
        user = "user"
    )

    private val coroutineScope = CoroutineScope(Dispatchers.IO)

    private val nowSDKConfiguration = NowSDKConfiguration(this, this, NowLogLevel.Debug)
    override fun onCreate() {
        super.onCreate()

        NowSDK.configure(this, nowSDKConfiguration)
    }


    override fun requestAuthorization(
        instanceURL: URL,
        callback: Consumer<List<AuthorizationToken>?>
    ) {
        coroutineScope.launch {
            when {
                nowSdkSettings.user.isNullOrBlank().not() -> authorizeWithJWT(
                    callback = callback,
                    user = nowSdkSettings.user,
                    clientId = nowSdkSettings.clientId
                )

                else -> authorizeWithGuest(callback = callback)
            }
        }
    }

    override fun canRequestPermission(permission: DevicePermission): Boolean {
        return true
    }
}

NowSDK – Logout ()

Löscht alle Anwendersitzungen, die im Arbeitsspeicher gespeichert sind.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Keine

Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

class SampleApplication : Application() {

    private val nowSDKConfiguration = NowSDKConfiguration(authorizationProvider, permissionDelegate, NowLogLevel.Debug)

    override fun onCreate() {
        super.onCreate()
        NowSDK.configure(this, nowSDKConfiguration)
    }

    fun logout() {
        // Clear all user session when an application resets the user session
        NowSDK.logout()
    }
}