OneSpan Sign Release 11.51 : Champ d'impression

Duo Liang,

La version 11.51 de OneSpan Sign a récemment été déployée dans l'environnement de prévisualisation. Dans cette dernière version, nous avons amélioré la fonction de notarisation en ligne à distance, changé le logo et les couleurs de OneSpan Sign dans le portail de l'expéditeur, optimisé l'expérience du signataire lors de la capture de la signature et corrigé un certain nombre de bogues. Pour une liste complète des mises à jour du produit, consultez la note de mise à jour 11.51. Consultez également notre Trust Center pour connaître les dates de déploiement de tous nos environnements.

Parmi toutes les nouvelles fonctionnalités passionnantes, nous nous concentrerons sur le champ d'empreintes et démontrerons comment les utilisateurs ad-hoc et intégrés peuvent exploiter ce champ et le rendre plus flexible pour différents cas d'utilisation. Nous discuterons des aspects clés du champ d'impression et expliquerons comment il peut bénéficier à vos flux de documents. Sans plus attendre, commençons !

Principales caractéristiques des champs d'impression

Le champ d'impression est un nouveau type de champ qui peut être placé sur les documents lors de la création de la transaction et qui n'est pas lié à un signataire ou à une signature. Cela garantit que les informations que l'expéditeur place dans ces champs sont visibles par tous les destinataires et restent inchangées tout au long du processus de signature.

L'ajout de la fonction Imprint Fields à OneSpan Sign offre aux utilisateurs une plus grande flexibilité dans leurs flux de documents, leur permettant d'inclure des champs non assignés sans compromettre l'intégrité du document. Cette fonctionnalité est particulièrement utile pour inclure des informations statiques ou des données qui n'ont pas besoin d'être modifiées par un signataire au cours du processus de transaction.

Pour accéder aux champs d'impression et les utiliser, vous devez activer cette fonctionnalité en contactant l'équipe d'assistance de OneSpan Sign ou en utilisant l'option de libre-service Paramètres du compte dans votre portail d'expéditeur.

Ajouter un champ d'impression dans le Designer

Une fois la fonctionnalité activée dans votre compte, vous trouverez des options supplémentaires pour les champs d'impression en bas du panneau de gauche de votre page de conception.

23-5-3-1

Pour l'instant, seuls les champs d'étiquettes sont pris en charge. L'expéditeur peut saisir la valeur comme il le ferait pour des étiquettes standard. Toutes les opérations liées aux champs d'impression, telles que l'ajout, la modification et la suppression, ne peuvent être effectuées que lorsque la transaction est à l'état de projet. Une fois la transaction envoyée, les champs d'impression sont aplatis dans le document avant que le signataire ne le voie, ce qui garantit que le contenu du champ est visible et ne peut pas être modifié.

23-5-3-2

Intégrer le champ d'impression

Il est également facile pour les utilisateurs intégrés de tirer parti de cette fonctionnalité. Lors de la création d'une transaction et de la construction du JSON de la demande, ajoutez un tableau "imprintFields" sous le nœud "documents".

Pour chaque nœud "Imprint Field", définissez le type de champ, l'identifiant, la police et la position comme pour un champ d'étiquette classique :

        {
          "id" : "imprint_field_id",
          "subtype" : "LABEL",
          "left" : 144.0,
          "width" : 165.0,
          "height" : 37.0,
          "page" : 0,
          "fontSize" : 12,
          "top" : 389.0,
          "type" : "INPUT",
          "valeur" : "John Smith",
          "nom" : "nom_du_champ_impression"
        }

Une transaction JSON complète pourrait ressembler à ce qui suit :

Requête HTTP

POST /api/packages

En-têtes HTTP

Authorization : Basic api_key / Bearer access_token
Accept : application/json
Content-Type : multipart/form-data

Chargement de la requête

{
  "roles" : [
    {
      "id" : "Signer1",
      "signers" : [
        {
          "email" : "[email protected]",
          "firstName" : "John",
          "lastName" : "Smith"
        }
      ]
    }
  ],
  "documents" : [
    {
      "imprintFields" : [
        {
          "id" : "imprint_field_id",
          "subtype" : "LABEL",
          "left" : 144.0,
          "width" : 165.0,
          "height" : 37.0,
          "page" : 0,
          "fontSize" : 12,
          "top" : 389.0,
          "type" : "INPUT",
          "valeur" : "John Smith",
          "nom" : "nom_du_champ_impression"
        }
      ],
      "approvals" : [
        {
          "role" : "Signer1",
          "fields" : [
            {
              "page" : 0,
              "top" : 100,
              "sous-type" : "FULLNAME",
              "height" : 50,
              "left" : 100,
              "width" : 200,
              "type" : "SIGNATURE"
            }
          ]
        }
      ],
      "nom" : "Document de test"
    }
  ],
  "nom" : "Champ d'impression de test",
  "langue" : "en",
  "status" : "DRAFT"
}

Notez que cette fonctionnalité n'est temporairement pas disponible dans les SDK.

Avant d'envoyer la transaction, vous avez encore la possibilité de gérer les champs d'impression. OneSpan Sign a également fourni cinq nouveaux points de terminaison API pour permettre aux utilisateurs de récupérer, créer, mettre à jour et supprimer les champs de mentions légales, ainsi que de supprimer tous les champs de mentions légales associés à un document particulier. Ces points d'accès sont les suivants :

POST /api/packages/{packageId}/documents/{documentId}/imprint-fields
GET /api/packages/{packageId}/documents/{documentId}/imprint-fields/{fieldId}
PUT /api/packages/{packageId}/documents/{documentId}/imprint-fields/{fieldId}
DELETE /api/packages/{packageId}/documents/{documentId}/imprint-fields/{fieldId}
DELETE /api/packages/{packageId}/documents/{documentId}/imprint-fields

Nous voulons connaître votre avis

Nous y voilà. Nous avons abordé les principaux aspects des champs d'impression. Si vous avez des questions concernant ce blog ou tout autre sujet relatif à l'intégration de OneSpan Sign dans votre application, visitez les forums de la communauté des développeurs. Vos commentaires nous intéressent !