CreatePreflightReport
Conformità, ispezione dei documenti
Selezione del profilo reader PDF/UA
I controlli PDF/UA selezionano la parte 2 quando XMP identifica pdfuaid:part=2 e altrimenti mantengono i controlli della parte 1; i controlli legacy PDF/UA-1 descritti in questa pagina non sono automaticamente applicabili alla parte 2
Il profilo PDF/UA-2 implementa i controlli essenziali di identificazione, spazio dei nomi, ruoli e struttura; i report strutturati usano PDF/UA-2 e ISO 14289-2 e dichiarano fullCertification=false e l'ambito non verificato
Usa CheckFilePDFUACompliance oppure RunPDFUAValidationPipelineTask per imporre una parte target e GetPDFUAReadValidationCoverageJSON per esaminare i limiti delle capacità
Descrizione
Crea un rapporto di preflight in testo normale per un file PDF esterno, eseguendo i controlli esistenti di conformità dei file PDF/A e PDF/UA-1 e formattandone i risultati in un unico corpo riutilizzabile. È l'API pratica da usare quando un'applicazione richiede un rapporto leggibile anziché chiamare manualmente CheckFileCompliance, GetStringListCount, GetStringListItem e ReleaseStringList
Sintassi
Delphi
Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;Parametri
| InputFileName | Percorso completo del file PDF da convalidare. Il file viene aperto in sola lettura e non viene modificato |
|---|---|
| Password | Password usata per aprire il file. Passare una stringa vuota per i documenti non crittografati |
| ComplianceTests | Maschera verifiche. 1 — PDF/A. 2 — PDF/UA-1. 3 — entrambi. Anche 0 esegue entrambi. |
| Options | Flag passati a ogni controllo. 0 — Segnala tutti i problemi. 1 — Arresta ogni controllo al primo problema |
Valore restituito
Restituisce un rapporto testuale UTF-16 contenente l'intestazione, una sezione per ogni controllo di conformità selezionato e un riepilogo finale con le righe Total issues e Result
Note
Con più standard selezionati, il file viene analizzato una volta e gli audit condividono reader, sicurezza, grafo oggetti e cache lazy
L'API per i rapporti non sostituisce un validatore PDF/A esterno dedicato. Racchiude la diagnostica di primo livello PDF/A e PDF/UA-1 incorporata nella libreria in un rapporto stabile destinato all'applicazione. Usare CreatePreflightReportEx quando l'applicazione richiede output in testo, JSON, HTML o CSV e usare direttamente CheckFileCompliance quando richiede handle dei singoli elenchi di problemi anziché testo formattato
Il rapporto in testo normale è la fonte canonica di ogni rapporto formattato. Contiene metadati variabili Generated:, un percorso Input:, i controlli selezionati, la modalità di raccolta dei problemi, una sezione per ciascun test di conformità selezionato e un riepilogo finale con Total issues e Result
Per i flussi di lavoro da riga di comando e con report in batch, vedere Report di preflight
Esempio
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;Vedere anche
Preflight Reports, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode