CreateValidationReport

Compliance

Descrizione

Crea un report strutturato di convalida PDF/A e PDF/UA-1 in XML o JSON, con la clausola ISO e le statistiche associate a ogni risultato.

Sintassi

Delphi

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

Parametri

InputFileName	Il file PDF da convalidare
Password	La password necessaria per aprire il file oppure una stringa vuota
ComplianceTests	Maschera di bit che seleziona i controlli: `1` = PDF/A, `2` = PDF/UA-1, `0` = entrambi
Options	Passato ai controlli; `1` si arresta al primo risultato di ciascun controllo
ReportFormat	`0` = XML, `1` = JSON

Valori restituiti

Empty string	Il file di input non esiste
Report	Il documento completo del rapporto

Note

Con più standard selezionati, il file viene analizzato una volta e gli audit condividono reader, sicurezza, grafo oggetti e cache lazy

Ogni risultato contiene ID regola, standard (ISO 19005-1 o ISO 14289-1), nome macchina, clausola ISO, gravità e oggetti interessati. Ogni controllo termina con risultato e conteggio; il rapporto con verdetto e totali

Uno standard non richiesto viene indicato come not-checked, non come superato, evitando di confondere un controllo parziale con un esito completamente positivo

Si distingue da CreatePreflightReportEx, che esegue prima il rendering di un rapporto leggibile e converte poi il testo in JSON, HTML o CSV. Il rapporto di convalida viene composto dall'output non elaborato dei controlli, così una pipeline di compilazione può basarsi sull'ID di una regola o su una clausola ISO anziché confrontare sottostringhe in una frase

Esempio

Report:= PDF.CreateValidationReport('invoice.pdf', '', 0, 0, 1);
if Pos('"result": "failed"', Report)> 0 then
  ShowMessage('the file did not pass validation');

Vedere anche

CreateValidationPipelineReport, SaveValidationReport, CheckFileCompliance, CreatePreflightReport, CreatePreflightReportEx