Connect에서 적합성 모드 선택

Connect에서 적합성 모드 선택

경계. 적합성 모드를 설정하면 해당 표준에서 기대하는 카탈로그와 메타데이터가 배선됩니다. 즉, 엔진이 해당 표준에 적합하도록 의도된 출력을 생성하도록 합니다. 그렇다고 문서를 “적합”하게 만드는 것은 아닙니다 — 적합성은 검증기(예: veraPDF)가 판정합니다. 이 페이지의 모든 “적합성” 관련 진술은 “적합하도록 의도됨; 결과는 검증기가 결정함”으로 읽으십시오.

한눈에 보기

문서에는 정확히 하나의 적합성 판별자만 있습니다: 일반(plain), tagged/PDF-UA 모드 또는 PDF/A 모드입니다. 해당 판별자는 작성기가 어떤 카탈로그, 구조, 메타데이터 배선을 방출할지를 결정합니다. 이 레시피에서는 Connect 전송 계층에서 판별자를 설정합니다. tagged 모드 설정자는 코어 기능입니다. PDF/A-4 모드 설정자는 영구적으로 Premium 등급(ADR-011)이며, 서버와 함께 nextpdf/premium이 설치된 경우에만 등록됩니다.

두 설정자를 모두 호출하면 두 기능 스택이 중첩되어 적용됩니다. 단일 값 판별자는 여전히 마지막 호출이 우선하는 방식으로 수렴하며, 도구가 덮어쓰기를 감지할 수 있도록 덮어쓰기(clobber) 경고가 방출됩니다.

설치

composer require nextpdf/server

tools/list를 호출해 PDF/A 모드 설정자가 있는지 확인합니다. /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 / 접근성 / 보존)를 보고합니다. 또한 추가된 카탈로그 배선도 보고합니다. 술어는 작성기가 무엇을 방출할지를 보고할 뿐, 결과가 적합하다고 주장하지 않습니다.

코드 샘플 — 프로덕션

PDF/A-4(Premium 등급)로 전환한 뒤 검사합니다. 성공이 아닌 상태도 확인해야 할 정상적인 결과로 취급하십시오:

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

두 설정자가 모두 호출되면 판별자는 마지막 호출이 우선하는 방식으로 수렴하고 덮어쓰기(clobber) 경고가 방출됩니다. 단일 판별자는 누적되지 않지만 배선은 누적되므로, 기능 스택이 배선된 채 남아 있는 각 flavour에 대해 표준 검사를 실행하십시오.

엣지 케이스 및 주의사항

• 첫 페이지 이후의 모드 설정은 모드 고정(frozen-mode) 오류로 거부됩니다. 문서를 생성한 직후 모드를 설정하십시오.
• Premium 없이 PDF/A 설정자를 사용하면 실패합니다 — 영구적으로 Premium 등급(ADR-011)입니다. 일반 PDF 2.0 문서는 PDF/A 모드가 필요하지 않습니다.
• 알 수 없는 enum 케이스는 거부됩니다. 지원되는 보존 케이스는 PDF/A-4입니다(레거시 PDF/A 프로파일은 폐기되었습니다).
• 보존 모드에서 금지된 작업(예: 임베디드 JavaScript)은 보존 술어가 활성 상태인 동안 거부됩니다.
• 검사 시 flavour/모드 불일치는 비적합 마커 발견 결과를 반환합니다. 활성 모드와 일치하는 flavour를 전달하거나, 두 스택이 모두 배선된 경우에는 둘 다 전달하십시오.

성능

front-matter 예산은 문서상 상한값입니다. 모드 배선은 측정 가능한 별도의 단계를 추가하지 않습니다.

보안 참고사항

일반 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 위험 등급

모드 설정자는 주의(caution) 수준입니다. 검사는 읽기 전용입니다. 기본적으로 둘 중 어느 것도 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/ — 위험 모델과 게이트.