NowSDK - Android

. NowSDK A classe é um singleton que fornece a API pública para o NowSDK. Esta classe é o gateway para todos Android Serviços de recursos do SDK.

Antes de inicializar um serviço de recurso, você deve inicializar o próprio SDK chamando NowSDK.configure() . Para obter informações adicionais sobre como começar a usar o. Android NowSDK, consulte ServiceNow Guia do desenvolvedor do SDK para celular - Android.

NowSDK - configure(aplicação: Aplicação, configuração: NowSDKConfiguration)

Configura o NowSDK para uso.

Você deve chamar esta função antes de tentar usar qualquer um dos serviços de recurso fornecidos pelo SDK.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
aplicação	Aplicação	Referência ao objeto da aplicação de hospedagem.
configuração	NowServiceConfiguration	Objeto que contém as informações necessárias para inicializar o NowSDK.

Tabela 2. Retornos

Tipo	Descrição
Nenhum(a)	NowSDKError será lançado se a configuração fornecida for inválida.

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

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()

Limpa todas as sessões do usuário persistentes na memória.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
Nenhum(a)

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

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()
    }
}