OneSpan Sign Versión 11.42: Notificaciones Javascript renovadas
La versión 11.42 de OneSpan Sign se ha desplegado recientemente en el entorno de vista previa y sandbox. En esta última versión, hemos añadido nuevos eventos de JavaScript y de devolución de llamada, hemos proporcionado nuevas funciones a la firma en la Sala Virtual, hemos añadido compatibilidad con más componentes de la interfaz de usuario de la Nueva Experiencia del Firmante para dar formato en markdown, y mucho más. Para obtener una lista completa de las actualizaciones del producto, consulte la nota de la versión 11.42. Consulte también nuestro Centro de Confianza y encuentre las fechas de despliegue de todos nuestros entornos.
En este blog, primero haremos un rápido repaso del mecanismo que hay detrás del notificador de eventos de Javascript. A continuación, exploraremos los nuevos eventos introducidos, para que tenga una mejor idea de cómo estos cambios pueden facilitar su integración. Sin más dilación, ¡comencemos!
Revisión rápida de Javascript Notifier
Cuando la Ceremonia de Firma está incrustada en un iFrame o una WebView, el notificador de eventos envía notificaciones a su ventana principal cuando se activan acciones específicas. Esto proporciona información sobre el progreso de la firma y es útil si quiere controlar el flujo de la firma cuando se ha realizado un determinado paso. Por ejemplo, para redirigir a un firmante a una página web diferente una vez que haya terminado de firmar.
Para configurar un notificador de eventos, siga los siguientes pasos:
Paso 1: Escuche los eventos de mensajes de OneSpan Sign, como se muestra a continuación:
window.addEventListener('message', receiveMessage, false);
Paso 2: Manejar el evento recibido como sea necesario. Un ejemplo podría ser:
function receiveMessage(event) { var origin = event.origin || event.originalEvent.origin; var data = event.data; console.log(data, origin); switch (data) { case 'ESL:MESSAGE:REGISTER': event.source.postMessage('ESL:MESSAGE:ACTIVATE_EVENTS', origin); break; default: event.source.postMessage(data, origin) break; }
Al cargar una página en un iframe, OneSpan Sign lanzará inicialmente un evento "ESL:MESSAGE:REGISTER". A cambio, su aplicación debe devolver el mensaje "ESL:MESSAGE:ACTIVATE_EVENTS" para recibir más eventos.
Los ejemplos de código anteriores se utilizan para la experiencia de escritorio. Si está desarrollando con aplicaciones móviles nativas, consulte nuestro blog anterior "Soporte de WebView en dispositivos Android" para obtener instrucciones más detalladas.
Tipos de eventos recién introducidos
Cuando un firmante realiza acciones durante la firma, por ejemplo cuando el firmante se ha negado a firmar, la ventana Ceremonia de firma envía un mensaje particular a su ventana principal. Encontrarás una lista de los tipos de eventos disponibles que tu notificador de eventos puede escuchar en la guía Uso de los notificadores de eventos de JavaScript.
Además de lo que se ha enumerado allí, hay tres tipos de eventos soportados desde la versión 11.42:
|
Nombre del evento |
Descripción |
¿Se puede detener temporalmente el evento? |
|
ESL:MESSAGE:SUCCESS:DOCUMENT_VIEW: |
Cuando un firmante ve un documento. |
No |
|
ESL:MENSAJE:INICIADO:FIRMANTE_COMPLETO_REVISADO |
Cuando un firmante comenzó a completar la revisión de documentos. |
Sí |
|
ESL:MENSAJE:ÉXITO:FIRMANTE_COMPLETO_REVISADO |
Cuando un firmante ha terminado de revisar los documentos. |
No |
Evento de visualización de documentos
Básicamente, el evento de vista del documento "ESL:MESSAGE:SUCCESS:DOCUMENT_VIEW:
Trabajando en conjunto con los eventos "ESL:MESSAGE:SUCCESS:DOCUMENT_ACCEPT" y "ESL:MESSAGE:SUCCESS:DOCUMENT_CONFIRM" de Aceptación de Documento, su código frontal es capaz de rastrear el estado de la firma en tiempo real sin depender de las notificaciones de devolución de llamadas.
Firmante Completo Evento Revisado
El Evento de Firmante Completo se activa siempre que un firmante haya firmado todos los documentos requeridos. Sin embargo, esto no es suficiente si su empresa quiere asegurarse de que el firmante también ha revisado todos los documentos de revisión. El Evento Revisado Completo del Firmante está diseñado para mitigar este punto problemático por su propia naturaleza, y sólo envía una notificación cuando el firmante ha navegado hasta el último documento y ha hecho clic en el botón "FINALIZAR".
Aprovechar este evento es útil cuando el último documento de su transacción es un documento de revisión, pero no quiere recibir una notificación hasta que el firmante haya navegado por todo el contenido. En lugar de supervisar el Evento de Firma Completa, el Evento de Firma Completa Revisada es un sustituto perfecto para este escenario. Vea el vídeo a continuación:
Otro caso típico es cuando el firmante es un revisor. En versiones anteriores, su aplicación no habría sido notificada si el firmante terminó de revisar, porque simplemente no hay firmas pendientes. Después de introducir este evento, su integración obtiene el control del flujo de trabajo siempre que el revisor haya hecho clic en el botón "FINISH". Vea el siguiente vídeo para obtener más información:
Ahí está. En este blog, hemos recorrido los fundamentos de Javascript Notifier y hemos demostrado los usos de los nuevos eventos introducidos. Si tiene alguna pregunta sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite los foros de la comunidad de desarrolladores. Su opinión nos importa
