CheckFileCompliance

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

Legge un file PDF esterno e lo valida rispetto a uno standard di conformità ISO scelto. Il valore restituito è zero (il file supera pulitamente il test scelto) oppure un handle StringListID diverso da zero che elenca ogni problema rilevato. Ogni voce dell'elenco è un codice breve, due punti e un messaggio leggibile — esattamente lo stesso formato di codice usato da GetPDFUADiagnostics. Enumerare il risultato con GetStringListCount e GetStringListItemIl test PDF/A copre tutte e sei le modalità di conformità (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) e legge le voci XMP

pdfaid:part/pdfaid:conformance per decidere quale insieme di regole applicareIl test PDF/UA-1 (aggiunto in v3.56.0) verifica un PDF esterno rispetto a ISO 14289-1 ed emette codici diagnostici nell'intervallo

10xxx, così che restino visivamente separati dai codici PDF/A 00xxx

Sintassi

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

Parametri

Valori restituiti

Codici dei problemi PDF/A (ComplianceTest = 1)

Codici dei problemi PDF/UA-1 (ComplianceTest = 2)

Note

Il test PDF/A è pensato come una rapida autoverifica prima della consegna. Individua i problemi a livello di documento che squalificano immediatamente un file (versione PDF errata, OutputIntent mancante, albero di struttura mancante al livello A, cifratura, livelli in PDF/A-1). Non attraversa ogni operatore dei flussi di contenuto né verifica l'incorporamento dei font o i riferimenti agli spazi colore per ogni oggetto disegnato — quelle validazioni richiedono un validatore PDF/A dedicato (come veraPDF). Usare questa funzione come controllo di prima linea e come cancello di regressione nelle pipeline di build. Usare CreatePreflightReport o SavePreflightReport quando si vuole che la libreria formatti gli elenchi di problemi in un report testuale riutilizzabile. Usare CreatePreflightReportEx o SavePreflightReportEx per output di report in testo, JSON, HTML o CSV, oppure consultare Preflight Reports per il flusso di lavoro completo dei reportL'API complementare

GetPDFUADiagnostics esegue controlli analoghi per PDF/UA (ISO 14289-1) sul documento in memoria attualmente in costruzione, anziché su un file esternoQuando si produce output PDF/A con questa libreria, chiamare

SetPDFAMode prima di aggiungere qualsiasi contenuto. La protezione lato generazione all'interno di SetPDFAMode blocca le operazioni vietate dalla parte scelta, quindi un documento costruito in questo modo supererà normalmente CheckFileCompliance automaticamente

Esempio

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

Vedere anche

Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode

Il test di conformità 3 audita PDF/X (ISO 15930): identificazione di edizione, output intent, geometria di pagina, font incorporati e l'insieme di funzionalità vietate; per PDF/X-6 valida anche i flag di annotazioni e le apparenze fisse, le apparenze AcroForm e firma, le esclusioni XFA e di apparenze generate dal viewer, il collocamento delle azioni, le catene di azioni, l'insieme di azioni nominate permesse e ogni valore UseBlackPtComp

Il test di conformità 4 audita i metadati di identificazione PDF/VT-3, la sua base della famiglia PDF/X-6, il grafo DPartRoot e DPart, i nomi e valori DPM, il livello di record, l'ordine di pagine e la copertura esatta delle foglie; i controlli composti condividono una passata di analizzatore

Il test di conformità 5 audita il posizionamento dei marcatori PDF/R-1, la versione e la cifratura, gli oggetti indiretti di generazione zero, i dizionari e i filtri limitati, i programmi di pagina a flusso singolo, le strisce raster ordinate, le codifiche di immagine, la copertura di pagine e la risoluzione effettiva; può riusare una passata di analisi di pipeline di validazione condivisa

Il test di conformità 6 audita il fondamento PDF/X e l'identificazione XMP di PDF/VCR-1, la radice di modello diretta unica, i campi dichiarati, il campo di selezione di pagine opzionale e ogni segnaposto di sostituzione PassThrough di foglia, il binding di pagine, gli MCID e le box delimitatrici; può riusare una passata di analisi di pipeline di validazione condivisa

Il test di conformità 7 audita l'identificazione e i metadati di ciclo di vita PDF/E-1, gli identificatori di trailer, la cifratura permessa, gli output intent e gli spazi colore di dispositivo, gli operatori di contenuto, i font, le annotazioni, i moduli, il contenuto opzionale, le azioni, i riferimenti a file esterni, gli stati grafici e le restrizioni di flussi 3D; può riusare una passata di analisi di pipeline di validazione condivisa