Memilih mode konformitas melalui Connect

Batas. Menetapkan mode konformitas mengaitkan catalog dan metadata yang disyaratkan oleh standar terkait. Ini membuat mesin menghasilkan keluaran yang dimaksudkan untuk memenuhi standar tersebut. Ini tidak membuat dokumen menjadi “konform”. Validator seperti veraPDF-lah yang menentukan konformitas. Baca setiap pernyataan “konformitas” pada halaman ini sebagai “dimaksudkan untuk memenuhi; validator yang menentukan hasilnya”.

Sekilas pandang

Setiap dokumen membawa tepat satu diskriminator konformitas: mode biasa, mode tagged/PDF-UA, atau mode PDF/A. Diskriminator tersebut memberi tahu writer pengkabelan catalog, struktur, dan metadata mana yang harus dihasilkan. Gunakan resep ini untuk menetapkan diskriminator melalui transport Connect. Penyetel mode tagged adalah bagian dari core. Penyetel mode PDF/A-4 secara permanen berada di tier Premium (ADR-011) dan hanya teregistrasi ketika nextpdf/premium terpasang bersama server.

Jika Anda memanggil kedua penyetel, kedua tumpukan fitur akan dilapiskan. Diskriminator bernilai tunggal tetap diselesaikan dengan aturan last-wins, dan mesin memunculkan peringatan clobber agar perkakas dapat mengamati penimpaan tersebut.

Pemasangan

composer require nextpdf/server

Pastikan penyetel mode PDF/A tersedia melalui panggilan tools/list. Lihat /connect/tool-catalog/.

Gambaran konseptual

Penanda konformitas mendeklarasikan konformitas yang dimaksudkan. Validator menentukan konformitas yang sebenarnya (PDF/A-4 §6.7.3). Konformitas ditentukan terhadap persyaratan standar, bukan dinyatakan oleh perangkat lunak yang menghasilkannya (PDF/A-4 §6.7.3). Mode tagged mengaitkan structure tree dan entri catalog mark-info (ISO 32000-2 §14.7).

Pengalihan mode adalah operasi pengkabelan. Operasi ini menyiapkan dokumen untuk diperiksa terhadap standar. Operasi ini sendiri bukan hasil konformitas.

Permukaan API

Nama tool diverifikasi terhadap registry yang sedang berjalan melalui tools/list. Catalog resmi yang berlaku adalah /connect/tool-catalog/. Resep ini tidak mengulang jumlah tool. Pilih diskriminator sebelum panggilan konten yang pertama. Writer membekukan mode pada saat halaman pertama dihasilkan.

Contoh kode — Mulai cepat

Buat sebuah dokumen, lalu alihkan ke mode tagged/PDF-UA:

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

Respons melaporkan predikat mode aktif (tagged / aksesibilitas / arsip) yang diperiksa writer di setiap titik pembuatan keluaran. Respons juga melaporkan pengkabelan catalog yang ditambahkannya. Predikat tersebut menunjukkan apa yang akan dihasilkan writer; predikat tersebut bukan pernyataan bahwa hasilnya konform.

Contoh kode — Produksi

Alihkan ke PDF/A-4 (tier Premium), lalu jalankan pemeriksaan. Perlakukan status non-sukses sebagai hasil biasa yang perlu ditinjau:

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

Jika Anda memanggil kedua penyetel, diskriminator diselesaikan dengan last-wins dan mesin memunculkan peringatan clobber. Jalankan pemeriksaan standar untuk setiap varian yang tumpukan fiturnya tetap terkait, karena pengkabelan bersifat aditif meskipun diskriminator tunggalnya tidak bersifat aditif.

Kasus tepi & jebakan

Penetapan mode setelah halaman pertama ditolak dengan galat mode-beku. Tetapkan mode segera setelah dokumen dibuat.
Penyetel PDF/A tanpa Premium gagal — penyetel ini secara permanen berada di tier Premium (ADR-011). Dokumen PDF 2.0 biasa tidak memerlukan mode PDF/A.
Kasus enum yang tidak dikenal ditolak. Kasus arsip yang didukung adalah PDF/A-4 (profil PDF/A lama telah dipensiunkan).
Operasi yang dilarang oleh mode arsip (misalnya JavaScript tertanam) ditolak selama predikat arsip aktif.
Ketidakcocokan varian/mode pada pemeriksaan mengembalikan temuan penanda non-konform. Berikan varian yang cocok dengan mode aktif, atau keduanya ketika kedua tumpukan terkait.

Kinerja

Anggaran frontmatter adalah batas dokumentasi. Pengkabelan mode tidak menambahkan fase terpisah yang dapat diukur.

Catatan keamanan

Tidak ada catatan khusus di luar panduan transport Connect umum.

Konformitas

Klaim	Klausa	reference_id
Penanda konformitas mendeklarasikan konformitas yang dimaksudkan; validatorlah yang menentukan	PDF/A-4 §6.7.3
Konformitas ditentukan terhadap persyaratan, bukan dinyatakan oleh penghasilnya	PDF/A-4 §6.7.3
Mode tagged mengaitkan structure tree dan entri mark-info	ISO 32000-2 §14.7

Memilih mode konformitas membuat mesin menghasilkan keluaran yang dimaksudkan untuk memenuhi. Ini bukan sertifikasi konformitas. Validatorlah yang menentukan hasilnya.

Konteks komersial

Penyetel mode PDF/A-4 secara permanen berada di tier Premium (ADR-011) dan hanya teregistrasi ketika nextpdf/premium terpasang bersama server. Penyetel mode tagged merupakan kapabilitas core.

Detail khusus Connect

Ketersediaan transport (MCP / REST / gRPC)

Penyetel mode dan pemeriksaan dipanggil dengan cara yang sama melalui MCP tools/call, endpoint tool REST, dan layanan gRPC melalui eksekutor tool bersama.

Tier risiko HITL

Penyetel mode berada pada tingkat hati-hati. Pemeriksaan bersifat hanya-baca. Secara baku, tidak ada yang approval_required. Penimpaan oleh operator hanya boleh menaikkan risiko. Lihat /connect/hitl-risk-tiers/.

Amplop JSON gerbang konfirmasi

Tool ini tidak memicu gerbang kecuali penimpaan oleh operator menaikkan salah satunya menjadi approval_required. Kontrak amplop dan token sekali-pakai tersedia di /connect/hitl-risk-tiers/.

Lihat juga

/cookbook/connect/compliance-check/ — validasi terhadap standar yang aktif.
/cookbook/connect/tagged-pdf-tutorial/ — panduan tagged-PDF menyeluruh dari awal hingga akhir.
/connect/tool-catalog/ — penghitungan kumpulan tool per tier.
/connect/hitl-risk-tiers/ — model risiko dan gerbangnya.