Skip to content
PDF Oxide

Валидация PDF/A

PDF/A (ISO 19005) — международный стандарт долгосрочного архивного хранения электронных документов. PDF Oxide валидирует все основные уровни PDF/A и может конвертировать несоответствующие документы в направлении соответствия стандарту.

Поддерживаемые уровни

Level Standard Structure Unicode Transparency Embedded Files
1a ISO 19005-1 Required Required No No
1b ISO 19005-1 No No No No
2a ISO 19005-2 Required Required Yes No
2b ISO 19005-2 No No Yes No
2u ISO 19005-2 No Required Yes No
3a ISO 19005-3 Required Required Yes Yes
3b ISO 19005-3 No No Yes Yes
3u ISO 19005-3 No Required Yes Yes

Уровень «a» (accessible) требует дерева тегированной структуры и отображения символов Unicode. Уровень «b» (basic) требует только визуальной воспроизводимости. Уровень «u» (Unicode) требует отображения текста в Unicode без полного дерева структуры.

Быстрая валидация

Используйте удобную функцию для проверки одним вызовом:

from pdf_oxide import PdfDocument

doc = PdfDocument("document.pdf")
result = doc.validate_pdf_a("2b")
print(f"Valid: {result.valid}")
print(f"Level: {result.level}")
for error in result.errors:
    print(f"  Error: {error}")

const doc = new WasmPdfDocument(bytes);
const result = doc.validatePdfA("2b");
console.log(`Valid: ${result.valid}`);
console.log(`Errors: ${result.errors.length}`);
doc.free();

use pdf_oxide::PdfDocument;
use pdf_oxide::compliance::{validate_pdf_a, PdfALevel};

let mut doc = PdfDocument::open("archive.pdf")?;
let result = validate_pdf_a(&mut doc, PdfALevel::A1b)?;

if result.has_errors() {
    println!("Not PDF/A-1b compliant:");
    for error in &result.errors {
        println!("  [{}] {} (clause {})",
            error.code, error.message,
            error.clause.as_deref().unwrap_or("n/a"));
    }
} else {
    println!("Document is PDF/A-1b compliant");
}

API валидатора

PdfAValidator предоставляет паттерн-строитель для детального контроля:

use pdf_oxide::PdfDocument;
use pdf_oxide::compliance::{PdfAValidator, PdfALevel};

let mut doc = PdfDocument::open("report.pdf")?;

let result = PdfAValidator::new()
    .stop_on_first_error(false)
    .include_warnings(true)
    .validate(&mut doc, PdfALevel::A2b)?;

println!("Errors: {}", result.errors.len());
println!("Warnings: {}", result.warnings.len());

Точечные проверки

Запустите отдельные категории валидации вместо полного набора:

use pdf_oxide::PdfDocument;
use pdf_oxide::compliance::{PdfAValidator, PdfALevel};

let mut doc = PdfDocument::open("report.pdf")?;
let validator = PdfAValidator::new();

// Check only metadata
let result = validator.check_metadata(&mut doc, PdfALevel::A1b)?;

// Check only fonts
let result = validator.check_fonts(&mut doc, PdfALevel::A1b)?;

// Check only color spaces
let result = validator.check_colors(&mut doc, PdfALevel::A1b)?;

// Check only transparency
let result = validator.check_transparency(&mut doc, PdfALevel::A2b)?;

// Check only structure tags
let result = validator.check_structure(&mut doc, PdfALevel::A1a)?;

Отдельные валидаторы

Каждая категория валидации также доступна как отдельная функция для максимальной гибкости:

use pdf_oxide::PdfDocument;
use pdf_oxide::compliance::validators::*;
use pdf_oxide::compliance::{PdfALevel, ValidationResult};

let mut doc = PdfDocument::open("document.pdf")?;
let mut result = ValidationResult::new(PdfALevel::A1b);

// Run each validator independently
validate_xmp_metadata(&mut doc, PdfALevel::A1b, &mut result)?;
validate_fonts(&mut doc, PdfALevel::A1b, &mut result)?;
validate_colors(&mut doc, PdfALevel::A1b, &mut result)?;
validate_encryption(&mut doc, PdfALevel::A1b, &mut result)?;
validate_transparency(&mut doc, PdfALevel::A1b, &mut result)?;
validate_structure(&mut doc, PdfALevel::A1b, &mut result)?;
validate_javascript(&mut doc, PdfALevel::A1b, &mut result)?;
validate_embedded_files(&mut doc, PdfALevel::A1b, &mut result)?;
validate_annotations(&mut doc, PdfALevel::A1b, &mut result)?;

println!("Total errors: {}", result.errors.len());

Обзор валидаторов

Function What It Checks
validate_xmp_metadata() XMP stream exists, pdfaid:part and pdfaid:conformance entries present, metadata consistency
validate_fonts() Все шрифты встроены, ширины глифов присутствуют, отображение Unicode доступно (для уровней «a» и «u»)
validate_colors() No device-dependent color operators (rg, RG, k, K, g, G) without output intent
validate_encryption() No encryption permitted in PDF/A documents
validate_transparency() No transparency in PDF/A-1; allowed in PDF/A-2 and later
validate_structure() Присутствует дерево тегированной структуры с корректным сопоставлением ролей (обязательно для уровня «a»)
validate_javascript() Отсутствуют действия или триггеры JavaScript
validate_embedded_files() Не допускается в PDF/A-1 или PDF/A-2; PDF/A-3 требует ключ AFRelationship для каждой спецификации файла
validate_annotations() Типы аннотаций ограничены в соответствии с соответствующей частью ISO 19005

