Les fichiers contenus, présentés en portefeuille

Dites comment un logiciel de lecture dispose les fichiers contenus : les colonnes, ce que chaque fichier y met, l'ordre, et quel fichier s'ouvre en premier.

Résumé

Un document peut contenir des fichiers entiers, et un logiciel de lecture à qui l'on n'en dit pas plus montre une liste de noms de fichiers — qui ne dit ni lequel est arrivé quand, ni pour quel montant. Ici, vous donnez le tableau : les colonnes qu'une personne lit en haut, ce que chaque fichier contenu met dans chacune, la colonne sur laquelle les lignes sont triées, et le fichier qui s'ouvre en premier. Trois colonnes ne demandent rien du tout, parce qu'elles sont lues sur le fichier même : le nom sous lequel il est joint, ce qu'il est en mots, quand il a changé pour la dernière fois et sa taille en octets.

Techniquement

Écrit au premier niveau d'une requête, sous "collection"

collection écrit le /Collection du document, son /Schema de colonnes et son /Sort, et les valeurs propres à chaque pièce jointe atteignent le fichier comme le /CI posé à côté de sa spécification de fichier. Les fichiers que porte une collection sont ceux qu'attachments a contenus, et aucun autre. Une colonne se lie par key à la valeur qu'un fichier énonce pour elle, et ce key n'est montré à personne ; data dit ce que la colonne porte, et les quatre sortes lues sur la pièce jointe elle-même — file_name, description, modified, size — ne prennent aucune valeur au fichier : rien ne peut donc le contredire. Un moment s'énonce en ISO 8601, comme tous les moments du schéma, et atteint le fichier écrit comme PDF écrit un moment. Un sort qui nomme une clé qu'aucune colonne ne porte n'est pas refusé : un logiciel de lecture ordonne alors les lignes comme il l'entend. La déclaration porte à 1.7 la version que le document annonce.

Schéma de la requête

collection — objet, facultatif. Absent, les fichiers contenus restent une simple liste de noms.
collection.view — chaîne, facultatif, rows par défaut. Une valeur parmi rows (chaque fichier sur une ligne à lui), tiles (chacun comme une petite image) et hidden (rien de montré tant que le lecteur ne le demande pas).
collection.opens_on — chaîne, facultatif. Le fichier ouvert en premier, par le nom sous lequel il est joint. Absent, c'est le document lui-même qui s'ouvre, et un nom qu'aucune pièce jointe ne porte n'est pas refusé.
collection.columns — tableau, facultatif. Les colonnes du tableau, dans l'ordre où elles se tiennent.
columns[].key — chaîne, exigé. Ce qui lie la colonne à la valeur qu'un fichier énonce pour elle. Personne ne le voit.
columns[].title — chaîne, exigé. L'en-tête que lit une personne.
columns[].data — chaîne, exigé. Une valeur parmi text, date et number, que le fichier énonce, et file_name, description, modified et size, qui sont lues sur la pièce jointe.
columns[].hidden — booléen, facultatif, faux par défaut. Si la colonne reste hors de vue tant que le lecteur ne la demande pas.
collection.sort — objet, facultatif. key, la colonne sur laquelle les lignes sont triées, et ascending, si l'ordre monte. Les deux sont exigés dès que l'objet est là.
attachments[].columns — tableau, facultatif. Ce qu'un fichier énonce, une entrée par colonne : key, et la valeur sous la sorte que porte cette colonne — text, date ou number.

Portée : le document entier. C'est attachments qui contient les fichiers ; ceci ne dit que la façon dont ils sont disposés.

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

{
  "attachments": [
    {
      "name": "lot_a",
      "file_name": "lot-a.xml",
      "description": "Earthworks and site clearance",
      "media_type": "text/xml",
      "relationship": "source",
      "modified": "2026-07-14T09:30:00+02:00",
      "columns": [
        { "key": "lot", "text": "Earthworks and site clearance" },
        { "key": "sent", "date": "2026-07-14T09:30:00+02:00" },
        { "key": "total", "number": 18400 }
      ]
    }
  ],
  "collection": {
    "view": "rows",
    "opens_on": "lot_a",
    "columns": [
      { "key": "lot", "title": "Lot", "data": "text" },
      { "key": "sent", "title": "Sent", "data": "date" },
      { "key": "total", "title": "Total", "data": "number" },
      { "key": "weight", "title": "Bytes", "data": "size", "hidden": true }
    ],
    "sort": { "key": "sent", "ascending": false }
  },
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["Tender pack: the lots travel inside this document"],
      "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 Les notes qu'un programme laisse pour lui-même Les notes qu'un programme laisse sur une page Un fichier encore lisible dans des dizaines d'années La norme d'impression que le document revendique 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 contre laquelle les liens se lisent La version de PDF que le fichier déclare Ce qu'une image dit d'elle-même, et comment elle est lue Les pièces jointes du document, à côté de ses pages Les pièces jointes d'une page 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