Comprobar accesibilidad estructural en NextPDF Connect (Pro)

De un vistazo

Ejecutar un análisis de accesibilidad estructural en NextPDF Connect. La herramienta es check_accessibility; se ha vuelto a verificar frente al proveedor de herramientas Pro, que registra new CheckAccessibilityTool() con el nombre de protocolo check_accessibility. La propia descripción de la herramienta delimita su alcance: analiza la accesibilidad estructural de un PDF: encabezados, tablas, imágenes e indicadores de orden de lectura. Presenta indicadores y sugerencias de corrección. No certifica la conformidad con PDF/UA ni con WCAG. Esa determinación corresponde a un comprobador de conformidad —por ejemplo, veraPDF o una herramienta de pruebas PDF/UA— y no a esta herramienta. check_accessibility es una herramienta de nivel Pro. NextPDF la detecta con class_exists() durante el arranque y la registra solo cuando el paquete Pro está instalado.

Instalación

composer require nextpdf/server
composer require nextpdf/pro

Vincular un transporte y confirmar la herramienta con diagnostic.capabilities.

Visión conceptual

La estructura accesible se apoya en dos elementos: un árbol de estructura lógica compuesto por elementos de estructura (ISO 32000-2 §14.7) y un idioma del documento declarado, establecido mediante la entrada Lang del catálogo (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility inspecciona estos indicadores estructurales y devuelve un informe de hallazgos, cada uno con una gravedad y una orientación de corrección. Cualquier puntuación numérica o pass/fail del informe es un resumen de indicadores, no una certificación: debe leerse como una señal de triaje.

Superficie de la API

Herramienta	Nivel	Función	Nivel de riesgo
`create_pdf`, `add_text`	Core	Construir contenido para inspeccionar	Seguro / Precaución
`check_accessibility`	Pro	Análisis de accesibilidad estructural	Seguro
`output_pdf`	Core	Renderizar y devolver el PDF	Aprobación requerida / Revisión (base64)

Los nombres de las herramientas son los nombres de protocolo definidos en el registro. El catálogo de herramientas es la referencia. Las herramientas disponibles dependen del nivel instalado.

Ejemplo de código: inicio rápido

create_pdf → añadir contenido con add_text.
check_accessibility con el document_id.
Leer los hallazgos: gravedad, indicador, página afectada y sugerencia de corrección.
De forma opcional, output_pdf (base64) para una revisión manual junto al informe.

Ejemplo de código: producción

Tratar el informe como entrada de triaje, no como un veredicto. Asignar cada hallazgo a una corrección concreta: habilitar la salida etiquetada, establecer el idioma del documento y añadir estructura de encabezados. Para una verificación de conformidad, ejecutar un comprobador externo y tomar su veredicto —y no la puntuación de esta herramienta— como referencia autorizada. Ejecutar la comprobación antes de output_pdf con destroy: true; de lo contrario, no se podrá ver el documento.

Casos límite y trampas

Sin contenido. Un documento en blanco produce un hallazgo de «sin contenido», no una certificación.
Documento grande. El análisis está limitado por un tiempo de espera; dividir o segmentar las entradas grandes.
Sesión destruida. Ejecutar la comprobación antes de que la salida destruya la sesión.
Origen cifrado. Proporcionar la contraseña.
Pro ausente. Con Core solamente, check_accessibility no se registra.

Rendimiento

El tiempo de espera definido en el presupuesto limita el análisis. El perfil es semantic: el informe es la salida del análisis estructural, por lo que una comparación fiel debe basarse en los hallazgos, no en la salida en bytes.

Notas de seguridad

El informe describe la estructura, no secretos del contenido. El documento analizado puede seguir siendo sensible, por lo que debe mantenerse dentro de su límite de confianza. La ruta de análisis no escribe nada en el sistema de archivos.

Conformidad

Afirmación	Especificación	Cláusula
La estructura lógica es un árbol de elementos de estructura.	ISO 32000-2	§14.7
El idioma del documento se declara mediante la entrada `Lang`.	ISO 32000-2	§14.9
El idioma natural debe especificarse para una autoría accesible.	PDF/UA-2	§8.4.4

check_accessibility informa sobre indicadores estructurales que respaldan la autoría accesible. No afirma la conformidad con PDF/UA ni con WCAG: eso lo determina un comprobador independiente.

Contexto comercial

check_accessibility es una herramienta de nivel Pro, registrada solo cuando el paquete Pro se resuelve durante el arranque del servidor.

Correspondencia con PDF/UA-2

Los indicadores estructurales que inspecciona la herramienta se alinean con los requisitos de autoría de PDF/UA-2: un árbol de estructura etiquetado (ISO 32000-2 §14.7) y un idioma del documento declarado (PDF/UA-2 §8.4.4). La herramienta indica si estos indicadores están presentes o ausentes. Un comprobador PDF/UA determina la conformidad con PDF/UA-2, no el informe de la herramienta.

Referencia cruzada de etiquetas → ISO 32000-2 §14

Los hallazgos sobre encabezados y tablas corresponden a elementos de estructura lógica en el árbol de estructura de ISO 32000-2 §14.7. El hallazgo sobre el idioma corresponde a la entrada Lang de §14.9. La herramienta expone si estos anclajes estructurales están presentes. No valida todas las reglas de etiquetado de §14: eso corresponde a un comprobador.

Correspondencia con WCAG 2.2

Los hallazgos sobre contraste y orden de lectura se relacionan con criterios de éxito de WCAG, por ejemplo, contraste y secuencia significativa. La herramienta informa sobre valores de indicadores, como una relación de contraste medida. Una declaración de conformidad con WCAG requiere una evaluación WCAG completa, que esta herramienta no realiza ni afirma.

Disponibilidad de transportes

Transporte	Disponible	Notas
MCP (stdio)	Sí (Pro)	El informe es un resultado de herramienta.
REST	Sí (Pro)	El informe es el cuerpo de la respuesta.
gRPC	Sí (Pro)	Unario; el informe va en el mensaje de respuesta.

Nivel de riesgo HITL

check_accessibility es Seguro (análisis de solo lectura) y nunca controla el flujo de ejecución. output_pdf a un archivo es Aprobación requerida, y el modo base64 es Revisión (niveles de riesgo HITL).

Sobre el JSON de la verificación de confirmación

El análisis nunca controla el flujo de ejecución:

{ "allowed": true }