ValidatePdfR - TPdf

Esta entrada API preserva identificadores, assinaturas, blocos de código e termos PDF em sua forma original.

Componente: TPdf · Unidade: PDFium

Inspeciona o PDF aberto no momento em busca de marcadores de conformidade PDF/R-1 e retorna um resultado estruturado com o nível de conformidade detectado e o conjunto de problemas encontrados

Sintaxe

function ValidatePdfR: TPdfRValidationResult;

Descrição

ValidatePdfR percorre o documento aberto em busca dos marcadores de formato de arquivo definidos pela ISO 23504-1:2020:

O comentário de identificação de versão %PDF-raster-x.y perto do fim do arquivo (§5)
Uma linha de cabeçalho no formato %PDF-1.4, %PDF-1.5, %PDF-1.6 ou %PDF-1.7 (§6.2.2) para arquivos não criptografados, ou %PDF-2.0 (§6.2.3) para arquivos criptografados
A ausência de fluxos de objetos (/Type /ObjStm — §6.2.4)
Conformidade do dicionário do catálogo com a lista branca da §6.3 (Version / ViewerPreferences / PageLayout / PageMode / AcroForm / Metadata; qualquer outra coisa dispara pvriProhibitedCatalogEntry)
Conformidade do Document Information Dictionary com a lista branca da §6.4.3 (Creator / Producer / CreationDate / ModDate; Title / Author / Subject / Keywords / Trapped disparam pvriProhibitedInfoEntry)
Um fluxo de metadados XMP no catálogo (§6.4)
Um array /ID no trailer

O resultado é um registro TPdfRValidationResult:

Conformance — prc1 (marcador PDF/R-1 encontrado), prcNone (nenhum marcador) ou prcUnknown (falha na análise ou documento inativo)
Issues — um conjunto TPdfRValidationIssues com zero ou mais valores: pvriMissingVersionMarker, pvriBadHeader, pvriObjStmPresent, pvriProhibitedCatalogEntry, pvriProhibitedInfoEntry, pvriInfoXmpMismatch, pvriMissingXmpMetadata, pvriMissingTrailerId

ValidatePdfR é uma inspeção somente leitura do formato de arquivo. A conformidade PDF/R-1 tem requisitos estruturais rígidos que este método não verifica — estrutura Contents por página, formato MediaBox, filtros permitidos, referências indiretas com geração zero e layout de faixa. Combine-o com um validador PDF/R do TWAIN Working Group para essas verificações em nível de conteúdo

Observações

A checagem do marcador de versão procura por %PDF-raster- como substring em qualquer ponto do arquivo. A ISO 23504-1 §5 especifica que o marcador fica entre o dicionário de trailer e startxref, mas o validador aceita outros locais para ser tolerante com geradores levemente fora do padrão
Chamar ValidatePdfR em um documento inativo retorna um registro com Conformance = prcUnknown e um conjunto Issues vazio
A criptografia é permitida pela §6.2.3 (com um cabeçalho %PDF-2.0), portanto o validador NÃO marca a chave /Encrypt do trailer como não conformidade. PDFs de origem criptografados sob PDF 1.x ainda falhariam por causa da checagem do cabeçalho

Exemplo

uses System.TypInfo;

var
  Outcome: TPdfRValidationResult;
  Issue: TPdfRValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\scan.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfR;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfRConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfRValidationIssue), Ord(Issue)));
end;

Consulte também

PdfRConformance, SaveAsPdfR, SaveAsPdfRToStream, ValidatePdfA, ValidatePdfX