Kiểm tra tuân thủ theo lô qua Connect

Tổng quan nhanh

Dùng công thức này để kiểm tra nhiều tệp PDF theo một hoặc nhiều chính sách được đặt tên trong một lệnh gọi. Công thức này gọi công cụ kiểm tra tuân thủ theo lô qua các phương thức truyền tải của Connect. Công cụ này thuộc bậc Enterprise: một phép thăm dò class_exists() sẽ phát hiện công cụ này, và công cụ chỉ được đăng ký khi nextpdf/premium được cài đặt cùng với máy chủ. Công cụ kiểm tra từng tài liệu theo mọi chính sách trong yêu cầu, rồi trả về một báo cáo hợp nhất theo từng tài liệu và từng chính sách.

Tương tự kiểm tra một tài liệu, kết quả “đạt” theo từng chính sách chỉ có nghĩa là công cụ đã kiểm tra những quy tắc mà nó triển khai. Đây không phải là chứng nhận sự phù hợp độc lập. Chỉ trình xác thực mới đưa ra phán quyết về sự phù hợp.

Cài đặt

composer require nextpdf/server

Xác nhận công cụ theo lô Enterprise có sẵn bằng một lệnh gọi tools/list. Xem /connect/tool-catalog/.

Tổng quan khái niệm

Một tiêu chuẩn đặt ra các yêu cầu cho từng tài liệu, và trình kiểm tra đánh giá từng tài liệu theo những yêu cầu đó (PDF/A-4 §6.2.3). Sự phù hợp được xác định theo các yêu cầu, chứ không phải do bên tạo ra tài liệu khẳng định (PDF/A-4 §6.7.3). Đối với các chính sách liên quan đến chữ ký, các cấp baseline của PDF Advanced Electronic Signatures (PAdES) là những cấp riêng biệt, và các cấp B-LT/B-LTA (vật liệu xác thực, dấu thời gian lưu trữ) là khả năng chỉ có ở bậc Enterprise (ETSI EN 319 142-2 §5.5). Kết quả theo lô vẫn áp dụng cùng ý nghĩa hẹp “không có quy tắc đã triển khai nào bị lỗi” cho toàn bộ tập tài liệu.

Bề mặt API

Dùng tools/list để đối chiếu tên công cụ với sổ đăng ký đang chạy. Danh mục chính thức là /connect/tool-catalog/. Công thức này không lặp lại số lượng công cụ.

Mẫu mã — khởi đầu nhanh

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "batch_compliance_check",
    "arguments": {
      "sources": ["/data/q1.pdf", "/data/q2.pdf"],
      "policies": ["pdfa-4"]
    }
  }
}

Mẫu mã — môi trường production

curl -sS -X POST https://connect.example.com/v1/tools/batch_compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sources":["/data/q1.pdf","/data/q2.pdf"],"policies":["pdfa-4"]}' \
  -o /tmp/batch.json -w '%{http_code}' > /tmp/batch-status || {
    echo "transport failure invoking batch_compliance_check" >&2; exit 1; }

Phản hồi gồm batch id, các số đếm pass/fail tổng hợp, cùng một mảng checks theo từng tài liệu với kết quả theo từng chính sách và các lý do thất bại. Lọc các trường hợp thất bại, khắc phục chúng, rồi chỉ gửi lại những tài liệu bị ảnh hưởng.

Trường hợp đặc biệt và lưu ý

sources hoặc policies rỗng sẽ trả về một lỗi tham số không hợp lệ.
Tệp bị thiếu được ghi nhận dưới dạng lỗi trong từng kết quả thay vì làm hỏng toàn bộ lô. Kiểm tra từng kết quả để xem có trường lỗi hay không.
Vượt quá giới hạn kích thước lô sẽ trả về lỗi rõ ràng. Chia công việc thành các lô nhỏ hơn.
Policy id không xác định là lỗi tiêu chuẩn không xác định, có nêu tên các định danh được công nhận. Các chính sách chữ ký tham chiếu đến B-LT/B-LTA chỉ có ý nghĩa trên một triển khai Enterprise có thể tạo ra vật liệu đó.
Công cụ không có sẵn. Nếu không có nextpdf/premium thì công cụ theo lô Enterprise không được đăng ký; lệnh gọi sẽ thất bại với lỗi công cụ không xác định.

Hiệu năng

Ngân sách trong front-matter là giới hạn mang tính tài liệu. Công cụ xử lý tài liệu ở phía máy chủ, và mỗi tài liệu có thể dùng một lượng bộ nhớ làm việc đáng kể. Hãy định kích thước lô theo bộ nhớ của máy chủ thay vì nâng giới hạn thời gian chờ toàn cục.

Lưu ý bảo mật

Đừng ghi các đường dẫn nguồn hoặc toàn bộ báo cáo vào mức nhật ký được gửi ra bên ngoài. Chỉ ghi nhật ký batch id và các số đếm pass/fail tổng hợp. Kết quả “đạt” theo từng chính sách mô tả tập quy tắc đã triển khai, chứ không phải sự bảo đảm về bảo mật hay pháp lý.

Sự phù hợp

Tuyên bố	Điều khoản	reference_id
Tiêu chuẩn nêu các yêu cầu; trình kiểm tra đánh giá từng tài liệu	PDF/A-4 §6.2.3
Sự phù hợp được xác định theo các yêu cầu, không do bên tạo ra tài liệu khẳng định	PDF/A-4 §6.7.3
B-LT/B-LTA bổ sung vật liệu xác thực; là các cấp riêng biệt, chỉ có ở bậc Enterprise	ETSI EN 319 142-2 §5.5

Việc hỗ trợ kiểm tra tuân thủ theo lô không phải là chứng nhận sự phù hợp. Chỉ trình xác thực độc lập mới đưa ra phán quyết về sự phù hợp cho từng tài liệu.

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

Công cụ kiểm tra tuân thủ theo lô thuộc bậc Enterprise và chỉ được đăng ký khi nextpdf/premium được cài đặt cùng với máy chủ.

Chi tiết riêng của Connect

Khả năng truyền tải (MCP / REST / gRPC)

Gọi công cụ theo cùng một cách qua Model Context Protocol (MCP) tools/call, endpoint công cụ REST và dịch vụ gRPC thông qua trình thực thi công cụ dùng chung.

Bậc rủi ro HITL

Kiểm tra theo lô chỉ đọc và mặc định không phải là approval_required. Ghi đè của người vận hành chỉ có thể nâng mức rủi ro của công cụ lên. Xem /connect/hitl-risk-tiers/ để biết chi tiết.

Phong bì JSON của cổng xác nhận

Công cụ không kích hoạt cổng này trừ khi ghi đè của người vận hành nâng nó lên approval_required. Hợp đồng phong bì và token dùng một lần nằm trong /connect/hitl-risk-tiers/.

Xem thêm

/cookbook/connect/compliance-check/ — kiểm tra tuân thủ cho một tài liệu.
/cookbook/connect/ai-ready-certification/ — kiểm tra mức độ sẵn sàng cho AI ở phạm vi rộng hơn.
/connect/tool-catalog/ — tính toán tập công cụ theo từng bậc.
/connect/hitl-risk-tiers/ — mô hình rủi ro và hành vi của cổng.