Blog OneSpan

OneSpan Sign Release 11.44 : cases à cocher groupées

Développeurs
Duo Liang,
OneSpan-BlogImage-Revamped Checkbox

La version 11.44 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é le champ des cases à cocher, lancé de nouvelles fonctionnalités pour la salle virtuelle OneSpan Sign, ajouté la prise en charge de la langue arabe dans la nouvelle expérience du signataire, introduit de nouvelles API pour l'administrateur d'entreprise, et bien plus encore. Pour une liste complète des mises à jour du produit, consultez la note de mise à jour 11.44. Consultez également notre Trust Center pour connaître les dates de déploiement de tous nos environnements.

Dans ce blog, nous allons explorer le champ de case à cocher réorganisé, montrer comment ces changements peuvent faciliter vos cas d'utilisation, puis vous présenter les API améliorées pour la fonctionnalité de sous-compte. Sans plus attendre, commençons !

Cases à cocher groupées

"Je souhaite concevoir une question à choix multiples et permettre à mon signataire de sélectionner une réponse à partir d'une liste de choix définie lors de la cérémonie de signature

Cette exigence peut être définie lors de la conception de la mise en page du document. OneSpan Sign répond à cette exigence en améliorant le champ des cases à cocher et en permettant à l'expéditeur d'associer plusieurs cases à cocher à un groupe. Examinez la capture d'écran ci-dessous :

10-06-1

En coulisses, le JSON de la signature ressemble à ceci :

{
  "role" : "Signer1",
  "name" : "Signature1",
  "fields" : [
    {
      "validation" : {
        "group" : "PreferredLanguage",
        "required" : vrai
      },
      "page" : 0,
      "extract" : faux,
      "width" : 12,
      "height" : 12,
      "left" : 405,
      "top" : 218,
      "sous-type" : "CHECKBOX",
      "type" : "INPUT",
      "name" : "Portugais"
    },
    {
      "validation" : {
        "group" : "PreferredLanguage",
        "required" : vrai
      },
      "page" : 0,
      "extract" : faux,
      "width" : 12,
      "height" : 12,
      "left" : 405,
      "top" : 218,
      "sous-type" : "CHECKBOX",
      "type" : "INPUT",
      "name" : "Français"
    },
    {
      "validation" : {
        "group" : "PreferredLanguage",
        "required" : vrai
      },
      "page" : 0,
      "extract" : faux,
      "width" : 12,
      "height" : 12,
      "left" : 405,
      "top" : 218,
      "sous-type" : "CHECKBOX",
      "type" : "INPUT",
      "name" : "Italien"
    }
  ]
}

En appliquant la règle de validation et en définissant le groupe dans "documents" > "approvals" > "fields" > "validation" > "group", toutes les cases à cocher du même groupe seront associées ensemble. En outre, si une case à cocher du même groupe est marquée comme obligatoire, le signataire doit sélectionner au moins une option du groupe lors de la signature.

Remarque :

  • La logique conditionnelle sur un groupe de cases à cocher n'est pas prise en charge.
  • La prise en charge du SDK n'est pas encore disponible. Elle sera ajoutée dans une prochaine version.
  • L'extraction n'est pas encore disponible. Elle sera ajoutée dans une prochaine version.
  • Cette fonctionnalité n'est pas encore 100% compatible avec les normes ADA. Elle sera ajoutée dans une prochaine version.
  • Les points (".") ne sont actuellement pas pris en charge dans les noms de groupes de cases à cocher. Ce problème sera résolu dans une prochaine version.

API remaniées pour l'administration d'entreprise

L'administration d' entreprise est disponible depuis un certain temps, et l'équipe OneSpan Sign continue de travailler dur pour améliorer la fonctionnalité afin de faciliter davantage de cas d'utilisation d'intégration. Dans cette version, nous avons réorganisé et introduit de nouvelles API qui ajoutent de la flexibilité pour identifier et attribuer les rôles de compte à un utilisateur. Avant d'essayer ces nouvelles API, assurez-vous que

  • La fonction "Rôles et permissions" est activée sur votre compte.
  • L'utilisateur de l'API doit avoir un rôle d'administrateur ou un rôle avec les permissions "API Access" et "User Management".

Attribuer des rôles de compte

Avant la version 11.44, selon que le compte a activé ou non la fonction Sous-compte, les utilisateurs Admin doivent invoquer l'une des deux API ci-dessous afin d'attribuer des rôles de compte à un expéditeur :

POST /api/account/senders/{senderId}/account/{accountId}/roles 
POST /api/account/senders/{senderId}/roles

Afin de fournir une expérience d'intégration plus cohérente, ces deux API ont été réorganisées et unifiées dans le même point de terminaison :

Requête HTTP

POST /api/account/senders/{senderId}/roles

En-têtes HTTP

Authorization : Basic api_key / Bearer access_token
Content-Type : application/json

Exemple de requête :

{ 
    "accountId" : "Us1VqQw3r3kN",
    "accountRoles" : [ {"id" : "owner"}, {"id" : "member"}]
}

Remarque :

  • Il n'est pas recommandé d'utiliser en permanence l'ancien schéma de l'API
  • Si la fonction Sous-compte est activée sur votre compte, le "accountId" dans le payload est l'endroit où vous voulez que cet expéditeur ait accès. Sinon, il n'est pas obligatoire de fournir le "accountId".
  • Pour le tableau "accountRoles", vous devez fournir au moins l'identifiant du rôle du compte pour chaque nœud
  • Le détenteur de la clé/du jeton API ne peut pas mettre à jour les rôles de compte lui-même

Récupérer les rôles de compte

Pour demander le rôle de compte d'un expéditeur spécifique, utilisez les deux API ci-dessous :

Requête HTTP

GET /api/account/senders/{senderId}/roles

En-têtes HTTP

Authorization : Basic api_key / Bearer access_token
Accept : application/json

Exemple de réponse :

[
  {
    "accountId" : "Us1VqQw3r3kN",
    "accountRoles" : [
      {
        "permissions" : [
          "templates_layouts.share_templates",
          "transaction.in_person",
          "transaction.change_signer",
          "templates_layouts.share_layouts",
          "transaction.transaction"
        ],
        "enabled" : vrai,
        "description" : "esl.account.account_role.default_role.member.description",
        "predefined" : true,
        "inherited" : faux,
        "id" : "membre",
        "name" : "esl.account.account_role.default_role.member.name"
      }
    ],
    "userId" : "cE01BlwKLpYI"
  }
]

Remarque :

  • L'API s'adapte aux deux scénarios, que votre compte ait ou non la fonction Sous-compte activée. Le tableau de réponse renverra plusieurs nœuds s'il y a des sous-comptes.
  • Le schéma de réponse de l'API a été modifié par rapport aux versions antérieures à la 11.44. Il se peut donc que vous deviez adapter votre code si vous avez déjà intégré cette API.

Conclusion

Nous y voilà. Dans ce blog, nous avons montré comment utiliser la case à cocher pour concevoir des questions à choix multiples et nous vous avons présenté les API nouvellement introduites pour la fonction d'administration d'entreprise. 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 !

Duo Liang
Duo Liang
Haut de page
Partager