CreatePreflightReport
Conformidade, inspeção de documentos
Descrição
Cria um relatório de pré-verificação em texto simples para um ficheiro PDF externo, executando as verificações existentes de conformidade de ficheiros PDF/A e PDF/UA-1 e formatando os respetivos resultados num único corpo de relatório reutilizável. Esta é a API de conveniência a utilizar quando uma aplicação pretende 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 ficheiro PDF a validar. O ficheiro é aberto só para leitura e não é modificado |
|---|---|
| Password | Palavra-passe utilizada para abrir o ficheiro. Passe uma cadeia vazia para documentos não encriptados |
| ComplianceTests | Máscara de bits que seleciona as verificações a incluir. 1 — PDF/A. 2 — PDF/UA-1. 3 — PDF/A e PDF/UA-1. Passar 0 também executa ambas as verificações |
| Options | Sinalizadores de bits passados a cada verificação de conformidade subjacente. 0 — Comunicar todos os problemas encontrados em cada verificação selecionada. 1 — Parar cada verificação selecionada após o primeiro problema |
Valor devolvido
Devolve um relatório de texto UTF-16 que contém o cabeçalho do relatório, uma secção por verificação de conformidade selecionada e um resumo final com linhas Total issues e Result
Observações
Quando são selecionadas várias normas, o ficheiro é analisado uma única vez e ambas as auditorias partilham o mesmo leitor, estado de segurança, gráfico de objetos do documento e cache de objetos diferida
A API de relatórios não substitui um validador PDF/A externo dedicado. Empacota os diagnósticos PDF/A e PDF/UA-1 de primeira linha integrados na biblioteca num relatório estável destinado à aplicação. Utilize CreatePreflightReportEx quando a aplicação necessitar de saída em texto, JSON, HTML ou CSV e utilize diretamente CheckFileCompliance quando necessitar de identificadores individuais de listas de problemas em vez de texto formatado
O relatório em texto simples é a origem canónica de todos os relatórios formatados. Contém metadados voláteis Generated:, um caminho Input:, as verificações selecionadas, o modo de recolha de problemas, uma secção para cada teste de conformidade selecionado e um resumo final com Total issues e Result
Para fluxos de trabalho de linha de comandos e relatórios em lote, consulte Relatórios de preflight
Exemplo
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;Consulte também
Relatórios de preflight, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode