Plusieurs signatures pour un participant
Montrer la signature d'un participant sur plusieurs pages, sur plusieurs documents, ou là où un champ l'attend dans le texte.
Un participant qui signe signe tous les documents à signer du parcours. L'encart de sa signature — son nom, la date, le sceau — se pose par des emplacements : un ou plusieurs par document, chacun pouvant se répéter sur plusieurs pages.
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-F 'Transaction={"Name":"Contrat avec Atelier Lumière","TransactionFiles":[{"FriendlyName":"Contrat","Name":"Contrat de prestation"},{"FriendlyName":"CGV","Name":"Conditions générales"}],"TransactionMembers":[{"FriendlyName":"Client","MemberRole":0,"SignMode":1}]}' \
-F "Client=00000000-0000-4000-8000-000000000201" \
-F "Contrat=@contrat-atelier-lumiere.pdf;type=application/pdf" \
-F "CGV=@conditions-generales.pdf;type=application/pdf" \
-F 'Client,Contrat={"Pages":"1;8","Coordinates":"50,30,180,100"}' \
-F 'Client,CGV={"Pages":"TXT","Coordinates":"0,0,180,60"}'Sur plusieurs pages d'un document
Pages répète l'encart, aux mêmes coordonnées : 1;8 sur les pages 1 et 8, 2-4 de la page 2 à la page 4, -1 sur la dernière
page, ALL sur toutes. Voir Poser une signature visuelle pour la grammaire
entière.
Là où le texte l'attend
Un document peut porter, dans son texte, le champ {{TransactionMember[Client]_Signature}} — l'identifiant convivial du participant
entre crochets. À la préparation de la signature, le champ est effacé et l'encart se pose à sa place : son coin inférieur gauche au
début du champ, sur sa ligne. Sa taille est celle de l'emplacement "Pages":"TXT" — seules sa largeur et sa hauteur comptent —,
sinon 180 × 100 points.
Le champ peut s'écrire en blanc sur blanc, pour rester invisible à l'impression. L'ancienne forme, {{Contact[Client]_Signature}},
est encore reconnue.
Les pièges
- Plusieurs emplacements pour un même document — une liste, ou un emplacement et un champ dans le texte — dessinent chacun leur encart : une seule signature, montrée à chaque place. Des coordonnées différentes d'une page à l'autre s'écrivent par plusieurs emplacements.
- Si le champ apparaît plusieurs fois dans le texte, chaque occurrence reçoit l'encart.
- Le champ se cherche dans le texte du PDF : un document scanné, sans texte, ne le porte pas.