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.
Résumé
Un entrepôt imprime une liste de préparation, et un lecteur de codes la relit ensuite. Ce dont ce lecteur a besoin, c'est de la ligne de commande derrière chaque rangée — 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 rangée plutôt que dessus : vous déclarez la liste une fois, vous l'accrochez à la rangée, 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 porte 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, et l'inverse est refusé tout autant. 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 porte aucune. -
factsà côté demarkest refusé, etfactssanstagl'est aussi : un passage qui porte une liste ne porte aucun numéro, l'arbre de structure ne peut donc rien y réclamer.
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 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, présentées en portefeuille 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