CheckFileComplianceA

合規性、文件檢查

描述

結尾的 A 表示 ANSI（char）DLL 進入點，ActiveX/COM 介面僅公開 Unicode 形式。其行為與 CheckFileCompliance 相同，字串引數會依據目前的 SetAnsiMode 字碼頁進行解譯

讀取外部 PDF 檔案，依選定的 ISO 符合性標準驗證。傳回值為零（檔案乾淨通過所選測試）或非零的 StringListID handle，列出每個偵測到的問題。清單中每一筆都是短代碼、冒號與人類可讀訊息 — 與 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 DLCheckFileComplianceA(InstanceID: Integer; InputFileName, Password: PAnsiChar; ComplianceTest, Options: Integer): Integer;

DLL

int DLCheckFileComplianceA(int InstanceID, const char * InputFileName, const char * Password, int ComplianceTest, int Options);

參數

傳回值

PDF/A issue codes (ComplianceTest = 1)

PDF/UA-1 issue codes (ComplianceTest = 2)

備註

PDF/A 測試是交付前的快速自我檢查。它抓得出讓檔案直接出局的文章層級問題（PDF 版本錯誤、缺少 OutputIntent、A 級缺少結構樹、加密、PDF/A-1 中的圖層）。它不會走訪每個 content-stream 運算子，也不會為每個繪製物件驗證字型內嵌或色彩空間參照 — 這類驗證需要專用的 PDF/A 驗證器（例如 veraPDF）。此函式適合當作第一線檢查與建置 pipeline 的迴歸關卡。要讓程式庫把問題清單格式化成可重複使用的文字報告，請用 CreatePreflightReport 或 SavePreflightReport。文字、JSON、HTML 或 CSV 報告輸出請用 CreatePreflightReportEx 或 SavePreflightReportEx，完整報告工作流程見 Preflight Reports。

配套 API GetPDFUADiagnostics 針對目前正在建構的記憶體內文件（而不是外部檔案）執行 PDF/UA-1（ISO 14289-1）的類似檢查。

用本程式庫產出 PDF/A 時，加入任何內容之前先呼叫 SetPDFAMode。ConvertToPDFA 內建的產生端防護可涵蓋未經此設定的文件

範例

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