CheckFileComplianceA

Соответствие стандартам, инспекция документов

Описание

Завершающая A обозначает точку входа DLL типа ANSI (char); интерфейс ActiveX/COM предоставляет только форму Unicode. Поведение идентично CheckFileCompliance, а строковые аргументы интерпретируются с использованием текущей кодовой страницы SetAnsiMode

Читает внешний файл PDF и проверяет его на соответствие выбранному стандарту ISO. Возвращаемое значение — либо ноль (файл чисто проходит выбранный тест), либо ненулевой handle StringListID, перечисляющий каждую обнаруженную проблему. Каждая запись списка — короткий код, двоеточие и понятное человеку сообщение — ровно тот же формат кодов, что использует GetPDFUADiagnostics. Перечисляйте результат через GetStringListCount и GetStringListItem.

Проверка PDF/A покрывает все шесть режимов соответствия (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) и читает записи XMP pdfaid:part/pdfaid:conformance, чтобы решить, какой набор правил применить

Проверка PDF/UA-1 (добавлена в v3.56.0) сверяет внешний PDF с ISO 14289-1 и выдает диагностические коды в диапазоне 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). Он не проходит по каждому оператору контентного потока и не проверяет встраивание шрифтов или ссылки на цветовые пространства для каждого отрисованного объекта — такие проверки требуют отдельного валидатора PDF/A (например, veraPDF). Используйте эту функцию как проверку первой линии и как врата регрессии в сборочных конвейерах. Когда нужно, чтобы библиотека отформатировала списки проблем в пригодный для повторного использования текстовый отчёт, используйте CreatePreflightReport или SavePreflightReport. Для вывода отчётов в тексте, JSON, HTML или CSV используйте CreatePreflightReportEx или SavePreflightReportEx, либо смотрите Preflight Reports для полного рабочего процесса отчётов.

Парный API GetPDFUADiagnostics выполняет аналогичные проверки PDF/UA-1 (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