Выбор режима соответствия через Connect

Граница. Установка режима соответствия настраивает каталог и метаданные, требуемые соответствующим стандартом. Поэтому движок создаёт вывод, предназначенный для соответствия этому стандарту. Это не делает документ “соответствующим”. Соответствие определяет валидатор, например veraPDF. Каждое утверждение о “соответствии” на этой странице понимайте как “предназначено для соответствия; результат определяет валидатор”.

Кратко

В документе есть ровно один дискриминатор соответствия: обычный режим, режим tagged/PDF-UA или режим PDF/A. По этому дискриминатору модуль записи определяет, какую связку каталога, структуры и метаданных формировать. Используйте этот рецепт, чтобы задать дискриминатор через транспорты Connect. Установщик режима tagged входит в ядро. Установщик режима PDF/A-4 закреплён за уровнем Premium (ADR-011) и регистрируется, только когда nextpdf/premium установлен вместе с сервером.

Если вы вызываете оба установщика, оба стека возможностей применяются одновременно. Дискриминатор с единственным значением всё равно сворачивается по правилу “выигрывает последний”, и движок выдаёт предупреждение о перезаписи, чтобы инструменты могли её отследить.

Установка

composer require nextpdf/server

Проверьте наличие установщика режима PDF/A вызовом tools/list. См. /connect/tool-catalog/.

Концептуальный обзор

Маркер соответствия заявляет предполагаемое соответствие. Фактическое соответствие определяет валидатор (PDF/A-4 §6.7.3). Соответствие определяется по требованиям стандарта, а не заявлением ПО, которое создаёт документ (PDF/A-4 §6.7.3). Режим tagged настраивает дерево структуры и записи mark-info в каталоге (ISO 32000-2 §14.7).

Переключение режима — это операция настройки связки. Она подготавливает документ к проверке на соответствие стандарту, но сама по себе не является результатом такой проверки.

Поверхность API

Имена инструментов сверяются с рабочим реестром через tools/list. Эталонный каталог — /connect/tool-catalog/. Этот рецепт не дублирует перечень инструментов. Выберите дискриминатор до первого вызова, добавляющего содержимое. Модуль записи фиксирует режим при формировании первой страницы.

Пример кода — быстрый старт

Создайте документ, затем переключите его в режим tagged/PDF-UA:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

В ответе перечислены активные предикаты режима (tagged / accessibility / archival), которые модуль записи проверяет в каждой точке формирования. Также указана добавленная связка каталога. Предикаты показывают, что сформирует модуль записи; они не утверждают, что результат соответствует стандарту.

Пример кода — продакшен

Переключитесь на PDF/A-4 (уровень Premium), затем запустите проверку. Считайте неуспешный статус обычным результатом для анализа:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

Если вы вызываете оба установщика, дискриминатор сворачивается по правилу “выигрывает последний”, и движок выдаёт предупреждение о перезаписи. Запускайте проверку на соответствие стандартам для каждой разновидности, чей стек возможностей остаётся подключённым: связка аддитивна, а единственный дискриминатор — нет.

Граничные случаи и подводные камни

Установка режима после первой страницы отклоняется с ошибкой о зафиксированном режиме. Устанавливайте режим сразу после создания документа.
Установщик PDF/A без Premium завершается ошибкой — он закреплён за уровнем Premium (ADR-011). Обычному документу PDF 2.0 режим PDF/A не нужен.
Неизвестное значение перечисления отклоняется. Поддерживаемый архивный вариант — PDF/A-4 (устаревшие профили PDF/A были выведены из обращения).
Операция, запрещённая архивным режимом (например, встроенный JavaScript), отклоняется, пока активен архивный предикат.
Несоответствие разновидности и режима при проверке возвращает заключение о несоответствующем маркере. Передавайте разновидность, соответствующую активному режиму, или обе, когда подключены оба стека.

Производительность

Бюджет во frontmatter — это документационное ограничение. Настройка связки режима не добавляет отдельной измеримой фазы.

Замечания по безопасности

Неприменимо, кроме общих рекомендаций по транспорту Connect.

Соответствие

Заявление	Пункт	reference_id (идентификатор ссылки)
Маркер соответствия заявляет предполагаемое соответствие; решение принимает валидатор	PDF/A-4 §6.7.3
Соответствие определяется по требованиям, а не утверждается производителем	PDF/A-4 §6.7.3
Режим tagged настраивает дерево структуры и записи mark-info	ISO 32000-2 §14.7

Выбор режима соответствия настраивает движок на создание вывода, предназначенного для соответствия. Это не сертификация соответствия. Результат определяет валидатор.

Коммерческий контекст

Установщик режима PDF/A-4 закреплён за уровнем Premium (ADR-011) и регистрируется, только когда nextpdf/premium установлен вместе с сервером. Установщик режима tagged входит в ядро.

Особенности Connect

Доступность транспортов (MCP / REST / gRPC)

Установщики режима и проверка одинаково вызываются через MCP tools/call, REST-конечную точку инструмента и службу gRPC с помощью общего исполнителя инструментов.

Уровень риска HITL

Установщики режима относятся к уровню предупреждения. Проверка работает в режиме только чтения. Ни один из этих инструментов не помечен approval_required по умолчанию. Переопределение оператором может только повысить риск. См. /connect/hitl-risk-tiers/.

JSON-конверт шлюза подтверждения

Эти инструменты не запускают шлюз, если только переопределение оператором не повысит какой-либо из них до approval_required. Контракт конверта и одноразового токена описан в /connect/hitl-risk-tiers/.

См. также

/cookbook/connect/compliance-check/ — проверка на соответствие активному стандарту.
/cookbook/connect/tagged-pdf-tutorial/ — сквозное пошаговое руководство по tagged-PDF.
/connect/tool-catalog/ — вычисление набора инструментов по уровням.
/connect/hitl-risk-tiers/ — модель риска и шлюз.