CreatePreflightReport
Naleving, documentinspectie
PDF/UA-lezerprofielkeuze
PDF/UA-controles kiezen deel 2 wanneer XMP pdfuaid:part=2 identificeert en behouden anders de deel 1-controles; van de hier beschreven oudere PDF/UA-1-controles mag niet worden aangenomen dat ze voor deel 2 gelden
Het PDF/UA-2-profiel implementeert kerncontroles voor identificatie, naamruimten, rollen en structuur; gestructureerde rapporten gebruiken PDF/UA-2 en ISO 14289-2 en vermelden fullCertification=false en de niet-geverifieerde reikwijdte
Gebruik CheckFilePDFUACompliance of RunPDFUAValidationPipelineTask om een doeldeel af te dwingen en GetPDFUAReadValidationCoverageJSON om de grenzen van de mogelijkheden te bekijken
Beschrijving
Maakt een platte-tekst-preflight-rapport voor een extern PDF-bestand door de bestaande PDF/A- en PDF/UA-1-bestandsconformiteitscontroles te draaien en hun resultaten in één herbruikbare rapportkern te gieten. Dit is de handige API voor wanneer een toepassing een voor mensen leesbaar rapport wil in plaats van zelf CheckFileCompliance, GetStringListCount, GetStringListItem en ReleaseStringList aan te roepen
Syntaxis
Delphi
Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;Parameters
| InputFileName | Volledig pad van het te valideren PDF-bestand. Het bestand wordt alleen-lezen geopend en niet gewijzigd |
|---|---|
| Password | Het wachtwoord waarmee het bestand wordt geopend. Geef een lege string door voor niet-versleutelde documenten |
| ComplianceTests | Bitmasker dat kiest welke controles worden opgenomen. 1 — PDF/A. 2 — PDF/UA-1. 3 — zowel PDF/A als PDF/UA-1. 0 doorgeven voert ook beide controles uit. |
| Options | Bitvlaggen die aan elke onderliggende conformiteitscontrole worden doorgegeven. 0 — Meld elke bevinding in elke gekozen controle 1 — Stop elke gekozen controle na de eerste bevinding |
Retourwaarde
Geeft een UTF-16-tekstrapport terug met de rapportheader, één sectie per geselecteerde conformiteitscontrole en een slot samenvatting met de regels Total issues en Result
Opmerkingen
Als meerdere standaarden zijn geselecteerd, wordt het bestand één keer geparsed en delen beide audits dezelfde reader, beveiligingsstatus, objectgrafiek van het document en lazy object cache
De rapport-API vervangt geen toegewijde externe PDF/A-validator. Hij verpakt de ingebouwde eerste-lijns PDF/A- en PDF/UA-1-diagnostics van de library in een stabiel toepassingsgericht rapport. Gebruik CreatePreflightReportEx wanneer de toepassing tekst-, JSON-, HTML- of CSV-uitvoer nodig heeft, en gebruik CheckFileCompliance rechtstreeks wanneer die afzonderlijke bevindingenlijst-handles nodig heeft in plaats van geformatteerde tekst
Het rapport in platte tekst is de canonieke bron voor elk opgemaakt rapport. Het bevat vluchtige Generated:-metadata, een Input:-pad, de geselecteerde controles, de verzamelmodus voor problemen, één sectie voor elke geselecteerde compliancecontrole en een eindsamenvatting met Total issues en Result
Zie voor command-line- en batch-report-workflows Preflight Reports
Voorbeeld
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;Zie ook
Preflight-rapporten, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode