Seleccionar un modo de conformidad mediante Connect

Límite. Establecer un modo de conformidad cablea el catálogo y los metadatos que espera el estándar correspondiente. Hace que el motor produzca una salida destinada a conformarse con ese estándar. No convierte el documento en «conforme»: un validador (por ejemplo, veraPDF) decide la conformidad. Debe interpretarse cada afirmación de «conformidad» en esta página como «destinada a conformarse; el validador determina el resultado».

De un vistazo

Un documento contiene exactamente un discriminador de conformidad: modo simple, modo etiquetado/PDF-UA o modo PDF/A. Ese discriminador determina qué cableado de catálogo, estructura y metadatos emite el escritor. Esta receta establece el discriminador mediante los transportes de Connect. El configurador del modo etiquetado forma parte del núcleo. El configurador del modo PDF/A-4 es permanentemente de nivel Premium (ADR-011) y solo se registra cuando nextpdf/premium está instalado junto con el servidor.

Llamar a ambos configuradores superpone ambas pilas de funciones. El discriminador de valor único sigue resolviéndose en «gana el último», y se emite una advertencia de sobrescritura para que las herramientas puedan detectarla.

Instalación

composer require nextpdf/server

Confirmar que el configurador del modo PDF/A esté presente mediante una llamada tools/list. Consultar /connect/tool-catalog/.

Descripción conceptual

El marcador de conformidad declara la conformidad prevista; un validador determina la conformidad real (PDF/A-4 §6.7.3). La conformidad se determina con respecto a los requisitos del estándar; no la afirma el software productor (PDF/A-4 §6.7.3). El modo etiquetado cablea el árbol de estructura y las entradas mark-info del catálogo (ISO 32000-2 §14.7).

Por tanto, un cambio de modo es una operación de cableado. Prepara el documento para comprobarlo con respecto al estándar. No constituye por sí mismo un resultado de conformidad.

Superficie de la API

Los nombres de las herramientas se verifican con respecto al registro en ejecución mediante tools/list. El catálogo oficial es /connect/tool-catalog/. Esta receta no vuelve a enumerar las herramientas. Seleccionar el discriminador antes de la primera llamada de contenido. El escritor congela el modo al emitir la primera página.

Ejemplo de código: inicio rápido

Crear un documento y, a continuación, cambiarlo al modo etiquetado/PDF-UA:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

La respuesta indica los predicados de modo activos (etiquetado / accesibilidad / archivo) que el escritor consulta en cada punto de emisión. También indica el cableado del catálogo que ha añadido. Los predicados indican qué emitirá el escritor; no afirman que el resultado sea conforme.

Ejemplo de código: producción

Cambiar a PDF/A-4 (nivel Premium) y, a continuación, comprobar. Tratar un estado de error como un resultado normal que debe inspeccionarse:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

Si se llama a ambos configuradores, el discriminador se resuelve en «gana el último» y se emite una advertencia de sobrescritura. Ejecutar la comprobación de estándares para cada variante cuya pila de funciones permanezca cableada, porque el cableado es aditivo aunque el discriminador único no lo sea.

Casos límite y trampas

Establecer el modo después de la primera página se rechaza con un error de modo congelado. Establecer el modo inmediatamente después de crear el documento.
El configurador de PDF/A sin Premium falla: es permanentemente de nivel Premium (ADR-011). Un documento PDF 2.0 simple no necesita ningún modo PDF/A.
Un caso de enumeración desconocido se rechaza. El caso de archivo admitido es PDF/A-4 (los perfiles PDF/A heredados se retiraron).
Una operación prohibida por el modo de archivo (por ejemplo, JavaScript incrustado) se rechaza mientras el predicado de archivo está activo.
Una discrepancia entre variante y modo en la comprobación devuelve un hallazgo de marcador no conforme. Pasar la variante que coincida con el modo activo, o ambas cuando las dos pilas estén cableadas.

Rendimiento

El presupuesto del front-matter es un límite a efectos de documentación. El cableado del modo no añade ninguna fase separada medible.

Notas de seguridad

No aplicable más allá de la orientación general sobre el transporte de Connect.

Conformidad

Afirmación	Cláusula	reference_id
El marcador de conformidad declara la conformidad prevista; un validador determina el resultado	PDF/A-4 §6.7.3
La conformidad se determina con respecto a los requisitos; no la afirma el productor	PDF/A-4 §6.7.3
El modo etiquetado cablea el árbol de estructura y las entradas mark-info	ISO 32000-2 §14.7

Seleccionar un modo de conformidad hace que el motor produzca una salida destinada a conformarse. No constituye una certificación de conformidad. Un validador determina el resultado.

Contexto comercial

El configurador del modo PDF/A-4 es permanentemente de nivel Premium (ADR-011) y solo se registra cuando nextpdf/premium está instalado junto con el servidor. El configurador del modo etiquetado es una capacidad del núcleo.

Particularidades de Connect

Disponibilidad por transporte (MCP / REST / gRPC)

Los configuradores de modo y la comprobación se invocan de forma idéntica mediante MCP tools/call, el endpoint de herramientas REST y el servicio gRPC, a través del ejecutor de herramientas compartido.

Nivel de riesgo HITL

Los configuradores de modo son de nivel de precaución. La comprobación es de solo lectura. Ninguno es approval_required de forma predeterminada. Una anulación del operador solo puede aumentar el riesgo. Consultar /connect/hitl-risk-tiers/.

Envoltorio JSON de la puerta de confirmación

Estas herramientas no activan la puerta salvo que una anulación del operador eleve alguna a approval_required. El contrato del envoltorio y del token de un solo uso está en /connect/hitl-risk-tiers/.

Véase también

/cookbook/connect/compliance-check/ — validar con respecto al estándar activo.
/cookbook/connect/tagged-pdf-tutorial/ — tutorial completo de PDF etiquetado de extremo a extremo.
/connect/tool-catalog/ — cálculo del conjunto de herramientas por nivel.
/connect/hitl-risk-tiers/ — el modelo de riesgo y la puerta.