L'ordre du passage d'un champ au suivant

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Sur un formulaire à remplir à l'écran, une touche du clavier fait sauter d'une case à la suivante. Encore faut-il savoir laquelle est « la suivante ». Sur un formulaire en deux colonnes, on peut vouloir descendre toute la colonne de gauche avant de passer à celle de droite, ou bien traverser la page ligne par ligne. On le dit ici, page par page, et le lecteur suit.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

page_tab_orders fixe, page par page, l'ordre dans lequel un lecteur parcourt tout ce qu'une page porte en annotations : ses liens, ses champs de formulaire et le reste. Cinq ordres existent, dont deux sont arrivés tard dans le format et demandent que le document déclare la version 2.0. Une page qu'aucune entrée ne nomme laisse l'ordre au lecteur ; dans un document balisé, une page portant un lien ou un champ déclare d'elle-même l'ordre de la structure.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

• page_tab_orders — tableau, facultatif, vide par défaut.
• page_tab_orders[].page — entier ≥ 1, obligatoire. La page visée.
• page_tab_orders[].order — chaîne, obligatoire. Cinq valeurs : row (en travers de la page, puis vers le bas), column (vers le bas, puis en travers), structure (l'ordre dans lequel l'arbre de structure lit la page), annotations (l'ordre dans lequel la page liste ses annotations), widgets (le même, les champs d'abord).
• annotations et widgets demandent "version": "2.0" sur la requête ; sinon le rendu est refusé plutôt que d'écrire un ordre que la version déclarée ne saurait porter.

Une entrée dit comment une page est parcourue, pas qu'il y en a une. Une page nommée deux fois prend le dernier ordre écrit pour elle.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "page_tab_orders": [{ "page": 1, "order": "row" }],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 760 },
      "content": ["Two links, walked across the page"],
      "font": "sans",
      "font_size": 12
    },
    {
      "type": "link",
      "rect": { "llx": 60, "lly": 700, "urx": 160, "ury": 720 },
      "to": { "uri": "https://hqf-pdf.com/" }
    },
    {
      "type": "link",
      "rect": { "llx": 200, "lly": 700, "urx": 300, "ury": 720 },
      "to": { "uri": "https://hqf-pdf.com/en/" }
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

PDF balisé

Un PDF qui range son texte en plus de le dessiner : ceci est un titre, ceci un tableau, cette case appartient à cette colonne. C'est ce qui permet au logiciel qui lit à voix haute, ou au programme qui récupère les chiffres, de comprendre la page.

requête

Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.

annotation

Quelque chose posé sur une page plutôt que dessiné dedans : un rectangle cliquable, une case où taper, un bouton. Cela occupe sa propre place sur la feuille et c'est ce qui fait qu'un PDF répond à un clic.

champ de formulaire

Une case posée sur une page de PDF que l'on peut remplir, cocher ou choisir, et dont le fichier garde la réponse. Elle porte un nom, si bien que celui qui récupère le fichier relit les réponses par leur nom plutôt qu'en regardant la page.

Tous les mots que le site explique