CheckFileCompliance

Conformidade, inspeção de documentos

Descrição

Lê um ficheiro PDF externo e valida-o contra uma norma de conformidade ISO à escolha; o valor devolvido é zero (o ficheiro passa limpamente o teste escolhido) ou um identificador StringListID não zero que lista cada problema detetado; cada entrada da lista é um código curto, dois-pontos e uma mensagem legível por humanos — exatamente o mesmo formato de código usado por GetPDFUADiagnostics; enumere o resultado com GetStringListCount e GetStringListItemO teste PDF/A cobre 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 que conjunto de regras aplicarO teste PDF/UA-1 (adicionado na v3.56.0) verifica um PDF externo contra a ISO 14289-1 e emite códigos de diagnóstico no intervalo

10xxx, de modo a permanecerem visualmente separados dos códigos PDF/A 00xxx

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 devolvidos

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 autoverificação rápida antes da entrega; apanha os problemas ao nível do documento que desqualificam de imediato um ficheiro (versão de PDF errada, OutputIntent em falta, árvore de estrutura em falta ao nível A, encriptação, camadas em PDF/A-1); não percorre todos os operadores dos fluxos de conteúdo nem verifica a incorporação de tipos de letra ou as referências de espaços de cor de cada objeto pintado — essas validações exigem um validador PDF/A dedicado (como o veraPDF); use esta função como verificação de primeira linha e como porta de regressão em pipelines de compilação; use CreatePreflightReport ou SavePreflightReport quando quiser que a biblioteca formate as listas de problemas num relatório de texto reutilizável; use CreatePreflightReportEx ou SavePreflightReportEx para saída de relatórios em texto, JSON, HTML ou CSV, ou consulte Preflight Reports para o fluxo de relatórios completoA API complementar

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

SetPDFAMode antes de adicionar qualquer conteúdo; a guarda do lado da geração dentro de SetPDFAMode bloqueia as operações proibidas pela parte escolhida, pelo que um documento construído dessa forma normalmente passa 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;

Consulte 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, intenção de saída, geometria de páginas, tipos de letra incorporados e o conjunto de funcionalidades proibidas; para PDF/X-6 valida também sinalizadores de anotações e aparências fixas, aparências AcroForm e de assinaturas, exclusões de aparências geradas por XFA e pelo visualizador, colocação de ações, cadeias de ações, o conjunto de ações nomeadas permitido e todos os valores UseBlackPtCompO teste de conformidade 4 audita os metadados de identificação PDF/VT-3, a base da família PDF/X-6, o grafo DPartRoot e DPart, nomes e valores DPM, nível de registo, ordem de páginas e cobertura exata de folhas; as verificações compostas partilham uma passagem de análiseO teste de conformidade 5 audita a colocação de marcadores PDF/R-1, versão e encriptação, objetos indiretos de geração zero, dicionários e filtros restritos, programas de página de fluxo único, faixas raster ordenadas, codificações de imagem, cobertura de páginas e resolução efetiva; pode reutilizar uma passagem de análise partilhada do pipeline de validaçãoO teste de conformidade 6 audita a base PDF/X e a identificação XMP PDF/VCR-1, a raiz única direta do modelo, campos declarados, campo opcional de seleção de páginas e todos os marcadores de posição de substituição PassThrough folha, ligação de páginas, MCID e caixa delimitadora; pode reutilizar uma passagem de análise partilhada do pipeline de validaçãoO teste de conformidade 7 audita a identificação e os metadados de ciclo de vida PDF/E-1, identificadores do trailer, encriptação permitida, intenções de saída e espaços de cor de dispositivo, operadores de conteúdo, tipos de letra, anotações, formulários, conteúdo opcional, ações, referências a ficheiros externos, estados gráficos e restrições de fluxos 3D; pode reutilizar uma passagem de análise partilhada do pipeline de validação