CreatePreflightReport
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
Cria um relatório de preflight em texto simples para um arquivo PDF externo, executando as verificações de conformidade de arquivo PDF/A e PDF/UA-1 existentes e formatando os resultados delas em um corpo de relatório reutilizável. É a API de conveniência a usar quando a aplicação quer um relatório legível em vez de chamar manualmente CheckFileCompliance, GetStringListCount, GetStringListItem e ReleaseStringList.
Sintaxe
Delphi
Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;Parâmetros
| InputFileName | Caminho completo do arquivo PDF a validar. O arquivo é aberto somente leitura e não é modificado. |
|---|---|
| Password | Senha usada para abrir o arquivo. Passe uma string vazia para documentos não criptografados. |
| ComplianceTests | Máscara de bits que seleciona quais verificações incluir. 1 — PDF/A. 2 — PDF/UA-1. 3 — PDF/A e PDF/UA-1. Passar 0 também executa as duas verificações. |
| Options | Bit flags repassados a cada verificação de conformidade subjacente. 0 — Relata todo problema encontrado em cada verificação selecionada. 1 — Interrompe cada verificação selecionada após o primeiro problema. |
Valor de retorno
Retorna um relatório de texto UTF-16 com o cabeçalho do relatório, uma seção por verificação de conformidade selecionada e um resumo final com as linhas Total issues e Result.
Observações
Quando vários padrões são selecionados, o arquivo é analisado uma única vez e ambas as auditorias compartilham o mesmo leitor, estado de segurança, grafo de objetos do documento e cache de objetos lazy
A API de relatórios não substitui um validador PDF/A externo dedicado. Ela empacota os diagnósticos de primeira linha de PDF/A e PDF/UA-1 embutidos na biblioteca em um relatório estável voltado à aplicação. Use CreatePreflightReportEx quando a aplicação precisar de saída em texto, JSON, HTML ou CSV, e use CheckFileCompliance diretamente quando precisar de handles individuais de listas de ocorrências em vez de texto formatado.
O relatório em texto simples é a fonte canônica de todo relatório formatado. Ele contém metadados voláteis Generated:, um caminho Input:, as verificações selecionadas, o modo de coleta de ocorrências, uma seção para cada teste de conformidade selecionado e um resumo final com Total issues e Result.
Para fluxos de linha de comando e relatórios em lote, veja Preflight Reports.
Exemplo
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;Veja também
Preflight Reports, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode