Pemeriksaan standar secara batch melalui Connect

Sekilas pandang

Gunakan resep ini untuk memeriksa banyak PDF terhadap satu atau beberapa kebijakan bernama dalam satu panggilan. Resep ini memanggil alat batch compliance melalui transport Connect. Alat ini berada di tingkat Enterprise: probe class_exists() menemukannya, dan alat ini hanya terdaftar ketika nextpdf/premium terpasang bersama server. Alat ini memeriksa setiap dokumen terhadap setiap kebijakan dalam permintaan, lalu mengembalikan laporan gabungan per dokumen, per kebijakan.

Seperti halnya pemeriksaan dokumen tunggal, status “lolos” untuk tiap kebijakan hanya berarti bahwa alat tersebut telah memeriksa aturan yang diterapkannya. Ini bukan sertifikasi konformitas yang independen. Penentuan konformitas dilakukan oleh validator.

Pemasangan

composer require nextpdf/server

Pastikan alat batch Enterprise tersedia melalui panggilan tools/list. Lihat /connect/tool-catalog/.

Tinjauan konseptual

Sebuah standar menetapkan persyaratan untuk setiap dokumen, dan pemeriksa mengevaluasi setiap dokumen terhadap persyaratan tersebut (PDF/A-4 §6.2.3). Konformitas ditentukan berdasarkan persyaratan, bukan dinyatakan oleh produsen (PDF/A-4 §6.7.3). Untuk kebijakan terkait tanda tangan, level baseline PDF Advanced Electronic Signatures (PAdES) bersifat terpisah, dan level B-LT/B-LTA (materi validasi, stempel waktu arsip) merupakan kemampuan khusus Enterprise (ETSI EN 319 142-2 §5.5). Hasil batch memakai makna sempit yang sama di seluruh kumpulan dokumen: “tidak ada aturan terimplementasi yang gagal”.

Permukaan API

Verifikasi nama alat terhadap registry yang sedang berjalan dengan tools/list. Katalog resminya ada di /connect/tool-catalog/. Resep ini tidak menyebutkan ulang jumlah alat.

Contoh kode — Mulai cepat

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

Contoh kode — Produksi

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; }

Respons mencakup id batch, jumlah agregat pass/fail, dan larik checks per dokumen yang berisi hasil per kebijakan serta alasan kegagalan. Saring hasil yang gagal, perbaiki, lalu kirim ulang hanya dokumen yang terdampak.

Kasus tepi & jebakan

sources atau policies yang kosong mengembalikan galat parameter tidak valid.
Berkas yang hilang muncul sebagai galat pada masing-masing hasil, bukan membuat seluruh batch gagal. Periksa setiap hasil untuk melihat apakah ada field error.
Batas ukuran batch terlampaui mengembalikan galat eksplisit. Pecah pekerjaan menjadi batch yang lebih kecil.
Id kebijakan yang tidak dikenal merupakan galat standar tidak dikenal yang menyebutkan identifier yang dikenali. Kebijakan tanda tangan yang merujuk pada B-LT/B-LTA hanya bermakna pada deployment Enterprise yang dapat menghasilkan materi tersebut.
Alat tidak tersedia. Tanpa nextpdf/premium, alat batch Enterprise tidak terdaftar; panggilan gagal dengan galat alat tidak dikenal.

Kinerja

Anggaran dalam front matter adalah batas dokumentasi. Alat ini memproses dokumen di sisi server, dan setiap dokumen dapat menggunakan working memory yang cukup besar. Sesuaikan ukuran batch dengan memori host alih-alih menaikkan timeout global.

Catatan keamanan

Jangan mencatat jalur sumber atau laporan lengkap pada level log yang dikirim ke luar. Catat hanya id batch dan jumlah agregat pass/fail. Status “lolos” untuk tiap kebijakan menjelaskan kumpulan aturan yang diterapkan, bukan jaminan keamanan atau hukum.

Konformitas

Klaim	Klausa	reference_id
Standar menetapkan persyaratan; pemeriksa mengevaluasi setiap dokumen	PDF/A-4 §6.2.3
Konformitas ditentukan terhadap persyaratan, bukan dinyatakan oleh produsen	PDF/A-4 §6.7.3
B-LT/B-LTA menambahkan materi validasi; tingkat yang berbeda dan khusus Enterprise	ETSI EN 319 142-2 §5.5

Dukungan untuk pemeriksaan standar secara batch bukanlah sertifikasi konformitas. Konformitas per dokumen ditentukan oleh validator independen.

Konteks komersial

Alat batch compliance berada di tingkat Enterprise dan hanya terdaftar ketika nextpdf/premium terpasang bersama server.

Hal khusus Connect

Ketersediaan transport (MCP / REST / gRPC)

Panggil alat ini dengan cara yang sama melalui tools/call Model Context Protocol (MCP), endpoint alat REST, dan layanan gRPC melalui eksekutor alat bersama.

Tingkat risiko HITL

Pemeriksaan batch bersifat hanya-baca dan secara default tidak approval_required. Penggantian oleh operator hanya dapat menaikkan tingkat risikonya. Lihat /connect/hitl-risk-tiers/ untuk detailnya.

Envelope JSON untuk gerbang konfirmasi

Alat ini tidak memicu gerbang kecuali penggantian oleh operator menaikkannya menjadi approval_required. Kontrak envelope dan token sekali pakai tersedia di /connect/hitl-risk-tiers/.

Lihat juga

/cookbook/connect/compliance-check/ — pemeriksaan standar dokumen tunggal.
/cookbook/connect/ai-ready-certification/ — pemeriksaan kesiapan AI yang lebih luas.
/connect/tool-catalog/ — komputasi kumpulan alat per tingkat.
/connect/hitl-risk-tiers/ — model risiko dan perilaku gerbang.