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; 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
Crea un informe de preflight de texto sin formato para un archivo PDF externo ejecutando las comprobaciones existentes de conformidad de archivos PDF/A y PDF/UA-1 y dando formato a sus resultados en un cuerpo de informe reutilizable. Esta es la API práctica que debe usarse cuando una aplicación necesita un informe legible para personas 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 usada para abrir el archivo. Pase una cadena vacía para documentos sin cifrar |
| ComplianceTests | Máscara de bits que selecciona las comprobaciones que se deben incluir 1 — PDF/A 2 — PDF/UA-1 3 — ambos PDF/A y PDF/UA-1 Pasar 0 también ejecuta ambas comprobaciones |
| Options | Indicadores de bits transferidos a cada comprobación de cumplimiento subyacente. 0 — Informa cada problema encontrado 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 el encabezado 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 vez y ambas auditorías comparten el mismo lector, estado de seguridad, grafo de objetos del documento y caché diferida de objetos
La API de informes no sustituye a un validador externo especializado de PDF/A. Empaqueta los diagnósticos integrados de primera línea de PDF/A y PDF/UA-1 de la biblioteca en un informe estable orientado a aplicaciones. Use CreatePreflightReportEx cuando la aplicación necesite salida de texto, JSON, HTML o CSV, y use CheckFileCompliance directamente cuando necesite identificadores individuales de listas de incidencias en vez de texto con formato
El informe de texto sin formato es la fuente canónica de cada informe con formato; contiene metadatos volátiles Generated:, una ruta Input:, las comprobaciones seleccionadas, el modo de recopilación de incidencias, una sección para cada prueba de conformidad seleccionada y un resumen final con Total issues y Result
Para flujos de trabajo de línea de comandos e informes por lotes, consulte Preflight Reports
Ejemplo
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;Véase también
Informes de preflight, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode