CreatePreflightReport

Efterlevnad, dokumentinspektion

PDF/UA-läsaprofilval

PDF/UA-kontrollerna väljer del 2 när XMP identifierar pdfuaid:part=2 och behåller i övrigt del 1-kontrollerna; de äldre PDF/UA-1-kontroller som beskrivs här anses inte gälla del 2

PDF/UA-2-profilen implementerar kärnkontroller för identifikation, namnrymd, roll och struktur; strukturerade rapporter använder PDF/UA-2 och ISO 14289-2 och redovisar fullCertification=false och overifierad omfattning

Använd CheckFilePDFUACompliance eller RunPDFUAValidationPipelineTask för att tvinga en mål-del och GetPDFUAReadValidationCoverageJSON för att granska förmågesgränser

Beskrivning

Skapar en vanlig text-preflight-rapport för en extern PDF-fil genom att köra de befintliga PDF/A- och PDF/UA-1-filfterlevnadskontrollerna och formatera deras resultat till en återanvändbar rapportkropp. Detta är bekvämlighets-API:t att använda när ett program vill ha en läsbar rapport i stället för att manuellt anropa CheckFileCompliance, GetStringListCount, GetStringListItem och ReleaseStringList

Syntax

Delphi

Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;

Parametrar

InputFileName	Fullständig sökväg till PDF-filen som ska valideras. Filen öppnas skrivskyddat och ändras inte
Password	Lösenord som används för att öppna filen. Ange en tom sträng för okrypterade dokument
ComplianceTests	Bitmask som väljer vilka kontroller som ingår 1 — PDF/A 2 — PDF/UA-1 3 — både PDF/A och PDF/UA-1. Att skicka `0` kör också båda kontrollerna
Options	Bitflaggor som skickas vidare till varje underliggande efterlevnadskontroll 0 — Rapportera varje problem som hittas i varje vald kontroll 1 — Stanna varje vald kontroll efter det första problemet

Returvärde

Returnerar en UTF-16-textrapport som innehåller rapporthuvudet, ett avsnitt per vald efterlevnadskontroll och en slutlig sammanfattning med Total issues- och Result-rader

Anmärkningar

När flera standarder valts parsas filen en gång och båda granskningarna delar samma läsare, säkerhetstillstånd, dokumentobjektgraf och lazy objektcache

Rapport-API:t ersätter inte en dedikerad extern PDF/A-validator. Det paketerar bibliotekets inbyggda första linjens PDF/A- och PDF/UA-1-diagnostik till en stabil programriktad rapport. Använd CreatePreflightReportEx när programmet behöver text-, JSON-, HTML- eller CSV-utdata, och använd CheckFileCompliance direkt när det behöver enskilda problemslist-handles i stället för formaterad text

Vanlig text-rapporten är den kanoniska källan för varje formaterad rapport. Den innehåller volatil Generated:-metadata, en Input:-sökväg, de valda kontrollerna, problemsamlingsläget, ett avsnitt per vald efterlevnadstest och en slutlig sammanfattning med Total issues och Result

För kommandorads- och batchrapportflöden, se Preflight Reports.

Exempel

var
  Report: WideString;
begin
  Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
  WriteLn(Report);
end;

Se även

Preflight Reports, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode