Les normes contre lesquelles le document fini est mesuré
Demander que le document fini soit confronté à une norme, et recevoir à côté du fichier ce qui l’en sépare.
Le résultat dans un vrai PDF
Une facture qui demande avant de déclarer
La bibliothèque lit la facture telle qu’elle est et nomme, clause par clause, tout ce qui la sépare de Factur-X. Deux choses font obstacle, puis une, puis plus aucune — et c’est seulement alors qu’un fichier est écrit.
Résumé
Déclarer une norme et la respecter sont deux choses différentes. Ceci demande que le document qui sort soit relu, article par article, au regard des normes que vous nommez — et ce qui l’empêche de les respecter revient à côté du fichier. Un document n’a pas besoin de déclarer une norme pour être confronté à elle : c’est le moyen de savoir ce qu’il lui faudrait pour la respecter.
Techniquement
Écrit au premier niveau d’une requête, sous
"check"
check nomme les normes auxquelles le document fini est confronté. Les constats reviennent dans la réponse, à côté du fichier : x-hqf-findings en donne le nombre, x-hqf-finding les contient. Un serveur que vous hébergez répète cet en-tête une fois par constat ; le service que nous exploitons ne l’envoie qu’une fois, ses valeurs séparées par des virgules. Vérifier chaque article d’une norme prend du temps : rien n’est donc mesuré sans demande, et une liste vide ne mesure rien. Les valeurs sont pdfa1b, pdfa1a, pdfa2b, pdfa2u, pdfa2a, pdfa3b, pdfa3u, pdfa3a, pdfa4, pdfa4f, pdfua1, pdfua2, pdfx4, wtpdf_reuse et wtpdf_accessibility.
Schéma de la requête
-
check— tableau de chaînes, facultatif, vide par défaut. -
pdfa1b— ISO 19005-1 niveau B.pdfa1a— la même partie au niveau A, qui réclame la structure en plus. -
pdfa2b— ISO 19005-2 niveau B.pdfa2u— la même partie au niveau U, qui demande que chaque lettre dessinée renvoie à son caractère.pdfa2a— la même partie au niveau A, qui réclame la structure en plus. -
pdfa3b— ISO 19005-3 niveau B.pdfa3u— la même partie au niveau U.pdfa3a— la même partie au niveau A, qui réclame la structure en plus. -
pdfa4— ISO 19005-4.pdfa4f— la même partie, au niveau qui contient des fichiers de tout type. -
pdfua1— ISO 14289-1.pdfua2— ISO 14289-2. -
pdfx4— ISO 15930-7. -
wtpdf_reuse— Well-Tagged PDF 1.0, à son niveau pour la réutilisation.wtpdf_accessibility— la même norme, à son niveau pour l’accessibilité. Le constat de l’une ou l’autre cite l’article sous le numéro que lui donne Well-Tagged PDF, identique à celui que la norme ISO 14289-2 donne à la même exigence ; le niveau pour la réutilisation omet les exigences propres au niveau pour l’accessibilité.
Mesurer n’est pas déclarer : ce qu’un document dit être vient de archive, accessible et print. Un document mesuré au regard d’une norme qu’il n’a jamais déclarée revient tout de même avec le fichier.
Une requête entière qui crée un PDF
Un nom ci-dessous tient lieu de fichier de police : mettez le fichier encodé à sa place, ou envoyez le fichier lui-même à côté de la description, comme une pièce fournie dans le même appel. Une page contient une vraie police déjà encodée, et sa requête part telle quelle.
{
"archive": "pdfa3b",
"check": ["pdfa3b", "pdfua1"],
"output_intent": { "identifier": "sRGB", "info": "sRGB IEC61966-2.1" },
"metadata": { "title": "A document measured against two standards" },
"fonts": [{ "name": "body", "data": "PASTE_THE_FONT_FILE_BASE64_HERE" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
"content": ["A document measured against two standards at once"],
"font": "body",
"font_size": 14
}
]
}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 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
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