Les données qu’un programme accroche à un passage d’encre
Accrochez à un passage d’encre de la page une liste de vos propres données, sous le nom de votre choix. Aucun logiciel de lecture ne la montre.
Le résultat dans un vrai PDF
Un bon de livraison qui connaît sa commande
Chaque ligne du bon contient la commande pour laquelle elle a été prélevée, le code article et l’étagère d’où elle vient, et n’imprime rien de tout cela. L’endroit où le chauffeur signe contient la tournée et la camionnette, et un autre, à côté du repère de pliage, ne contient rien que son propre emplacement.
Résumé
Un entrepôt imprime une liste de préparation, et un scanner la relit ensuite. Ce dont ce scanner a besoin, ce sont les données de commande derrière chaque ligne — la référence de l’article, la quantité — et rien de cela n’a sa place sur le papier. Cela voyage donc sous la ligne plutôt que dessus : vous déclarez la liste une fois, vous l’accrochez à cette ligne, et un programme qui ouvre le fichier plus tard la retrouve exactement à cet endroit. Les noms de la liste sont les vôtres, et rien ici ne les lit.
Techniquement
Écrit au premier niveau d’une requête, sous
"carried_facts"
carried_facts écrit chaque liste comme un dictionnaire, objet à part entière, et le nomme dans les /Properties de chaque page ; un élément qui en nomme une encadre tout ce qu’il dessine entre /Tag /MC1 BDC … EMC. Ce passage ne contient aucun /MCID, si bien que l’arbre de structure n’y désigne rien : facts s’énonce avec tag et jamais à côté de mark : tout manquement à l’une ou l’autre règle est refusé. Une liste est écrite une seule fois, quel que soit le nombre d’éléments qui la nomment, et peut être accrochée à des passages sur autant de pages que le document en compte. Un nom qu’aucune entrée n’a déclaré est refusé avant que rien ne soit dessiné, et un élément placé dans un drawing nommé n’énonce rien de tout cela.
Schéma de la requête
-
carried_facts— tableau, facultatif, vide par défaut. -
carried_facts[].name— chaîne, obligatoire. Le nom par lequel les éléments accrochent cette liste à ce qu’ils dessinent. -
carried_facts[].facts— objet, facultatif, vide par défaut. Les entrées, sous vos propres noms. Une valeur est une chaîne, un nombre entier, un nombre ou un booléen ; rien ici ne les lit. -
Un élément en accroche une à ce qu’il dessine par sa clé
facts, qui contient le nom déclaré ici, à côté dutagsous lequel il ouvre le passage. Un élément sansfactsn’en contient aucune. -
factsà côté demarkest refusé, etfactssanstagl’est aussi : un passage qui contient une liste ne contient aucun numéro, l’arbre de structure ne peut donc rien y revendiquer.
Portée : un passage d’encre. private_data laisse les mêmes sur le document entier, page_private_data sur une page, et drawings[].private_data sur un dessin nommé.
Une requête entière qui crée un PDF
{
"carried_facts": [
{
"name": "Line",
"facts": {
"order": "SO-4417",
"quantity": 3,
"price": 12.5,
"urgent": true
}
}
],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
"content": ["Three widgets, blue"],
"font": "sans",
"font_size": 12,
"tag": "Line",
"facts": "Line"
}
]
}
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 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 Les pièces jointes du document, à côté de ses pages 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