CheckFileCompliance

Conformidade, inspeção de documentos

Seleção de perfil de leitor PDF/UA

As checagens de PDF/UA selecionam a parte 2 quando o XMP identifica pdfuaid:part=2 e, caso contrário, mantêm as checagens da parte 1; não se presume que as checagens legadas de PDF/UA-1 descritas aqui se apliquem à parte 2

O perfil PDF/UA-2 implementa checagens centrais de identificação, namespace, papéis e estrutura; relatórios estruturados usam PDF/UA-2 e ISO 14289-2 e divulgam fullCertification=false e o escopo não verificado

Use a CheckFilePDFUACompliance ou a RunPDFUAValidationPipelineTask para forçar uma parte alvo, e a GetPDFUAReadValidationCoverageJSON para inspecionar os limites de capacidade

Descrição

Lê um arquivo PDF externo e o valida em relação a um padrão de conformidade ISO escolhido. O valor retornado é zero (o arquivo passa limpamente no teste escolhido) ou um identificador StringListID não zero que lista cada problema detectado. Cada entrada da lista é um código curto, dois-pontos e uma mensagem legível — exatamente o mesmo formato de código usado por GetPDFUADiagnostics. Enumere o resultado com GetStringListCount e GetStringListItemO teste PDF/A cobre todos os seis modos de conformidade (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) e lê as entradas XMP

pdfaid:part/pdfaid:conformance para decidir qual conjunto de regras aplicarO teste PDF/UA-1 (adicionado em v3.56.0) verifica um PDF externo em relação à ISO 14289-1 e emite códigos de diagnóstico na faixa

O teste PDF/UA-1 (adicionado em v3.56.0) verifica um PDF externo contra a ISO 14289-1 e emite códigos de diagnóstico na faixa 10xxx para que permaneçam visualmente separados dos códigos 00xxx do PDF/A

Sintaxe

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);

Parâmetros

Valores retornados

Códigos de problemas PDF/A (ComplianceTest = 1)

Códigos de problemas PDF/UA-1 (ComplianceTest = 2)

Observações

O teste PDF/A destina-se a uma rápida autoverificação antes da entrega. Ele captura os problemas no nível do documento que desqualificam um arquivo de imediato (versão de PDF errada, OutputIntent ausente, árvore de estrutura ausente no nível A, criptografia, camadas no PDF/A-1). Ele não percorre cada operador de fluxo de conteúdo nem verifica a incorporação de fontes ou as referências de espaço de cores para cada objeto pintado — essas validações exigem um validador PDF/A dedicado (como o veraPDF). Use esta função como uma verificação de primeira linha e como um portão de regressão em pipelines de build. Use CreatePreflightReport ou SavePreflightReport quando quiser que a biblioteca formate as listas de problemas em um relatório de texto reutilizável. Use CreatePreflightReportEx ou SavePreflightReportEx para saída de relatório em texto, JSON, HTML ou CSV, ou consulte Preflight Reports para o fluxo de trabalho completo de relatóriosA API companheira

GetPDFUADiagnostics executa verificações análogas para PDF/UA (ISO 14289-1) sobre o documento em memória em construção no momento, em vez de sobre um arquivo externoAo produzir saída PDF/A com esta biblioteca, chame

SetPDFAMode antes de adicionar qualquer conteúdo. A guarda de geração dentro de SetPDFAMode bloqueia as operações proibidas pela parte escolhida, de modo que um documento construído assim normalmente passará em CheckFileCompliance automaticamente

Exemplo

// 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;

Veja também

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

O teste de conformidade 3 audita PDF/X (ISO 15930): identificação da edição, output intent, geometria de página, fontes embutidas e o conjunto de recursos proibidos; para PDF/X-6 também valida flags de anotação e aparências fixas, aparências AcroForm e de assinatura, exclusões de XFA e de aparências geradas pelo visualizador, posicionamento de ações, cadeias de ações, o conjunto de ações nomeadas permitidas e todo valor UseBlackPtComp

O teste de conformidade 4 audita os metadados de identificação PDF/VT-3, sua base da família PDF/X-6, o grafo DPartRoot e DPart, nomes e valores DPM, nível de registro, ordem de páginas e cobertura exata de folhas; as verificações compostas compartilham uma única passada de parser

O teste de conformidade 5 audita posicionamento, versão e criptografia de marcadores PDF/R-1, objetos indiretos de geração zero, dicionários e filtros restritos, programas de página em stream único, faixas raster ordenadas, codificações de imagem, cobertura de página e resolução efetiva; ele pode reutilizar uma passada de pipeline de validação compartilhado

O teste de conformidade 6 audita a fundação PDF/X e a identificação XMP do PDF/VCR-1, a raiz de template direta única, os campos declarados, o campo opcional de seleção de página e cada placeholder de substituição PassThrough folha, vínculo de página, MCID e bounding box; ele pode reutilizar uma passada de pipeline de validação compartilhado

O teste de conformidade 7 audita a identificação e os metadados de ciclo de vida do PDF/E-1, identificadores do trailer, criptografia permitida, output intents e espaços de cor de dispositivo, operadores de conteúdo, fontes, anotações, formulários, conteúdo opcional, ações, referências a arquivos externos, estados gráficos e restrições de streams 3D; ele pode reutilizar uma passada de pipeline de validação compartilhado