CreatePreflightReport
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
Crea un informe de comprobación previa en texto sin formato para un archivo PDF externo mediante la ejecución de las comprobaciones existentes de conformidad de archivos PDF/A y PDF/UA-1, y aplica formato a sus resultados para obtener un único cuerpo de informe reutilizable. Es la API auxiliar que debe utilizarse cuando una aplicación necesita un informe legible en vez de llamar manualmente a CheckFileCompliance, GetStringListCount, GetStringListItem y ReleaseStringList
Sintaxis
Delphi
Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;Parámetros
| InputFileName | Ruta completa del archivo PDF que se validará. El archivo se abre en modo de solo lectura y no se modifica |
|---|---|
| Password | Contraseña utilizada para abrir el archivo. Pase una cadena vacía para documentos sin cifrar |
| ComplianceTests | Máscara de bits que selecciona las comprobaciones que se incluirán. 1 — PDF/A. 2 — PDF/UA-1. 3 — PDF/A y PDF/UA-1. Pasar 0 también ejecuta ambas comprobaciones |
| Options | Marcas de bits que se pasan a cada comprobación de conformidad subyacente. 0 — Informa de todos los problemas encontrados en cada comprobación seleccionada. 1 — Detiene cada comprobación seleccionada después del primer problema |
Valor devuelto
Devuelve un informe de texto UTF-16 que contiene la cabecera del informe, una sección por cada comprobación de conformidad seleccionada y un resumen final con las líneas Total issues y Result
Observaciones
Cuando se seleccionan varios estándares, el archivo se analiza una sola vez y ambas auditorías comparten el mismo lector, estado de seguridad, gráfico de objetos del documento y caché diferida de objetos
La API de informes no sustituye a un validador PDF/A externo específico. Empaqueta los diagnósticos integrados principales de PDF/A y PDF/UA-1 de la biblioteca en un informe estable para aplicaciones. Utilice CreatePreflightReportEx cuando la aplicación necesite salida de texto, JSON, HTML o CSV, y CheckFileCompliance directamente cuando necesite identificadores individuales de listas de incidencias en vez de texto con formato
El informe de texto es la fuente canónica. Incluye Generated:, ruta Input:, comprobaciones, modo, secciones por prueba y resumen con Total issues y Result
Para flujos de trabajo de línea de comandos e informes por lotes, consulte Informes de comprobación previa
Ejemplo
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;Véase también
Informes de comprobación preliminar, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode