Liste campos de formulario PDF: nombres, tipos y valores

Esta capacidad lee dicha estructura y devuelve un inventario claro de todos los campos, con su nombre completo, el tipo reconocido y el valor actual. Admite los controles AcroForm habituales en solicitudes, cuestionarios, aprobaciones y documentos de registro. El procesamiento es determinista y local: no hay solicitudes de red, conjeturas de modelos ni resultados aleatorios. Si el archivo no es un PDF, está dañado o carece de campos, la solicitud devuelve un error de entrada claro en vez de un resultado vacío que podría confundirse con un éxito.

Examine la estructura real de un formulario PDF

Los formularios PDF interactivos almacenan sus controles por separado de las palabras y líneas dibujadas en cada página. Un campo puede tener un nombre interno como customer.address.postcode aunque la página solo muestre la etiqueta «Código postal». Esta capacidad sigue el catálogo del documento hasta su diccionario AcroForm, recorre el árbol de campos, aplica las propiedades heredadas y devuelve los campos terminales en el orden del documento. Cada resultado contiene el nombre completo, un tipo normalizado y el valor guardado actualmente en el PDF. Distingue cuadros de texto, casillas, grupos de opciones, listas desplegables, listas de selección, botones y campos de firma mediante el tipo y los indicadores definidos por el documento. Los nombres jerárquicos se unen con puntos para evitar ambigüedades entre controles parecidos de secciones diferentes. Así, la salida sirve como inventario de esquema legible por máquinas y no como una simple extracción del texto visible. Una casilla sin valor activo aparece como false y una firma pendiente se identifica sin afirmar que existe una firma.

Envíe el documento e interprete la respuesta

Envíe el PDF en el parámetro pdf como base64 simple o como una URL de datos application/pdf en base64. El analizador valida primero la codificación y la cabecera PDF; después lee los objetos indirectos necesarios para localizar el catálogo y el árbol de campos. La respuesta incluye fields, una matriz de registros, y count, el número de campos devueltos. Los tipos emplean nombres prácticos como TextField, CheckBox, RadioGroup, Dropdown, OptionList, PushButton y Signature. Los valores actuales conservan cadenas y matrices cuando así los almacena el PDF, mientras que el estado de una casilla se devuelve como booleano. Los controles de texto vacíos utilizan una cadena vacía, lo que permite distinguirlos de los campos ausentes. No confunda la etiqueta visible junto a un control con su nombre: solo la definición interna determina el nombre devuelto. La capacidad genera un error deliberadamente cuando no hay campos, para que su automatización detecte un PDF aplanado, un formulario escaneado o un adjunto equivocado. El tamaño admitido está limitado para que el análisis sea predecible.

Use el inventario de forma segura en sus flujos

Un inventario de campos es un primer paso útil antes de rellenar, validar, migrar o auditar formularios PDF. Por ejemplo, un sistema de altas puede comparar los nombres devueltos con las claves de su base de datos antes de intentar completar una plantilla. Un proceso de control de calidad puede confirmar que una versión revisada conserva los campos obligatorios y que sus tipos no han cambiado. Una migración de archivo puede registrar los valores incluidos en cada documento interactivo antes de aplanarlo para su conservación. Como el algoritmo no contacta servicios externos ni deduce valores a partir de la apariencia de la página, solicitudes con bytes idénticos producen el mismo JSON. Esta previsibilidad resulta importante para pruebas y auditorías. No obstante, se trata de un lector de estructuras AcroForm, no de reconocimiento óptico: un escaneo contiene píxeles, pero no campos interactivos, y genera el error correspondiente. Tampoco modifica, aplana, firma, descifra ni repara documentos. Prepare previamente los archivos cifrados o aquellos cuyos objetos de formulario no puedan leerse.