CheckFileCompliance

合規性、文件檢查

PDF/UA 讀取器設定檔選擇

PDF/UA 檢查在 XMP 識別 pdfuaid:part=2 時選擇 part 2，否則沿用 part 1 檢查；本文描述的舊式 PDF/UA-1 檢查不表示適用於 part 2

PDF/UA-2 設定檔實作核心的識別、命名空間、角色與結構檢查；結構化報告使用 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 標記位置、版本與加密、generation 0 間接物件、受限制的字典與濾器、單串流頁面程式、有序光柵條帶、影像編碼、頁面覆蓋與有效解析度；可重用共用的驗證管線剖析結果

合規測試 6 審計 PDF/X 基礎與 PDF/VCR-1 XMP 識別、單一直接範本根節點、宣告的欄位、選配的頁面選擇欄位、每個葉節點 PassThrough 取代佔位項、頁面繫結、MCID 與外接框；可重用共用的驗證管線剖析結果

合規測試 7 審計 PDF/E-1 識別與生命週期中繼資料、trailer 識別碼、允許的加密、輸出意圖與設備色彩空間、內容運算元、字型、註解、表單、選用內容、動作、外部檔案參照、圖形狀態與 3D 串流限制；可重用共用的驗證管線剖析結果