ValidatePdfE - TPdf - PDFium Delphi Component

Компонент: TPdf · Модуль: PDFium

Исследует открытый PDF на маркеры соответствия PDF/E-1 и возвращает структурированный результат с обнаруженным уровнем соответствия и набором найденных конкретных проблем

Syntax

function ValidatePdfE: TPdfEValidationResult;

Description

ValidatePdfE обходит открытый документ в поисках маркеров формата файла PDF/E-1, определённых ISO 24517-1:2008:

Поток метаданных XMP, содержащий pdfe:ISO_PDFEVersion (§5 + §13.3)
Соответствующее описание pdfaExtension:schemas для пространства имён pdfe (требование расширяемой схемы XMP Specification 2004, унаследованное через §13.1)
Запись /ISO_PDFEVersion в словаре Document Information со значением литеральной строки (§5 SHALL)
Равенство значения из словаря Info и значения XMP (§6.5 / §13.1)
Массив /ID в трейлере (§6.2)
Записи xmp:CreateDate и xmp:ModifyDate в XMP (унаследовано из ISO 19005-1 §6.7 через §13.1)

Результат — запись TPdfEValidationResult:

Conformance — обнаруженный уровень: pec1 (идентификатор PDF/E-1 найден и непуст), pecNone (маркера PDF/E нет) или pecUnknown (разбор не удался либо маркер присутствует, но значения нет)
Issues — набор TPdfEValidationIssues с нулём или более значений: pveiMissingXmpMetadata, pveiMissingPdfEIdentifier, pveiMissingExtensionSchema, pveiMissingInfoVersionEntry, pveiInfoVersionMismatch, pveiMissingTrailerId, pveiMissingXmpDates
IsCompliant — возвращает True, когда Conformance является реальным уровнем PDF/E, а Issues пуст

ValidatePdfE работает только на чтение — документ оно не меняет, и вызывать его повторно безопасно. Используйте его перед отправкой полезной нагрузки PDF/E в инженерный архив, чтобы показать несоответствия формата файла, которые эта библиотека способна обнаружить. Для частой проверки «это PDF/E-1?», не требующей списка проблем, предпочитайте более лёгкое свойство PdfEConformance

Remarks

На документах с корректной цепочкой xref проверка разрешает активные словари и декодирует метаданные через ограниченные разреженные чтения вместо копирования всего источника в память; неподдерживаемые структуры сохраняют совместимый путь проверки
ValidatePdfE — исследование уровня формата файла — оно не требует соблюдения правил PDF/E на уровне содержимого (полнота встраивания шрифтов, CMap ToUnicode, запрещённые Reference XObjects / PostScript XObjects / TR / TR2 != Default / XFA-формы / действия JavaScript и т.д.). Для полной проверки дополняйте этот метод внешним инструментом вроде callas pdfaPilot или axesPDF
Проверяющий сообщает pveiInfoVersionMismatch, только когда присутствуют и расходятся оба значения: Info /ISO_PDFEVersion и XMP pdfe:ISO_PDFEVersion. Когда запись Info отсутствует, проверяющий сообщает только pveiMissingInfoVersionEntry (без ложного несоответствия)
Вызов ValidatePdfE на неактивном документе возвращает запись с Conformance = pecUnknown и пустым набором Issues
PDF/E-1 допускает шифрование (§6.3) при условии, что строки /ID в трейлере остаются прямыми объектами. Поэтому проверяющий НЕ помечает шифрование как несоответствие

Example

uses System.TypInfo;

var
  Outcome: TPdfEValidationResult;
  Issue: TPdfEValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\drawing.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfE;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfEConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfEValidationIssue), Ord(Issue)));
end;

ValidatePdfE Метод

Компонент: TPdf · Модуль: PDFium

Syntax

Description

Remarks

Example

See Also