CheckFileCompliance

Відповідність, інспектування документів

Опис

Зчитує зовнішній файл 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, щоб вони візуально відрізнялися від кодів 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, коли хочете, щоб бібліотека відформатувала списки проблем у придатний для повторного використання текстовий звіт. Використовуйте CreatePreflightReportEx чи SavePreflightReportEx для виведення звітів у тексті, JSON, HTML чи CSV, або див. Звіти попередньої перевірки для повного робочого процесу звітівКомпаньйон-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

Тест відповідності 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, версію та шифрування, непрямі об'єкти нульового покоління, обмежені словники та фільтри, сторінкові програми з одного потоку, впорядковані растрові смуги, кодування зображень, покриття сторінок і ефективну роздільну здатність; він може повторно використати розбір спільного конвеєра перевіркиТест відповідності 6 перевіряє основу PDF/X та ідентифікацію XMP PDF/VCR-1, єдиний прямий корінь шаблону, оголошені поля, необов'язкове поле вибору сторінок і кожен кінцевий заповнювач заміни PassThrough, прив'язку до сторінки, MCID та обмежувальний прямокутник; він може повторно використати розбір спільного конвеєра перевіркиТест відповідності 7 перевіряє ідентифікацію та метадані життєвого циклу PDF/E-1, ідентифікатори trailer, дозволене шифрування, призначення виводу та апаратні колірні простори, оператори вмісту, шрифти, анотації, форми, необов'язковий вміст, дії, посилання на зовнішні файли, графічні стани та обмеження 3D-потоків; він може повторно використати розбір спільного конвеєра перевірки

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

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

Тест відповідності 6 перевіряє основу PDF/X та XMP-ідентифікацію PDF/VCR-1, єдиний прямий корінь шаблону, оголошені поля, необов'язкове поле вибору сторінок і кожен листовий заповнювач заміни PassThrough, прив'язку сторінок, MCID та обмежувальний прямокутник; він може повторно використати розбір спільного конвеєра валідації

Тест відповідності 7 перевіряє ідентифікацію PDF/E-1 та метадані життєвого циклу, ідентифікатори трейлера, дозволене шифрування, intención виводу та кольорові простори пристроїв, оператори вмісту, шрифти, анотації, форми, необов'язковий вміст, дії, посилання на зовнішні файли, стани графіки та обмеження 3D-потоків; він може повторно використати спільний аналіз конвеєра валідації