Listez les champs PDF : noms, types et valeurs

Cette capacité lit cette structure et renvoie un inventaire clair de tous les champs, avec leur nom complet, leur type reconnu et leur valeur actuelle. Elle prend en charge les contrôles AcroForm courants des demandes, questionnaires, validations et dossiers d’inscription. Le traitement est déterministe et local : aucun appel réseau, aucune estimation par modèle et aucun résultat aléatoire. Si le fichier n’est pas un PDF, s’il est endommagé ou s’il ne contient aucun champ, la requête renvoie une erreur explicite plutôt qu’un résultat vide pouvant être pris pour un succès.

Examinez la structure réelle du formulaire PDF

Les formulaires PDF interactifs stockent leurs contrôles séparément des mots et des lignes dessinés sur les pages. Un champ peut porter le nom interne customer.address.postcode alors que la page affiche seulement « Code postal ». Cette capacité suit le catalogue jusqu’au dictionnaire AcroForm, parcourt l’arborescence des champs, applique les propriétés héritées et renvoie les champs terminaux dans l’ordre du document. Chaque résultat contient le nom complet, un type normalisé et la valeur enregistrée dans le PDF. Les zones de texte, cases à cocher, groupes de boutons radio, listes déroulantes, listes d’options, boutons et signatures sont distingués grâce au type et aux indicateurs du document. Les noms hiérarchiques sont reliés par des points afin que des contrôles semblables situés dans différentes sections restent sans ambiguïté. La sortie constitue donc un inventaire de schéma exploitable par une machine, et non une simple extraction du texte visible. Une case sans valeur active est indiquée par false, et un champ de signature vide est signalé sans prétendre qu’une signature existe.

Envoyez le document et interprétez la réponse

Transmettez le PDF dans le paramètre pdf sous forme de base64 brut ou d’URL de données application/pdf encodée en base64. L’analyseur vérifie d’abord l’encodage et l’en-tête PDF, puis lit les objets indirects nécessaires pour trouver le catalogue et l’arborescence des champs. La réponse comprend fields, un tableau d’enregistrements, et count, le nombre de champs renvoyés. Les types utilisent des noms pratiques comme TextField, CheckBox, RadioGroup, Dropdown, OptionList, PushButton et Signature. Les valeurs conservent les chaînes et tableaux du PDF, tandis que l’état d’une case devient un booléen. Les contrôles textuels vides utilisent une chaîne vide et se distinguent ainsi des champs absents. Ne confondez pas l’étiquette imprimée près d’un contrôle avec son nom interne : seule la définition du formulaire détermine le nom renvoyé. Une erreur est volontairement produite lorsqu’aucun champ n’existe, afin que votre automatisation repère un PDF aplati, un formulaire numérisé ou une mauvaise pièce jointe. La taille admise est limitée pour garantir un traitement prévisible.

Utilisez cet inventaire dans vos flux documentaires

L’inventaire des champs constitue une bonne première étape avant de remplir, valider, migrer ou auditer un formulaire PDF. Un système d’intégration peut, par exemple, comparer les noms renvoyés aux clés de sa base de données avant de remplir un modèle. Un contrôle qualité peut vérifier qu’une nouvelle version conserve les champs obligatoires et que leurs types n’ont pas changé. Une migration d’archives peut consigner les valeurs incluses dans chaque document interactif avant son aplatissement. Comme l’algorithme ne contacte aucun service externe et ne déduit rien de l’apparence des pages, des octets identiques produisent toujours le même JSON. Cette stabilité est précieuse pour les tests et les pistes d’audit. Il s’agit toutefois d’un lecteur de structures AcroForm, et non d’un outil de reconnaissance optique : la numérisation d’un formulaire papier contient des pixels, mais aucun champ interactif, et provoque donc l’erreur prévue. La capacité ne modifie, n’aplatit, ne signe, ne déchiffre et ne répare aucun document. Préparez au préalable les fichiers chiffrés ou illisibles.