ValidationResult

Структура ValidationResult содержит полный результат прогона валидации:

pub struct ValidationResult {
    pub level: PdfALevel,
    pub errors: Vec<ComplianceError>,
    pub warnings: Vec<ComplianceWarning>,
    pub stats: ValidationStats,
}
Поле Тип Описание
level PdfALevel Целевой уровень соответствия
errors Vec<ComplianceError> Блокирующие нарушения, препятствующие соответствию
warnings Vec<ComplianceWarning> Неблокирующие проблемы, которые могут повлиять на качество
stats ValidationStats Подсчёт проверенных страниц, шрифтов и объектов

ComplianceError

pub struct ComplianceError {
    pub code: ErrorCode,
    pub message: String,
    pub location: Option<String>,
    pub clause: Option<String>,
}

Поле code использует перечисление ErrorCode с категориями: MissingXmpMetadata, FontNotEmbedded, DeviceDependentColor, EncryptionPresent, TransparencyNotAllowed, MissingStructureTree, JavaScriptPresent и InvalidEmbeddedFile.

ComplianceWarning

pub struct ComplianceWarning {
    pub code: WarningCode,
    pub message: String,
    pub location: Option<String>,
}

Конвертация в PDF/A

Конвертация несоответствующего документа в направлении соответствия PDF/A:

use pdf_oxide::PdfDocument;
use pdf_oxide::compliance::{convert_to_pdf_a, PdfALevel};

let mut doc = PdfDocument::open("input.pdf")?;
let result = convert_to_pdf_a(&mut doc, PdfALevel::A1b)?;

println!("Conversion actions taken:");
for action in &result.actions {
    println!("  - {}: {}", action.action_type, action.description);
}

if result.remaining_errors.is_empty() {
    println!("Document is now PDF/A-1b compliant");
} else {
    println!("{} issues could not be resolved automatically",
        result.remaining_errors.len());
}

Конфигурация конвертации

Тонкая настройка процесса конвертации:

use pdf_oxide::PdfDocument;
use pdf_oxide::compliance::{PdfAConverter, PdfALevel, ConversionConfig};

let mut doc = PdfDocument::open("input.pdf")?;

let config = ConversionConfig::new()
    .embed_fonts(true)
    .remove_javascript(true)
    .flatten_transparency(true)
    .add_structure(true);

let result = PdfAConverter::new(PdfALevel::A2b)
    .with_config(config)
    .convert(&mut doc)?;

Конвертер выполняет следующие действия автоматически:

  1. Внедрение метаданных XMP — добавляет записи pdfaid:part и pdfaid:conformance
  2. Встраивание шрифтов — встраивает все ссылочные, но не встроенные шрифты
  3. Удаление JavaScript — удаляет действия и триггеры JavaScript
  4. Сведение прозрачности — рендерит прозрачные элементы как непрозрачные (только PDF/A-1)
  5. Конвертация ICC-профилей — конвертирует аппаратно-зависимые цвета в цветовые пространства на основе ICC
  6. Тегирование структуры — добавляет базовые теги структуры (для целей уровня «a»)

Процесс: валидация, исправление, повторная валидация

Типичный архивный рабочий процесс: валидация, попытка автоматической конвертации, повторная валидация:

use pdf_oxide::PdfDocument;
use pdf_oxide::compliance::{validate_pdf_a, convert_to_pdf_a, PdfALevel};

let level = PdfALevel::A2b;
let mut doc = PdfDocument::open("input.pdf")?;

// Step 1: Initial validation
let result = validate_pdf_a(&mut doc, level)?;
if !result.has_errors() {
    println!("Already compliant");
    return Ok(());
}

println!("{} errors found, attempting conversion...", result.errors.len());

// Step 2: Automatic conversion
let conversion = convert_to_pdf_a(&mut doc, level)?;
println!("{} actions taken", conversion.actions.len());

// Step 3: Re-validate
let result = validate_pdf_a(&mut doc, level)?;
if result.has_errors() {
    println!("{} errors remain after conversion:", result.errors.len());
    for e in &result.errors {
        println!("  {} -- {}", e.code, e.message);
    }
} else {
    println!("Document is now PDF/A-2b compliant");
}

PdfALevel Methods

Перечисление PdfALevel включает вспомогательные методы для запроса возможностей уровня:

Метод Возвращает Описание
part() PdfAPart Часть ISO 19005 (Part1, Part2, Part3)
conformance() char Буква соответствия (‘a’, ‘b’ или ‘u’)
requires_structure() bool Обязательно ли тегированное дерево структуры
requires_unicode() bool Обязательно ли отображение Unicode
allows_transparency() bool Допускается ли прозрачность
allows_jpeg2000() bool Допускаются ли изображения JPEG 2000
allows_embedded_files() bool Допускаются ли файловые вложения
xmp_part() &str Значение XMP pdfaid:part
xmp_conformance() &str Значение XMP pdfaid:conformance
from_xmp(part, conformance) Option<Self> Разбор уровня из значений метаданных XMP

Следующие шаги