CheckFileComplianceA

Conformidade, inspeção de documentos

Descrição

O A final indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico a CheckFileCompliance e os argumentos de cadeia são interpretados através da página de códigos atual de SetAnsiMode

Lê um ficheiro PDF externo e valida-o em relação a uma norma de conformidade ISO escolhida. O valor devolvido é zero (o ficheiro passa sem problemas o teste escolhido) ou um identificador StringListID diferente de zero que enumera todos os problemas detetados. Cada entrada da lista é um código curto, dois pontos e uma mensagem legível — exatamente o mesmo formato de código utilizado por GetPDFUADiagnostics. Enumere o resultado com GetStringListCount e GetStringListItem

O teste PDF/A abrange 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 o conjunto de regras a aplicar

O teste PDF/UA-1 (adicionado na v3.56.0) verifica um PDF externo em relação à ISO 14289-1 e emite códigos de diagnóstico no intervalo 10xxx, para que permaneçam visualmente distintos dos códigos PDF/A 00xxx

Sintaxe

Delphi

Function DLCheckFileComplianceA(InstanceID: Integer; InputFileName, Password: PAnsiChar; ComplianceTest, Options: Integer): Integer;

DLL

int DLCheckFileComplianceA(int InstanceID, const char * InputFileName, const char * 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. Deteta os problemas ao nível do documento que desqualificam imediatamente um ficheiro (versão PDF errada, OutputIntent em falta, árvore de estrutura em falta no 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 a espaços de cor de cada objeto desenhado — essas validações exigem um validador PDF/A dedicado (como o veraPDF). Utilize esta função como verificação inicial e como barreira de regressão nos pipelines de construção. Utilize CreatePreflightReport ou SavePreflightReport quando pretender que a biblioteca formate as listas de problemas num relatório de texto reutilizável. Utilize CreatePreflightReportEx ou SavePreflightReportEx para obter relatórios em texto, JSON, HTML ou CSV, ou consulte Relatórios de pré-verificação para conhecer o fluxo de trabalho completo dos relatórios

A API associada GetPDFUADiagnostics efetua verificações análogas de PDF/UA-1 (ISO 14289-1) no documento em memória que está a ser criado, em vez de num ficheiro externo

Ao produzir uma saída PDF/A com esta biblioteca, invoque SetPDFAMode antes de adicionar conteúdo. A proteção durante a geração dentro de SetPDFAMode bloqueia as operações proibidas pela parte escolhida, pelo que um documento assim criado passa normalmente CheckFileCompliance de forma automática

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

Relatórios de preflight, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode