CreatePreflightReportEx
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 para um arquivo PDF externo e converte o relatório para o formato de saída solicitado. É o companheiro consciente de formato de CreatePreflightReport, que sempre retorna o relatório em texto simples.
Sintaxe
Delphi
Function TPDFlib.CreatePreflightReportEx(Const InputFileName, Password: WideString; ComplianceTests, Options, ReportFormat: 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 para PDF/A, 2 para PDF/UA, 3 ou 0 para ambos. |
| Options | Flags de bits repassados a cada verificação de conformidade selecionada. Passe 1 para interromper cada verificação após a primeira ocorrência. |
| ReportFormat | Seletor do formato de saída. 0 — texto simples. 1 — objeto JSON com campos de cabeçalho, seções por verificação, arrays de ocorrências e campos de resumo. 2 — documento HTML autônomo contendo o relatório de texto escapado. 3 — linhas CSV com metadados, verificações selecionadas, códigos e mensagens de ocorrências e linhas finais de resumo. |
Valor de retorno
Retorna o relatório gerado no formato selecionado. Valores de ReportFormat desconhecidos caem no formato de texto simples.
Observações
Os formatos JSON, HTML e CSV são gerados do mesmo relatório de texto usado por CreatePreflightReport, então o status pass/fail e as contagens de ocorrências permanecem consistentes em todos os formatos de relatório.
O objeto JSON expõe campos de cabeçalho, um array sections, arrays de strings de ocorrências e um objeto summary. A forma HTML é um documento autônomo que escapa o relatório de texto dentro de um bloco pré-formatado. A forma CSV usa colunas fixas kind,section,status,code,message e separa metadados, status de verificações, linhas de ocorrências e linhas de resumo, para parsing em planilha ou CI.
Para o contrato completo de formatos de relatório e exemplos de linha de comando de demonstração, veja Preflight Reports.
Exemplo
JsonReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 1);
HtmlReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 2);
CsvReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 3);Veja também
Preflight Reports, CreatePreflightReport, SavePreflightReportEx, ComparePreflightReports, CheckFileCompliance