CheckFileCompliance

Conformidad, inspección de documentos

Selección del perfil de lector PDF/UA

Las comprobaciones PDF/UA seleccionan la parte 2 cuando XMP identifica pdfuaid:part=2; de lo contrario conservan las comprobaciones de la parte 1; las comprobaciones heredadas de PDF/UA-1 descritas aquí no se supone que apliquen a la parte 2

El perfil de PDF/UA-2 implementa comprobaciones básicas de identificación, espacios de nombres, roles y estructura; los informes estructurados usan PDF/UA-2 e ISO 14289-2 y declaran fullCertification=false y el ámbito sin verificar

Use CheckFilePDFUACompliance o RunPDFUAValidationPipelineTask para forzar una parte de destino, y GetPDFUAReadValidationCoverageJSON para examinar los límites de capacidad

Descripción

Lee un archivo PDF externo y lo valida frente a una norma de conformidad ISO elegida. El valor devuelto es cero (el archivo pasa limpiamente la prueba elegida) o un manejador StringListID distinto de cero que enumera cada incidencia detectada. Cada entrada de la lista es un código corto, dos puntos y un mensaje legible, exactamente el mismo formato de código que usa GetPDFUADiagnostics. Enumere el resultado con GetStringListCount y GetStringListItemLa prueba PDF/A cubre los seis modos de conformidad (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) y lee las entradas XMP

pdfaid:part/pdfaid:conformance para decidir qué conjunto de reglas aplicarLa prueba PDF/UA-1 (agregada en v3.56.0) comprueba un PDF externo frente a ISO 14289-1 y emite códigos de diagnóstico en el rango

10xxx para que permanezcan visualmente separados de los códigos 00xxx de PDF/A

Sintaxis

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

Parámetros

Valores devueltos

Códigos de incidencias de PDF/A (ComplianceTest = 1)

Códigos de incidencias de PDF/UA-1 (ComplianceTest = 2)

Observaciones

La prueba PDF/A está pensada como una autoverificación rápida antes de la entrega. Detecta las incidencias a nivel de documento que descalifican un archivo de plano (versión de PDF incorrecta, OutputIntent faltante, árbol de estructura faltante en el nivel A, cifrado, capas en PDF/A-1). No recorre cada operador del flujo de contenido ni verifica la incrustación de fuentes o las referencias de espacios de color de cada objeto pintado; esas validaciones requieren un validador PDF/A dedicado (como veraPDF). Use esta función como verificación de primera línea y como compuerta de regresión en las canalizaciones de compilación. Use CreatePreflightReport o SavePreflightReport cuando desee que la biblioteca formatee las listas de incidencias en un informe de texto reutilizable. Use CreatePreflightReportEx o SavePreflightReportEx para generar informes en texto, JSON, HTML o CSV, o consulte Preflight Reports para el flujo de trabajo completo de informesLa API complementaria

GetPDFUADiagnostics realiza comprobaciones análogas para PDF/UA (ISO 14289-1) sobre el documento en memoria que se está generando, en lugar de sobre un archivo externoAl producir salida PDF/A con esta biblioteca, llame a

SetPDFAMode antes de agregar cualquier contenido. La protección del lado de generación dentro de SetPDFAMode bloquea las operaciones prohibidas por la parte elegida, de modo que un documento generado así normalmente pasará CheckFileCompliance automáticamente

Ejemplo

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

Véase también

Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode

La prueba de conformidad 3 audita PDF/X (ISO 15930): identificación de edición, intención de salida, geometría de página, fuentes incrustadas y el conjunto de características prohibidas; para PDF/X-6 también valida indicadores de anotaciones y apariencias fijas, apariencias de AcroForm y firma, exclusiones de XFA y apariencias generadas por el visor, colocación de acciones, cadenas de acciones, el conjunto de acciones con nombre permitidas y cada valor UseBlackPtComp

La prueba de conformidad 4 audita los metadatos de identificación de PDF/VT-3, su base de la familia PDF/X-6, el grafo DPartRoot y DPart, los nombres y valores DPM, el nivel de registro, el orden de páginas y la cobertura exacta de hojas; las comprobaciones compuestas comparten una pasada de analizador

La prueba de conformidad 5 audita la colocación de marcadores PDF/R-1, la versión y el cifrado, los objetos indirectos de generación cero, los diccionarios y filtros restringidos, los programas de página de un solo flujo, las bandas ráster ordenadas, las codificaciones de imagen, la cobertura de páginas y la resolución efectiva; puede reutilizar una pasada de análisis de canalización de validación compartida

La prueba de conformidad 6 audita el fundamento PDF/X y la identificación XMP de PDF/VCR-1, la raíz de plantilla directa única, los campos declarados, el campo de selección de páginas opcional y cada marcador de posición de reemplazo PassThrough de hoja, el enlace de páginas, los MCID y las cajas delimitadoras; puede reutilizar una pasada de análisis de canalización de validación compartida

La prueba de conformidad 7 audita la identificación y los metadatos de ciclo de vida de PDF/E-1, los identificadores de trailer, el cifrado permitido, las intenciones de salida y los espacios de color de dispositivo, los operadores de contenido, las fuentes, las anotaciones, los formularios, el contenido opcional, las acciones, las referencias a archivos externos, los estados de gráficos y las restricciones de flujos 3D; puede reutilizar una pasada de análisis de canalización de validación compartida