Skip to main content

Veritran Docs

Cómo utilizar XpressPlug en aplicaciones nativas de Android

Después de configurar los parámetros correctos e inicializar XpressPlug, todas las funciones disponibles están listas para usarse e interactuar con el SDK.

Aviso

Solo inicializa XpressPlug una vez por sesión, preferentemente durante el inicio de la aplicación o en la etapa más temprana posible. No podrás ejecutar ningún punto de entrada hasta que se inicialice XpressPlug.

Puedes interactuar con XpressPlug y llamar a los puntos de entrada. Estos puntos de entrada se utilizan para conectarse con las funcionalidades de Veritran, como procesos o transacciones.

Los puntos de entrada pueden ser visuales, como invocar una pantalla que abre la cámara del dispositivo para tomar una fotografía, o no visuales, como la validación de un inicio de sesión. Para interactuar con estos puntos de entrada, ingresa la siguiente sintaxis:

En el siguiente ejemplo, el punto de entrada se llama I_DOCU_SDK y sus parámetros de entrada incluyen un mapa con un nombre de usuario de tipo string. Las claves definidas como claves de salida son "errorCode" y "age". Como resultado, la función devuelve un mapa con el formato <llave, Valor> que contiene valores previamente establecidos en el array outputKeys. Ve el ejemplo a continuación para aprender cómo llamar a un punto de entrada:

class EntryPointCallerExample: EntryPoint.Callback { 
 
	fun testEntryPointCall() { 	 
		val entryPointName = "I_DOCU_SDK" 
	      val parameters = hashMapOf("userName" to "Veritran") 
			val action = XpressPlug.buildEntryPoint( 
		  entryPointName,  
		  MainApplication.mainActivity 
		) 
			parameters.forEach { 
		    		action.addInput(it.key, it.value) 
			} 
			action.setCallback(this) 
			action.execute() 
	} 

} 

Nota

El equipo de Veritran proporcionará los nombres de los puntos de entrada y sus parámetros.

Para ver los resultados de la ejecución de los puntos de entrada, debes implementar la interfaz EntryPoint.Callback. Ve el código y la tabla a continuación para ver un ejemplo de cómo se implementa la interfaz después de invocar la clase anterior.

override fun onCompleted(results: Response?) { 
    val outputKeys = listOf("errorCode", "age") 
    var params = hashMapOf<String, String>() 
    outputKeys.forEach { param -> 
        params[param.name] = results?.getOutputValue(param.name) ?: "" 
    } 
} 
 
override fun onException(code: String?, message: Exception?) { 
} 
 
override fun onUpdateRequired(message: String?) { 
} 
 
override fun onClose(message: String?, context: Activity?) { 
} 

onCompleted

Aquí es donde aparecen los parámetros de salida.

onException

Se ejecuta cuando se produce una excepción.

onUpdateRequired

Aparece cuando el SDK o la configuración deben actualizarse.

onClose

Aparece cuando la funcionalidad está cerrada.

Se puede acceder a los resultados a través del objeto Response, en el método onCompleted.