Le modèle sous les pages

Mettre les pages du document sur un PDF déjà créé : un papier à en-tête, un fond de contrat, une feuille de signature.

Le résultat dans un vrai PDF

Un tableau qui se pagine tout seul

Un long tableau confié d’un bloc, qui décide lui-même de son découpage en pages : son en-tête en haut de chaque page, sa note en bas de chaque page, la cellule d’un trimestre qui couvre ses lignes et se répète en haut de la page suivante quand une page la coupe, et une mention que l’on place soi-même sous chaque page, à l’endroit exact que le tableau indique.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Un contrat bâti sur trois modèles fournis

Résumé

Beaucoup d’entreprises ont du papier à en-tête : le logo en haut, l’adresse en bas, et un grand blanc au milieu pour écrire. Ici c’est la même chose, en numérique, et vous pouvez même en fournir trois : un pour la première page, un pour les pages du milieu, un pour la dernière — la page de signature, par exemple.

Techniquement

Écrit au premier niveau d’une requête, sous "templates"

templates nomme jusqu’à trois PDF modèles apposés sous les pages, selon la position de la page : le début, le milieu, la fin. Les octets de chaque modèle arrivent à côté de la requête, dans une partie de formulaire qui a exactement ce nom, prise dans le même vivier que les pages placées. Le modèle du milieu ne comprend qu’une seule page, répétée autant de fois qu’il le faut ; ceux du début et de la fin peuvent en compter plusieurs. Les trois clés sont facultatives : une requête peut n’en donner qu’une.

Schéma de la requête

  • templates — objet, facultatif, absent par défaut.
  • templates.start — chaîne, facultative. Le nom de la partie fournie qui contient le modèle posé sous les premières pages du document.
  • templates.middle — chaîne, facultative. Le nom de la partie fournie qui contient le modèle d’une seule page posé sous les pages entre la première et la dernière. Un modèle de plusieurs pages est refusé ici.
  • templates.end — chaîne, facultative. Le nom de la partie fournie qui contient le modèle posé sous les dernières pages du document.
  • templates.fields — objet, facultatif, absent par défaut. Si les champs de formulaire qu’une page modèle apporte sont reposés sur chaque page dont elle forme le fond, là où elle les montre : font, obligatoire, le nom de la police dans laquelle s’écrit un champ de texte, une liste de choix ou un bouton qu’elle apporte ; font_size, obligatoire, leur taille, en points. Absent, un modèle n’apporte que son dessin.
  • templates.redact — tableau, facultatif, vide par défaut. Les zones retirées des pages modèles, chacune décrite par un objet : template, obligatoire, le nom du modèle tel que l’une des positions le désigne ; page, obligatoire, la page de ce modèle, numérotée à partir de 1 ; llx, lly, urx, ury, obligatoires, les bords de la zone en points, mesurés sur la page modèle ; fill, facultatif, la couleur qui remplit la zone vidée. Absent, la zone reste vierge.

Chaque nom désigne une partie du corps multipart/form-data, à côté de json_data. Un nom qui ne correspond à aucune partie est refusé. Une page importée d’un autre document en cours de page se fait par un élément pdf_page, qui puise dans le même vivier de parties fournies.

Un modèle n’est écrit qu’une fois dans le document, quel que soit le nombre de pages qui le reçoivent : chacune de ces pages renvoie au même objet. En poser un sous cent pages ne copie pas ses octets cent fois.

Le contenu qui ne tient pas continue tout seul sur la page suivante, comme le font déjà un tableau et un texte au fil, et le modèle du milieu est posé sous chacune des pages qu’il occupe.

Ce qui se trouve sous une zone de templates.redact — texte, images, formes — est supprimé du fichier créé, et pas seulement masqué : personne ne peut le retrouver, ni à l’écran ni par programme. Une demande qui nomme un modèle qu’aucune position ne désigne, ou une page que ce modèle n’a pas, est refusée.

Une page reprise d’un autre document qui montre plus de dix mille mots est refusée à une requête sans clé de licence. En dessous de ce seuil, la page entre telle quelle, texte compris ; au-dessus, elle n’entre pas. Cette limite est la nôtre, pas une règle du format.

Une requête entière qui crée un PDF

{
  "templates": { "start": "letterhead" },
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 640, "urx": 535, "ury": 700 },
      "content": ["Dear Madam,\nThank you for your order of 4 August."],
      "font": "sans",
      "font_size": 11,
      "leading": 15
    }
  ]
}

La ligne qui l’envoie, en trois langages

La feuille, et ce qu’on pose dessous

La taille des pages Une taille propre à certaines pages L’unité dans laquelle une page est mesurée Où se place la feuille d’une page dans le dessin Les zones que la page déclare Les formes posées sur ce qu’une page dessine Dans quel sens une page s’affiche Comment une page arrive, et combien de temps elle reste Un PDF que vous envoyez, pris comme pages du document Jusqu’où un PDF fourni a le droit de se déplier Un filigrane posé sur une suite de pages Zones nommées à remplir sur une page

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête

Voir les prix Voir les exemples