CheckFileCompliance

合规、文档检查

PDF/UA 读取器 Profile 选择

当 XMP 标识 pdfuaid:part=2 时，PDF/UA 检查选择 part 2，否则保留 part 1 检查；此处描述的旧 PDF/UA-1 检查并不意味着适用于 part 2

PDF/UA-2 Profile 实现核心的标识、命名空间、角色与结构检查；结构化报告使用 PDF/UA-2 与 ISO 14289-2，并披露 fullCertification=false 与未验证范围

需要强制目标 part 时使用 CheckFilePDFUACompliance 或 RunPDFUAValidationPipelineTask，检查能力限制时使用 GetPDFUAReadValidationCoverageJSON

描述

读取外部 PDF 文件，并按所选的 ISO 合规标准进行验证。返回值要么为零（文件完全通过所选测试），要么为非零的 StringListID 句柄，其中列出检测到的每个问题。列表中的每一项都是简短代码、冒号和人类可读的消息——与 GetPDFUADiagnostics 使用的代码格式完全相同。使用 GetStringListCount 和 GetStringListItem 枚举结果PDF/A 测试涵盖全部六种一致性模式（PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-3a、PDF/A-3b），并读取

pdfaid:part/pdfaid:conformance XMP 条目来决定应用哪套规则PDF/UA-1 测试（v3.56.0 新增）依据 ISO 14289-1 检查外部 PDF，并发出

10xxx 范围的诊断代码，使其在视觉上与 PDF/A 的 00xxx 代码明显区分

语法

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

参数

返回值

PDF/A 问题代码（ComplianceTest = 1）

PDF/UA-1 问题代码（ComplianceTest = 2）

备注

PDF/A 测试旨在作为交付前的快速自检。它可捕获直接导致文件不合格的文档级问题（错误的 PDF 版本、缺少 OutputIntent、A 级缺少结构树、加密、PDF/A-1 中的图层）。它不会遍历每个内容流运算符，也不会针对每个绘制对象验证字体嵌入或颜色空间引用——这些验证需要专用的 PDF/A 验证器（如 veraPDF）。请将此函数用作第一道检查以及构建流水线中的回归门禁。当希望库将问题列表格式化为可复用的文本报告时，请使用 CreatePreflightReport 或 SavePreflightReport。若需要文本、JSON、HTML 或 CSV 报告输出，请使用 CreatePreflightReportEx 或 SavePreflightReportEx，或参阅 Preflight Reports 了解完整的报告工作流配套 API

GetPDFUADiagnostics 对当前正在构建的内存中文档（而非外部文件）执行针对 PDF/UA（ISO 14289-1）的类似检查使用该库生成 PDF/A 输出时，请在添加任何内容之前调用

SetPDFAMode。SetPDFAMode 内部的生成端守卫会阻止所选部分禁止的操作，因此以此方式构建的文档通常会自动通过 CheckFileCompliance

示例

// 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;

另请参阅

Preflight Reports、CreatePreflightReport、CreatePreflightReportEx、SavePreflightReport、SavePreflightReportEx、ComparePreflightReports、SetPDFAMode、GetPDFUADiagnostics、GetStringListCount、GetStringListItem、SetPDFUAMode

合规性测试 3 审计 PDF/X（ISO 15930）：版本标识、输出意图、页面几何、嵌入字体和禁止功能集；对 PDF/X-6 还会校验注释标志与固定外观、AcroForm 与签名外观、XFA 与查看器生成外观的排除、动作位置、动作链、允许的命名动作集合以及每个 UseBlackPtComp 值

合规性测试 4 审计 PDF/VT-3 标识元数据、其 PDF/X-6 家族基础、DPartRoot 与 DPart 图、DPM 名称与值、记录层级、页面顺序和精确的叶子覆盖；组合检查共享一次解析

合规性测试 5 审计 PDF/R-1 标记位置、版本与加密、第 0 代间接对象、受限字典与过滤器、单流页面程序、有序光栅条带、图像编码、页面覆盖和有效分辨率；可复用共享验证管线的解析

合规性测试 6 审计 PDF/X 基础与 PDF/VCR-1 XMP 标识、唯一的直接模板根、声明的字段、可选的页面选择字段和每个叶子 PassThrough 替换占位符、页面绑定、MCID 与外接框；可复用共享验证管线的解析

合规性测试 7 审计 PDF/E-1 标识与生命周期元数据、trailer 标识符、允许的加密、输出意图与设备色彩空间、内容算子、字体、注释、表单、可选内容、动作、外部文件引用、图形状态和 3D 流限制；可复用共享验证管线的解析