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 y en caso contrario mantienen las comprobaciones de la parte 1; las comprobaciones heredadas de PDF/UA-1 descritas aquí no se dan por aplicables 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 utilizan PDF/UA-2 e ISO 14289-2 y revelan fullCertification=false y el ámbito sin verificar

Utilice CheckFilePDFUACompliance o RunPDFUAValidationPipelineTask para forzar una parte de destino, y GetPDFUAReadValidationCoverageJSON para inspeccionar los límites de capacidades

Descripción

Lee un archivo PDF externo y lo valida con arreglo a una norma ISO de conformidad elegida. El valor devuelto es cero (el archivo supera limpiamente la prueba elegida) o un identificador StringListID distinto de cero que enumera cada incidencia detectada. Cada entrada de la lista es un código breve, dos puntos y un mensaje legible — exactamente el mismo formato de código que usa GetPDFUADiagnostics. Enumere el resultado con GetStringListCount y GetStringListItemLa prueba de 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 de PDF/UA-1 (añadida en v3.56.0) comprueba un PDF externo con arreglo a ISO 14289-1 y emite códigos de diagnóstico en el rango

10xxx, de modo que queden 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 de PDF/A está concebida como una autoverificación rápida antes de la entrega. Detecta las incidencias a nivel de documento que descalifican un archivo de forma directa (versión de PDF incorrecta, OutputIntent ausente, árbol de estructura ausente en el nivel A, cifrado, capas en PDF/A-1). No recorre cada operador de flujo de contenido ni verifica la incrustación de fuentes ni las referencias de espacio de color de cada objeto pintado — esas validaciones requieren un validador de PDF/A dedicado (como veraPDF). Use esta función como comprobación de primera línea y como puerta de regresión en las canalizaciones de compilación. Use CreatePreflightReport o SavePreflightReport cuando desee que la biblioteca dé formato a las listas de incidencias en un informe de texto reutilizable. Use CreatePreflightReportEx o SavePreflightReportEx para la salida de 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á construyendo, en lugar de sobre un archivo externoAl producir salida PDF/A con esta biblioteca, llame a

SetPDFAMode antes de añadir cualquier contenido. El guardián del lado de generación dentro de SetPDFAMode bloquea las operaciones prohibidas por la parte elegida, de modo que un documento construido así normalmente superará 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