Memeriksa aksesibilitas struktural pada NextPDF Connect (Pro)

Sekilas pandang

Jalankan analisis aksesibilitas struktural pada NextPDF Connect. Gunakan check_accessibility; alat ini diverifikasi terhadap penyedia alat Pro yang mendaftarkan new CheckAccessibilityTool() dengan nama protokol check_accessibility. Deskripsi alat ini menetapkan cakupannya: alat ini menganalisis aksesibilitas struktural PDF — judul, tabel, gambar, dan indikator urutan baca. Alat ini mengembalikan indikator dan petunjuk perbaikan. Alat ini tidak menyertifikasi kesesuaian Portable Document Format/Universal Accessibility (PDF/UA) atau Web Content Accessibility Guidelines (WCAG). Penentuan tersebut dilakukan oleh pemeriksa kesesuaian, seperti veraPDF atau alat uji PDF/UA. check_accessibility adalah alat tingkat Pro. Saat boot, NextPDF memeriksanya dengan class_exists() dan mendaftarkannya hanya jika paket Pro terpasang.

Pemasangan

composer require nextpdf/server
composer require nextpdf/pro

Ikat transport, lalu pastikan alat tersebut tersedia melalui diagnostic.capabilities.

Tinjauan konseptual

Struktur yang aksesibel bergantung pada dua hal: pohon struktur logis yang terdiri dari elemen struktur (ISO 32000-2 §14.7) dan bahasa dokumen yang dideklarasikan melalui entri Lang pada katalog (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility memeriksa indikator struktural ini dan mengembalikan temuan beserta tingkat keparahan dan panduan perbaikan. Perlakukan skor numerik atau nilai lulus/gagal (pass/fail) apa pun dalam laporan sebagai ringkasan indikator, bukan sertifikasi. Gunakan laporan ini untuk triase.

Permukaan API

Alat	Tingkat	Peran	Tingkat risiko
`create_pdf`, `add_text`	Core	Membangun konten untuk diperiksa	Aman / Hati-hati
`check_accessibility`	Pro	Analisis aksesibilitas struktural	Aman
`output_pdf`	Core	Merender dan mengembalikan PDF	Perlu Persetujuan / Tinjau (base64)

Nama alat adalah nama protokol dalam registri. Katalog alat adalah katalog resmi. Tingkat yang terpasang menentukan alat mana yang tersedia.

Contoh kode — Mulai cepat

create_pdf → tambahkan konten dengan add_text.
check_accessibility dengan document_id.
Tinjau temuan: tingkat keparahan, indikator, halaman yang terdampak, dan petunjuk perbaikan.
Secara opsional, output_pdf (base64) untuk peninjauan manual bersama laporan.

Contoh kode — Produksi

Perlakukan laporan sebagai masukan triase, bukan sebagai putusan. Petakan setiap temuan ke perbaikan konkret: aktifkan keluaran bertanda (tagged), tetapkan bahasa dokumen, dan tambahkan struktur judul. Untuk gerbang kesesuaian, jalankan pemeriksa eksternal. Anggap putusan tersebut, bukan skor alat ini, sebagai keputusan otoritatif. Jalankan pemeriksaan sebelum memanggil output_pdf dengan destroy: true; jika tidak, alat tersebut tidak dapat melihat dokumen.

Kasus tepi & jebakan

Tidak ada konten. Dokumen kosong mengembalikan temuan tanpa konten, bukan sertifikasi.
Dokumen besar. Batas waktu membatasi analisis; untuk masukan besar, pecah dokumen atau batasi rentangnya.
Sesi yang dimusnahkan. Jalankan pemeriksaan sebelum proses keluaran memusnahkan sesi.
Sumber terenkripsi. Berikan kata sandi.
Pro tidak tersedia. Dengan Core saja, check_accessibility tidak terdaftar.

Kinerja

Batas waktu dalam anggaran membatasi analisis. Profilnya adalah semantic: laporan merupakan keluaran analisis struktural, jadi bandingkan temuan, bukan keluaran byte.

Catatan keamanan

Laporan menggambarkan struktur, bukan rahasia dalam isi konten. Dokumen yang sedang dianalisis mungkin tetap sensitif, jadi simpan di dalam batas kepercayaan Anda. Jalur analisis tidak menulis ke sistem berkas.

Kesesuaian

Pernyataan	Spesifikasi	Klausul
Struktur logis adalah pohon dari elemen struktur.	ISO 32000-2	§14.7
Bahasa dokumen dideklarasikan melalui entri `Lang`.	ISO 32000-2	§14.9
Bahasa alami harus ditentukan untuk penyusunan yang aksesibel.	PDF/UA-2	§8.4.4

check_accessibility melaporkan indikator struktural yang mendukung penyusunan yang aksesibel. Alat ini tidak menyatakan kesesuaian PDF/UA atau WCAG. Hal itu ditentukan oleh pemeriksa independen.

Konteks komersial

check_accessibility adalah alat tingkat Pro. NextPDF mendaftarkannya hanya jika paket Pro dapat di-resolve saat boot server.

Pemetaan PDF/UA-2

Indikator struktural yang diperiksa alat ini selaras dengan kebutuhan penyusunan PDF/UA-2: pohon struktur bertanda (ISO 32000-2 §14.7) dan bahasa dokumen yang dideklarasikan (PDF/UA-2 §8.4.4). Alat ini melaporkan apakah indikator-indikator ini ada atau tidak. Kesesuaian PDF/UA-2 ditentukan oleh pemeriksa PDF/UA, bukan oleh laporan alat ini.

Referensi silang Tag → ISO 32000-2 §14

Temuan judul dan tabel berkaitan dengan elemen struktur logis dalam pohon struktur ISO 32000-2 §14.7. Temuan bahasa berkaitan dengan entri Lang pada §14.9. Alat ini melaporkan apakah jangkar struktural ini ada. Alat ini tidak memvalidasi setiap aturan tag §14; hal itu adalah tugas pemeriksa.

Pemetaan WCAG 2.2

Temuan kontras dan urutan baca berkaitan dengan kriteria keberhasilan WCAG, seperti kontras dan urutan yang bermakna. Alat ini melaporkan nilai indikator, seperti rasio kontras yang terukur. Klaim kesesuaian WCAG memerlukan evaluasi WCAG lengkap, yang tidak dilakukan dan tidak dinyatakan oleh alat ini.

Ketersediaan transport

Transport	Tersedia	Catatan
MCP (stdio)	Ya (Pro)	Laporan merupakan hasil alat.
REST	Ya (Pro)	Laporan merupakan badan respons.
gRPC	Ya (Pro)	Unary; laporan berada dalam pesan respons.

Tingkat risiko HITL

check_accessibility bersifat Aman (analisis hanya-baca) dan tidak pernah menjadi gerbang. output_pdf ke berkas berada pada tingkat Perlu Persetujuan, dan mode base64 berada pada tingkat Tinjau (Tingkat risiko HITL).

Amplop JSON gerbang konfirmasi

Analisis ini tidak pernah menjadi gerbang:

{ "allowed": true }