CheckFileCompliance

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

Выбор профиля чтения PDF/UA

Проверки PDF/UA выбирают часть 2, когда XMP указывает pdfuaid:part=2, и в остальных случаях удерживают проверки части 1; описанные здесь устаревшие проверки PDF/UA-1 не следует считать применимыми к части 2

Профиль PDF/UA-2 реализует базовые проверки идентификации, пространств имён, ролей и структуры; структурированные отчёты используют PDF/UA-2 и ISO 14289-2 и раскрывают fullCertification=false и неподтверждённую область

Чтобы принудительно задать целевую часть, используйте 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) и читает XMP-записи pdfaid:part/pdfaid:conformance, чтобы определить применимый набор правил

Тест PDF/UA-1 (добавлен в v3.56.0) проверяет внешний PDF на соответствие ISO 14289-1 и выдаёт диагностические коды в диапазоне 10xxx, чтобы они визуально не смешивались с кодами 00xxx PDF/A

Синтаксис

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): идентификацию редакции, output intent, геометрию страницы, внедренные шрифты и набор запрещенных возможностей; для PDF/X-6 он также проверяет флаги аннотаций и фиксированные appearances, appearances AcroForm и подписей, исключения для XFA и создаваемых просмотрщиком appearances, размещение действий, цепочки действий, допустимый набор именованных действий и каждое значение UseBlackPtComp

Тест соответствия 4 проверяет метаданные идентификации PDF/VT-3, его базу семейства PDF/X-6, граф DPartRoot и DPart, имена и значения DPM, уровень записей, порядок страниц и точное покрытие листьев; составные проверки используют один проход парсера

Тест соответствия 5 проверяет размещение, версию и шифрование маркеров PDF/R-1, косвенные объекты нулевого поколения, ограниченные словари и фильтры, программы страниц в одном потоке, упорядоченные растровые полосы, кодирования изображений, покрытие страницы и эффективное разрешение; он может переиспользовать общий проход конвейера проверки

Тест соответствия 6 проверяет фундамент PDF/X и XMP-идентификацию PDF/VCR-1, единственный прямой корень шаблона, объявленные поля, необязательное поле выбора страниц и каждый заменяющий placeholder PassThrough на листьях, привязку страниц, MCID и bounding box; он может переиспользовать общий проход конвейера проверки

Тест соответствия 7 проверяет идентификацию и метаданные жизненного цикла PDF/E-1, идентификаторы trailer, допустимое шифрование, output intents и цветовые пространства устройства, операторы содержимого, шрифты, аннотации, формы, optional content, действия, ссылки на внешние файлы, графические состояния и ограничения потоков 3D; он может переиспользовать общий проход конвейера проверки