Chọn chế độ tuân thủ qua Connect

Ranh giới. Khi đặt một chế độ tuân thủ, engine sẽ đấu nối catalog và metadata theo yêu cầu của tiêu chuẩn tương ứng. Thao tác này khiến engine tạo đầu ra nhằm tuân thủ tiêu chuẩn đó. Nó không làm cho tài liệu trở nên “tuân thủ”. Chỉ một trình xác thực, chẳng hạn như veraPDF, mới quyết định việc tuân thủ. Hãy hiểu mọi câu nói về “tuân thủ” trên trang này là “nhằm tuân thủ; trình xác thực mới xác định kết quả”.

Tổng quan nhanh

Một tài liệu mang đúng một bộ phân biệt tuân thủ: chế độ thường, tagged/PDF-UA hoặc PDF/A. Bộ phân biệt đó cho writer biết cần phát ra phần đấu nối catalog, cấu trúc và metadata nào. Dùng công thức này để đặt bộ phân biệt qua các transport của Connect. Bộ đặt chế độ tagged thuộc core. Bộ đặt chế độ PDF/A-4 vĩnh viễn thuộc bậc Premium (ADR-011) và chỉ đăng ký khi nextpdf/premium được cài đặt cùng với server.

Nếu bạn gọi cả hai bộ đặt, cả hai feature stack đều được xếp chồng. Bộ phân biệt đơn giá trị vẫn được rút gọn theo nguyên tắc lần gọi cuối thắng, và engine phát ra một cảnh báo ghi đè để công cụ có thể quan sát lần ghi đè đó.

Cài đặt

composer require nextpdf/server

Hãy xác nhận rằng bộ đặt chế độ PDF/A hiện diện bằng một lệnh gọi tools/list. Xem /connect/tool-catalog/.

Tổng quan khái niệm

Dấu hiệu tuân thủ khai báo sự tuân thủ dự kiến. Chỉ trình xác thực mới xác định sự tuân thủ thực tế (PDF/A-4 §6.7.3). Sự tuân thủ được xác định dựa trên các yêu cầu của tiêu chuẩn, chứ không dựa trên khẳng định của phần mềm tạo ra tài liệu (PDF/A-4 §6.7.3). Chế độ tagged đấu nối cây cấu trúc và các mục mark-info trong catalog (ISO 32000-2 §14.7).

Việc chuyển chế độ là một thao tác đấu nối. Nó chuẩn bị tài liệu cho một bước kiểm tra theo tiêu chuẩn. Bản thân thao tác này không phải là kết luận tuân thủ.

Bề mặt API

Hãy kiểm chứng tên các tool theo registry đang chạy thông qua tools/list. Catalog chính thức là /connect/tool-catalog/. Công thức này không nhắc lại số lượng tool. Hãy chọn bộ phân biệt trước lệnh gọi nội dung đầu tiên. Writer đóng băng chế độ tại thời điểm phát ra trang đầu tiên.

Mẫu mã — bắt đầu nhanh

Tạo một tài liệu, rồi chuyển nó sang chế độ tagged/PDF-UA:

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

Phản hồi báo cáo các vị từ chế độ đang hoạt động (tagged / accessibility / archival) mà writer kiểm tra tại mọi điểm phát ra. Nó cũng báo cáo phần đấu nối catalog đã được thêm vào. Các vị từ cho biết writer sẽ phát ra những gì; chúng không khẳng định rằng kết quả là tuân thủ.

Mẫu mã — Production

Chuyển sang PDF/A-4 (bậc Premium), rồi chạy bước kiểm tra. Hãy xem trạng thái không thành công là một kết quả bình thường cần được kiểm tra:

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

Nếu bạn gọi cả hai bộ đặt, bộ phân biệt rút gọn theo nguyên tắc lần gọi cuối thắng và engine phát ra một cảnh báo ghi đè. Hãy chạy bước kiểm tra tiêu chuẩn cho từng flavour mà feature stack vẫn còn được đấu nối, vì phần đấu nối được cộng dồn dù bộ phân biệt đơn thì không.

Trường hợp biên & điểm cần lưu ý

Đặt chế độ sau trang đầu tiên sẽ bị từ chối với lỗi chế độ đã đóng băng. Hãy đặt chế độ ngay sau khi tạo tài liệu.
Bộ đặt PDF/A khi không có Premium sẽ thất bại — nó vĩnh viễn thuộc bậc Premium (ADR-011). Một tài liệu PDF 2.0 thường không cần chế độ PDF/A.
Trường hợp enum không xác định sẽ bị từ chối. Trường hợp lưu trữ được hỗ trợ là PDF/A-4 (các profile PDF/A cũ đã ngừng hỗ trợ).
Thao tác bị chế độ lưu trữ cấm (ví dụ JavaScript nhúng) sẽ bị từ chối khi vị từ lưu trữ đang hoạt động.
Flavour/chế độ không khớp ở bước kiểm tra sẽ trả về một phát hiện về dấu hiệu không tuân thủ. Hãy truyền flavour khớp với chế độ đang hoạt động, hoặc truyền cả hai khi cả hai stack đều được đấu nối.

Hiệu năng

Ngân sách trong frontmatter là một giới hạn dùng cho tài liệu. Việc đấu nối chế độ không thêm một pha riêng nào có thể đo được.

Ghi chú bảo mật

Không áp dụng gì thêm ngoài hướng dẫn chung về transport của Connect.

Tuân thủ

Tuyên bố	Điều khoản	reference_id
Dấu hiệu tuân thủ khai báo sự tuân thủ dự kiến; chỉ trình xác thực mới quyết định	PDF/A-4 §6.7.3
Sự tuân thủ được xác định dựa trên các yêu cầu, chứ không phải do bên tạo tài liệu khẳng định	PDF/A-4 §6.7.3
Chế độ tagged đấu nối cây cấu trúc và các mục mark-info	ISO 32000-2 §14.7

Việc chọn một chế độ tuân thủ khiến engine tạo đầu ra nhằm tuân thủ. Đây không phải là một chứng nhận tuân thủ. Chỉ trình xác thực mới xác định kết quả.

Bối cảnh thương mại

Bộ đặt chế độ PDF/A-4 vĩnh viễn thuộc bậc Premium (ADR-011) và chỉ đăng ký khi nextpdf/premium được cài đặt cùng với server. Bộ đặt chế độ tagged là một khả năng thuộc core.

Đặc thù của Connect

Khả dụng theo transport (MCP / REST / gRPC)

Các bộ đặt chế độ và bước kiểm tra được gọi theo cùng một cách qua MCP tools/call, REST tool endpoint và dịch vụ gRPC thông qua bộ thực thi tool dùng chung.

Bậc rủi ro HITL

Các bộ đặt chế độ thuộc mức thận trọng. Bước kiểm tra chỉ đọc. Theo mặc định, không mục nào là approval_required. Một thiết lập ghi đè của người vận hành chỉ có thể nâng mức rủi ro. Xem /connect/hitl-risk-tiers/.

JSON envelope của cổng xác nhận

Các tool này không kích hoạt cổng trừ khi một thiết lập ghi đè của người vận hành nâng một tool lên approval_required. Hợp đồng về envelope và token dùng một lần được mô tả ở /connect/hitl-risk-tiers/.

Xem thêm

/cookbook/connect/compliance-check/ — xác thực theo tiêu chuẩn đang hoạt động.
/cookbook/connect/tagged-pdf-tutorial/ — hướng dẫn tagged-PDF từ đầu đến cuối.
/connect/tool-catalog/ — cách tính tập tool theo bậc.
/connect/hitl-risk-tiers/ — mô hình rủi ro và cổng.