Les pièces jointes du document, à côté de ses pages

Joignez des fichiers entiers au PDF — les données dont une facture est tirée, le même relevé sous une autre forme — chacun nommé, décrit et daté.

Le résultat dans un vrai PDF

Relevés de compteur en PDF/A-3u avec leur tableau joint

Les relevés de compteur d’un trimestre, qu’une personne lit sur la page et qu’un logiciel de facturation reprend dans le tableau joint au même fichier.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Relevé de compte en PDF/A-4f avec ses données jointes · Trois relevés dans un seul fichier · Barème de frais balisé en PDF/A-3a

Résumé

Un PDF peut contenir des fichiers, comme une enveloppe contient une lettre et un formulaire. Qui ouvre le document voit la liste de ce qu’il contient et peut en enregistrer n’importe lequel. C’est ce qui fait marcher une facture électronique : les pages sont la facture que lit une personne, et le fichier qu’il contient est la même facture sous une forme que lit un programme, si bien que les deux ne peuvent jamais dire des choses différentes. Ce qui compte le plus sur chaque pièce jointe, c’est ce qu’elle est pour le document : le fichier à partir duquel le document a été créé, la même chose dite autrement, ou quelque chose qu’on y a ajouté.

Techniquement

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

attachments écrit les fichiers que le document contient à côté de ses pages dans l’arbre de noms /EmbeddedFiles et les associe au document par /AF, chacun sous le nom que la requête lui donne, dans l’ordre où ils sont rangés. Les octets eux-mêmes arrivent à côté de la requête, dans une partie qui a ce nom. relationship est l'/AFRelationship du fichier ; elle n’a pas de valeur par défaut et elle est obligatoire : personne d’autre que l’expéditeur ne sait si le fichier est la source à partir de laquelle le document a été créé, une variante qui dit la même chose sous une autre forme, les données qui le sous-tendent, ou un complément. modified est la /ModDate des /Params du fichier : la date à laquelle les données du fichier ont été touchées pour la dernière fois, non la date de création du PDF. Une page revendique par page_files les fichiers qui lui appartiennent, et un document d’archivage les contient selon les règles que fixe sa norme.

Schéma de la requête

attachments — tableau, facultatif, vide par défaut.
attachments[].name — chaîne, obligatoire. Le nom de la partie fournie qui contient le fichier, et aussi le nom sous lequel le reste de la requête le désigne.
attachments[].file_name — chaîne, obligatoire. Le nom sous lequel le fichier est joint, et le nom que le logiciel de lecture propose pour l’enregistrer.
attachments[].description — chaîne, obligatoire. Ce qu’est le fichier, en mots, pour la personne qui lit la liste de ce que le document contient.
attachments[].media_type — chaîne, obligatoire. Le type de contenu du fichier : text/xml pour un document XML.
attachments[].relationship — chaîne, obligatoire, sans valeur par défaut. L’une de source, alternative, data, supplement, unspecified.
attachments[].modified — chaîne, obligatoire, horodatage ISO 8601. La date à laquelle les données du fichier ont changé pour la dernière fois, non la date de création du PDF.
attachments[].thumbnail — chaîne, facultative, absente par défaut. Le nom de l’image fournie que le logiciel de lecture affiche en vignette de ce fichier dans sa liste des pièces jointes ; elle est écrite dans l’entrée /Thumb de la spécification de fichier. L’image doit être en niveaux de gris, en rouge-vert-bleu ou en palette de l’un de ces deux espaces de couleurs, sinon la requête est refusée ; un nom sous lequel aucune image n’a été fournie est refusé lui aussi. Ce champ exige PDF 2.0.
attachments[].unlisted — booléen, facultatif, false par défaut. Avec true, le fichier n’apparaît pas dans la liste des pièces jointes du document, et le logiciel de lecture ne l’y propose donc pas. Il reste pourtant inclus dans le document et rattaché aux éléments qui y renvoient ; toute action du document qui l’ouvrirait est refusée.
attachments[].folder — entier, facultatif. Le numéro du dossier de collection.folders dans lequel le fichier est rangé ; si la clé est absente, le fichier est rangé dans le dossier racine. Un numéro qu’aucun dossier ne déclare est refusé, tout comme un dossier donné à un fichier marqué unlisted.

Portée : le document entier. page_files dit quelles pages revendiquent lesquels de ces fichiers ; un fichier qu’aucune page ne revendique est rattaché au document lui-même.

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

{
  "attachments": [
    {
      "name": "statement_4711",
      "file_name": "statement-4711.xml",
      "description": "The statement as a data file",
      "media_type": "text/xml",
      "relationship": "data",
      "modified": "2026-08-03T09:15:00+02:00"
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["A page, and a data file carried beside it"],
      "font": "sans",
      "font_size": 12
    }
  ]
}

La ligne qui l’envoie, en trois langages

Le document dans son ensemble

Les numéros que montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Ce que le document dit de lui-même, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse pour lui-même Les notes qu’un programme laisse sur une page Les données qu’un programme accroche à un passage d’encre Un fichier encore lisible dans des dizaines d’années La norme d’impression que le document déclare La norme d’impression variable déclarée par le document Le mot de passe qui l’ouvre, et ce qu’on peut en faire Une facture qu’un humain et une machine lisent L’adresse à partir de laquelle se lisent les liens relatifs La version de PDF que le fichier déclare Les extensions de PDF dont le fichier dit se servir Ce qu’une image dit d’elle-même, et comment elle est lue Des fichiers que le document nomme sans les contenir Les pièces jointes, présentées en portefeuille Les pièces jointes que revendique une page Les pièces jointes que revendique une police La fiche d’identité propre à une police Les pièces jointes que revendique la fiche du document Une fiche de document rédigée ailleurs Les zones d’une page où un lecteur mesure La fiche d’identité que contient une seule page La norme d’accessibilité que le document déclare Les normes contre lesquelles le document fini est mesuré

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