Développeur de signes OneSpan : URL de transfert

Duo Liang, février 14, 2020

Imaginez que vous développez une application intégrée avec OneSpan Sign. Une fois que le signataire a terminé la signature, vous voulez trouver un moyen de synchroniser le changement d’état de signature et de prendre le contrôle du processus de signature électronique. Il existe quelques technologies que vous connaissez peut-être déjà, comme la mise en place d’un auditeur de rappel ou l’utilisation du notificateur Javascript.

L’URL de transfert, d’autre part, peut également être utilisé comme un crochet web et envoyer votre application avec des informations en temps réel lorsque le signataire a terminé la signature. Dans ce blog, nous allons plonger dans les détails de l’URL de transfert et de partager quelques conseils sur la façon de tirer parti de cette fonctionnalité dans votre propre intégration. Commençons !

Qu’est-ce qu’une URL de transfert ?

Une URL de transfert est un lien de redirection pré-réglé dans les paramètres du package, ce qui vous permet de déterminer où la cérémonie de signature sera déplacée après qu’un destinataire interagit avec une transaction. L’URL sera déclenchée différemment à certains égards. Le scénario le plus courant est quand un signataire a terminé la signature, l’URL de transfert s’affiche comme un bouton de sortie à la fois disponible à la barre d’actions globales et la barre d’outils.
2-14-1
D’autres cas comme lorsqu’un destinataire refuse de signer une transaction, l’URL de transfert sera automatiquement déclenchée.

Configurez l’URL de transfert

Il y a trois valeurs que vous devez spécifier concernant l’URL de transfert :

- Transfert Link Href: Définit l’URL de redirection
- Texte de lien de transfert: Le texte qui apparaîtra sur le bouton de transfert
Handover Link Tooltip: Le texte qui apparaîtra en planant sur le bouton de transfert

Connaître l’URL de transfert est un paramètre de paquet, il est possible de définir les valeurs par défaut dans le niveau de votre compte. Si votre flux de travail nécessite simplement de rediriger la cérémonie de signature vers une page d’achèvement général ou le site Web de votre organisation, vous pouvez demander une demande et envoyer ces trois attributs à notre équipe de support, alors tous les paquets nouvellement créés hériteront des valeurs.

En outre, si vous souhaitez spécifier différents paramètres ou paramètres pour chaque paquet, la définition de l’URL de transfert au niveau du paquet est un moyen plus flexible de l’aborder.

API REST:

Les attributs sont hébergés à des « paramètres » - « cérémonie » et « transfert ». Voir ci-dessous:

{
  "statut": "DRAFT",
  "réglages":
    "cérémonie":
      "handover":
        "titre": "Vous serez redirigé vers la page d'accueil de Google",
        "href": "http://www.google.com",
        "texte": "Exit to site"
      }
    }
  },
  "type": "PACKAGE",
  "nom": "Customizing Signing Ceremony"
}

De là, l’attribut "titre" fait référence à l’outil du texte.

Java SDK:

Le code équivalent dans Java SDK ressemble à:

.withSettings(DocumentPackageSettingsBuilder.newDocumentPackageSettings()
			.avecHandOverLinkHref("http://www.google.com")
			.withHandOverLinkText ("Exit to site")
			.withHandOverLinkTooltip ("Vous serez redirigé vers la page d'accueil de Google")
		)

.NET SDK:

. WithSettings (DocumentpackageSettings.NewDocumentPackageSettings()
                        . WithHandOverLinkHref("http://www.google.com")
                        . WithHandOverLinkText (« Exit to site »)
 	       . WithHandOverLinkTooltip ("Vous serez redirigé vers la page d'accueil de Google")
 	)

Pour une lecture plus approfondie

L’URL de transfert n’informe que les utilisateurs de l’événement d’achèvement du signataire. Si vous êtes intéressé par d’autres options de notification, utilisez l’auditeur de notification d’événement de rappel. Vous pouvez trouver plus d’informations sur cette fonctionnalité dans une série de blog précédent et notre guide de fonctionnalités:

Notification d’événement de rappel - Partie 1
Notification d’événement de rappel - Partie 2
Créer un guide d’écoute de notification d’événement de rappel

En outre, si vous incorporez la cérémonie de signature dans un iFrame, il existe un autre mécanisme pour contrôler le processus de signature par le biais du notificateur Javascript. C’est une solution avec du code Javascript pur, très léger à implémenter et tester à travers la sortie. Consultez le guide des fonctionnalités pour les codes d’exemple et plus de détails:

JavaScript Event Notifier Guide

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!