L'emplacement réservé à une signature

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

C'est l'emplacement réservé en bas d'un contrat, celui où la signature viendra se poser. Le document sort avec la place prête et nommée ; la signature elle-même est apposée ensuite, par le logiciel du signataire ou par votre chaîne de signature. Vous choisissez l'endroit, la taille du cadre, et l'encadrement qui le rend visible à l'écran. C'est ce qui permet d'envoyer un contrat déjà prêt à signer, sans passer par l'imprimante.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

Le champ est une annotation de signature vide, nommée, posée par-dessus ce que les autres articles ont dessiné. Il se contente des pages déjà là, et le rendu en dessine ce que l'encadrement demande. La requête en dit le nom, le rectangle et les réglages communs à tous les champs ; ce qui se rattache ensuite à cet emplacement — certificat, horodatage, apparence signée — relève de l'étape de signature qui suit le rendu. À VÉRIFIER : ce que la chaîne de signature du serveur attend exactement d'un champ ainsi posé.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

Clés obligatoires : name, chaîne ; rect. Facultatives, communes à tous les champs : read_only, required, no_export, booléens à false ; background, couleur du fond ; border, objet à width obligatoire, color (défaut noir, exprimée en lumière) et style valant "solid" (défaut), {"dashed": {"lengths": …}}, "beveled", "inset" ou "underline" ; pages, tableau d'entiers en base 1, défaut vide ; relative_to. Refus croisé : une couleur CMJN ou d'un espace nommé dans border.color. C'est le champ le plus court du schéma : il porte son nom, sa boîte et l'apparence de son cadre.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "items": [
    {
      "type": "signature_field",
      "name": "signature",
      "rect": {"llx": 72, "lly": 120, "urx": 272, "ury": 180},
      "border": {"width": 0.75}
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

CMJN

Les quatre encres d'une imprimerie : le cyan (un bleu), le magenta (un rose), le jaune et le noir. Un écran, lui, fabrique ses couleurs avec de la lumière. Un document qui part à l'impression dit donc ses couleurs en encres, et non en couleurs d'écran.

signature

Un cachet posé à l'intérieur du document. Il prouve deux choses d'un coup : qui l'a approuvé, et que rien n'y a changé depuis. Le logiciel qui ouvre le fichier l'annonce dans un bandeau, en haut de la page.

requête

Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.

serveur

Une machine qui attend des appels et y répond, jour et nuit, sans personne devant elle. Celle qui dessine les documents ici porte le moteur et rend les pages finies ; celle où tourne votre site est une autre machine qui fait le même genre de travail.

annotation

Quelque chose posé sur une page plutôt que dessiné dedans : un rectangle cliquable, une case où taper, un bouton. Cela occupe sa propre place sur la feuille et c'est ce qui fait qu'un PDF répond à un clic.

Tous les mots que le site explique