Validar campos obligatorios y valores de formularios PDF

Valide los datos destinados a un formulario PDF antes de iniciar el llenado del documento. Proporcione las definiciones de los campos y un objeto de valores; esta capacidad comprobará campos obligatorios, tipos exactos, fechas reales, opciones permitidas, definiciones duplicadas y claves inesperadas. Si todo coincide, devolverá un conjunto limpio de valores validados.

Defina con claridad el contrato del formulario

Comience describiendo cada campo del formulario PDF mediante un nombre único, un tipo admitido y una marca opcional de obligatoriedad. Los tipos disponibles abarcan texto, números finitos, enteros, booleanos, fechas de calendario ISO, selecciones únicas y selecciones múltiples. Los campos de selección también necesitan una lista de opciones, de modo que el validador pueda distinguir una opción aprobada de una cadena arbitraria.

Las definiciones constituyen el contrato del objeto de valores: cada valor suministrado debe corresponder a una definición, y se rechazan los nombres duplicados porque harían ambigua la validación. Use exactamente los nombres de campo que espera la operación posterior de llenado del PDF, incluidas las mayúsculas. Esta capacidad no inspecciona el PDF ni intenta adivinar sus campos.

Separar la detección de campos de la validación facilita las pruebas y permite reutilizar el mismo contrato con muchos registros. Si se omite la marca de obligatoriedad, su valor predeterminado es falso; un campo obligatorio debe contener un valor significativo. En campos de texto, un contenido compuesto únicamente por espacios se considera ausente.

Comprenda la validación estricta de valores

Los valores se comprueban sin conversiones automáticas. Un booleano debe ser true o false, no "yes", 1 ni 0. Las fechas utilizan el formato inequívoco YYYY-MM-DD y deben representar un día real del calendario; por ello, una entrada como 2025-02-29 se rechaza.

El valor de una selección debe coincidir exactamente con una de las cadenas declaradas, respetando mayúsculas y minúsculas. Una selección múltiple debe ser un array de cadenas únicas permitidas; las opciones repetidas o desconocidas provocan un error. Este rigor detecta fallos de correspondencia antes de que produzcan documentos sutilmente incorrectos.

Las mismas representaciones vacías generan un error si el campo es obligatorio. La operación se detiene ante el primer problema y devuelve una incidencia concreta que un formulario o proceso puede mostrar al usuario.

Valide antes de generar el PDF

Use esta capacidad justo después de relacionar los datos de la aplicación con los nombres de los campos PDF y antes de llamar a una herramienta que escriba en el documento. Una respuesta correcta incluye valid true, el número de definiciones examinadas, los valores aceptados y los campos opcionales que no se proporcionaron. Las claves desconocidas se rechazan porque un nombre mal escrito podría desaparecer silenciosamente durante el llenado del PDF.

Esto resulta especialmente útil en procesos por lotes, donde una correspondencia errónea puede afectar cientos de documentos. Guarde las definiciones junto con la versión de la plantilla, valide cada registro contra esa versión y envíe al llenado únicamente los registros correctos. El algoritmo se ejecuta localmente, sin red, aleatoriedad, inferencia de modelos ni estado almacenado, por lo que una misma entrada siempre produce el mismo resultado.