Développeur de signes OneSpan : Téléchargez la signature pour votre signataire
Dans ce blog, je vais vous guider à travers ce que vous pourriez avoir manqué dans la communauté OneSpan Sign Developer au cours de la semaine du 07 Juillet 2018. Sans plus tarder, commençons.
Dans OneSpan Sign, vous ne serez invité à tirer votre signature qu'une seule fois par l'application, même si elle nécessite plusieurs signatures capturées sur des documents. Toutes les signatures capturées ultérieures seront automatiquement répliquées par OneSpan Sign.
Comme vous l'avez peut-être remarqué, OneSpan Sign peut stocker les signatures pour le propriétaire du compte et les expéditeurs sous ce compte principal. Donc, vous pouvez demander, "Pourrais-je avoir cette fonctionnalité pour d'autres signataires? Pourrais-je stocker les signatures d'autres signataires pour une utilisation ultérieure? Pourrais-je télécharger leurs signatures avant le paquet afin que les signataires n'ont pas besoin de capturer leurs signatures, même pour le premier bloc de signature?
Les réponses à ces questions sont OUI! Nous vous suggérons de suivre ces étapes pour télécharger des signatures pour les signataires.
1. Récupérer la corde dessinée à la main
OneSpan Sign utilise l'encodage base64 pour stocker et convertir à l'image de signature, et cet encodage est représenté dans un nom d'attribut de "tiré à la main". Pour récupérer cette chaîne, elle peut être effectuée de deux façons, selon l'endroit où vous souhaitez la récupérer :
(1) Extraire la valeur d'un document signé
L'attribut manuscrit inclut dans les informations du paquet, ou pour les rendre plus exacts, dans le bloc de rôle ou le bloc d'approbation, de sorte que les deux appels API suivants fonctionnent tous les deux :
GET /packages/'packageId/documents/'documentId/approvals/'approvalId'
GET /packages/'packageId/roles/'roleId'
(2) Si vous avez déjà la signature en format d’image dans votre système, vous pouvez la convertir en un codage de base64 par cet outil d’importation. Voici une capture d'écran des morceaux de code.
remarquer:
- OneSpan Sign utilise une méthode différente pour coder la chaîne base64, de sorte que cette chaîne ne peut pas être utilisée pour l'utilisation HTML ou CSS. Par conséquent, d'autres chaînes base64 générées par d'autres convertisseurs ne peuvent pas être utilisées pour télécharger comme valeur dessinée à la main.
- Actuellement, l'outil de convertisseur n'est écrit qu'en Java.
(3) Vous pouvez également télécharger l'image de signature via l'appel API suivant et la convertir en chaîne base64 en utilisant l'outil d'importation :
GET /api/packages/'packageId/roles/'roleId/signatureImage
2. Stockez cette valeur manuscrite correctement dans votre base de données système
3. Utiliser handdrawn pour créer un paquet
Si vous souhaitez télécharger une signature capturée pour un signataire la prochaine fois avant d'envoyer un paquet, ajoutez cet attribut tiré à la main dans le bloc de rôle de votre charge utile de demande comme indiqué ci-dessous :
"rôles":[
{
"id":"Signer1",
"type":"SIGNER",
"signataires":[
{
"email":"[email protected]",
"firstName":"1_firstname",
"lastName":"1_lastname",
"id":"Signer1",
"signature":
"la valeur manuscrite du signataire à la main"
}
}
],
"nom":"Signer1"
}
]
Ce faisant, vous pouvez télécharger des signatures pour les signataires. Chaque bloc de signature de capture serait transformé en clic-à-signer. Mais encore, après avoir cliqué sur le bouton, si la signature n'est pas affichée comme attente du signataire, ils peuvent se retirer, ce qui fournit une tolérance d'erreur suffisante pour vous.
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!
