Version 11.42 de OneSpan Sign : Notifications Javascript remaniées
La version 11.42 de OneSpan Sign a été récemment déployée dans l'environnement de prévisualisation et de sandbox. Dans cette dernière version, nous avons ajouté de nouveaux événements JavaScript et Callback, apporté de nouvelles fonctionnalités à la signature en salle virtuelle, ajouté la prise en charge d'un plus grand nombre de composants de l'interface utilisateur New Signer Experience pour le formatage en markdown, et plus encore. Pour une liste complète des mises à jour du produit, consultez la note de mise à jour 11.42. Consultez également notre Trust Center et trouvez les dates de déploiement pour tous nos environnements.
Dans ce blog, nous allons d'abord passer rapidement en revue le mécanisme derrière le notificateur d'événement Javascript. Ensuite, nous explorerons les événements nouvellement introduits, afin que vous ayez une meilleure idée de la manière dont ces changements peuvent faciliter votre intégration. Sans plus attendre, commençons !
Examen rapide de Javascript Notifier
Lorsque la cérémonie de signature est intégrée à une iFrame ou à une WebView, le notificateur d'événements envoie des notifications à votre fenêtre mère lorsque des actions spécifiques sont déclenchées. Cela fournit des informations sur la progression de la signature et s'avère utile si vous souhaitez contrôler le flux de signature lorsqu'une certaine étape a été accomplie. Par exemple, pour rediriger un signataire vers une autre page Web une fois qu'il a terminé de signer.
Pour configurer un Notificateur d'événements, suivez les étapes ci-dessous :
Étape 1 : Écoutez les événements du message de OneSpan Sign, comme indiqué ci-dessous :
window.addEventListener('message', receiveMessage, false) ;
Étape 2 : Traiter l'événement reçu selon les besoins. Un exemple pourrait être :
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 ; } }
Au chargement d'une page dans un iframe, OneSpan Sign déclenche initialement un événement "ESL:MESSAGE:REGISTER". En retour, votre application doit renvoyer le message "ESL:MESSAGE:ACTIVATE_EVENTS" afin de recevoir d'autres événements.
Les exemples de code ci-dessus sont utilisés pour l'expérience de bureau. Si vous développez des applications mobiles natives, consultez notre blog précédent "WebView Support in Android Devices" pour des instructions plus détaillées.
Types d'événements nouvellement introduits
Lorsqu'un signataire effectue des actions pendant la signature, par exemple lorsqu'il a refusé de signer, la fenêtre Cérémonie de signature envoie un message particulier à votre fenêtre parent. Vous trouverez une liste des types d'événements disponibles que votre notificateur d'événements peut écouter dans le guide Utilisation des notificateurs d'événements JavaScript.
En plus de ce qui a été listé ici, il y a trois types d'événements supportés depuis la version 11.42 :
|
Nom de l'événement |
Description |
L'événement peut-il être interrompu temporairement ? |
|
ESL:MESSAGE:SUCCESS:DOCUMENT_VIEW: |
Lorsqu'un signataire visualise un document. |
Non |
|
ESL:MESSAGE:COMMENCÉ:SIGNER_COMPLET_REVIEWED |
Quand un signataire a commencé à terminer la révision des documents. |
Oui |
|
ESL:MESSAGE:SUCCESS:SIGNER_COMPLET_REVIEWED |
Lorsqu'un signataire a terminé de réviser les documents. |
Non |
Événement de visualisation de documents
Essentiellement, l'événement de visualisation de document "ESL:MESSAGE:SUCCESS:DOCUMENT_VIEW:
En travaillant en tandem avec les événements Document Accept "ESL:MESSAGE:SUCCESS:DOCUMENT_ACCEPT" et Document Confirm "ESL:MESSAGE:SUCCESS:DOCUMENT_CONFIRM", votre code frontal est capable de suivre l'état de la signature en temps réel sans dépendre des notifications de rappel.
Signataire complet Événement révisé
L'événement Signer terminé est déclenché dès lors qu'un signataire a signé tous les documents requis. Toutefois, cela ne suffit pas si votre entreprise veut s'assurer que le signataire a également parcouru tous les documents à examiner. Le Signer Complete Reviewed Event est conçu pour atténuer ce problème de par sa nature même. Il n'envoie une notification que lorsque le signataire s'est rendu jusqu'au dernier document et a cliqué sur le bouton "TERMINER".
L'utilisation de cet événement est utile lorsque le dernier document de votre transaction est un document à consulter uniquement, mais que vous ne souhaitez pas recevoir de notification avant que le signataire ait parcouru tout le contenu. Au lieu de surveiller l'événement Signer Complete, l'événement Signer Complete Reviewed est un remplacement parfait pour ce scénario. Regardez la vidéo ci-dessous :
Un autre cas d'utilisation typique est celui où le signataire est un réviseur. Dans les versions précédentes, votre application n'aurait pas été informée de la fin de la révision par le signataire, car il n'y a tout simplement pas de signatures en attente. Après l'introduction de cet événement, votre intégration obtient le contrôle du flux de travail tant que l'examinateur a cliqué sur le bouton "FINISH". Regardez la vidéo ci-dessous pour plus d'informations :
Voilà. Dans ce blog, nous avons parcouru les bases de Javascript Notifier et démontré l'utilisation des événements nouvellement introduits. Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les Forums communautairesdes développeurs . Vos commentaires sont importants pour nous!
