ตรวจสอบการเข้าถึงเชิงโครงสร้างด้วย NextPDF Connect (Pro)

โดยสรุป

เมื่อต้องการเรียกใช้การวิเคราะห์การเข้าถึงเชิงโครงสร้างผ่าน NextPDF Connect ให้ใช้ check_accessibility ซึ่งตรวจยืนยันกับ Pro tool provider ที่ลงทะเบียน new CheckAccessibilityTool() ภายใต้ชื่อโปรโตคอล check_accessibility คำอธิบายของเครื่องมือนี้ระบุขอบเขตไว้ว่า วิเคราะห์การเข้าถึงเชิงโครงสร้างของ PDF — หัวเรื่อง ตาราง รูปภาพ และตัวบ่งชี้ลำดับการอ่าน เครื่องมือนี้ส่งคืนตัวบ่งชี้และคำแนะนำในการแก้ไข เครื่องมือนี้ ไม่ รับรองความสอดคล้องกับ Portable Document Format/Universal Accessibility (PDF/UA) หรือ Web Content Accessibility Guidelines (WCAG) การตัดสินดังกล่าวเป็นหน้าที่ของเครื่องมือตรวจสอบความสอดคล้อง เช่น veraPDF หรือเครื่องมือทดสอบ PDF/UA check_accessibility เป็นเครื่องมือระดับ Pro NextPDF ตรวจสอบเครื่องมือนี้ด้วย class_exists() ขณะบูต และจะลงทะเบียนเฉพาะเมื่อมีการติดตั้งแพ็กเกจ Pro เท่านั้น

การติดตั้ง

composer require nextpdf/server
composer require nextpdf/pro

ผูก transport แล้วใช้ diagnostic.capabilities เพื่อยืนยันเครื่องมือ

ภาพรวมเชิงแนวคิด

โครงสร้างที่เข้าถึงได้ขึ้นอยู่กับองค์ประกอบหลักสองอย่าง ได้แก่ ทรีโครงสร้างเชิงตรรกะของ structure element (ISO 32000-2 §14.7) และภาษาของเอกสารที่ประกาศไว้ ซึ่งกำหนดผ่านรายการ Lang ในแคตาล็อก (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4) check_accessibility ตรวจสอบตัวบ่งชี้เชิงโครงสร้างเหล่านี้และส่งคืนผลการตรวจพบพร้อมระดับความรุนแรงและคำแนะนำในการแก้ไข ให้ถือว่าคะแนนตัวเลขหรือค่า pass/fail ใด ๆ ในรายงานเป็น สรุปตัวบ่งชี้ ไม่ใช่การรับรอง สำหรับใช้คัดกรองเบื้องต้น

พื้นผิว API

เครื่องมือ	ระดับ	บทบาท	ระดับความเสี่ยง
`create_pdf`, `add_text`	Core	สร้างเนื้อหาเพื่อตรวจสอบ	ปลอดภัย / ควรระวัง
`check_accessibility`	Pro	การวิเคราะห์การเข้าถึงเชิงโครงสร้าง	ปลอดภัย
`output_pdf`	Core	เรนเดอร์และคืนค่า PDF	ต้องได้รับอนุมัติ / ตรวจทาน (base64)

ชื่อเครื่องมือเป็นชื่อโปรโตคอลในรีจิสทรี แคตาล็อกเครื่องมือ คือแคตาล็อกอ้างอิงอย่างเป็นทางการ ระดับที่ติดตั้งไว้เป็นตัวกำหนดว่าเครื่องมือใดพร้อมใช้งาน

ตัวอย่างโค้ด — เริ่มต้นอย่างรวดเร็ว

create_pdf → ใช้ add_text เพิ่มเนื้อหา
check_accessibility ด้วย document_id ที่กำหนด
ตรวจทานผลการตรวจพบ ได้แก่ ระดับความรุนแรง ตัวบ่งชี้ หน้าที่ได้รับผลกระทบ และคำแนะนำสำหรับการแก้ไข
หากต้องการ สามารถใช้ output_pdf (base64) เพื่อตรวจทานด้วยตนเองควบคู่กับรายงาน

ตัวอย่างโค้ด — การใช้งานจริง

ให้ถือว่ารายงานเป็นข้อมูลนำเข้าสำหรับการคัดกรองเบื้องต้น ไม่ใช่คำตัดสิน จับคู่ผลการตรวจพบแต่ละรายการกับการแก้ไขที่เป็นรูปธรรม ได้แก่ การเปิดใช้งานเอาต์พุตแบบ tagged การกำหนดภาษาของเอกสาร และการเพิ่มโครงสร้างหัวเรื่อง สำหรับเกตตรวจสอบความสอดคล้อง ให้เรียกใช้เครื่องมือตรวจสอบภายนอก และถือว่าคำตัดสินนั้นเป็นข้อมูลอ้างอิงที่เชื่อถือได้ ไม่ใช่คะแนนจากเครื่องมือนี้ เรียกใช้การตรวจสอบก่อน output_pdf ที่มี destroy: true มิเช่นนั้นจะมองไม่เห็นเอกสาร

กรณีขอบและข้อควรระวัง

ไม่มีเนื้อหา เอกสารว่างเปล่าจะส่งคืนผลการตรวจพบว่าไม่มีเนื้อหา ไม่ใช่การรับรอง
เอกสารขนาดใหญ่ การหมดเวลาจะจำกัดขอบเขตการวิเคราะห์ ให้แบ่งข้อมูลนำเข้าขนาดใหญ่หรือระบุช่วงข้อมูล
เซสชันถูกทำลาย เรียกใช้การตรวจสอบก่อนที่เอาต์พุตจะทำลายเซสชัน
แหล่งที่มาที่เข้ารหัสลับ ระบุรหัสผ่าน
ไม่มี Pro หากมีเฉพาะ Core check_accessibility จะไม่ถูกลงทะเบียน

ประสิทธิภาพ

การหมดเวลาตามงบประมาณจะจำกัดขอบเขตการวิเคราะห์ โปรไฟล์คือ semantic รายงานเป็นเอาต์พุตจากการวิเคราะห์เชิงโครงสร้าง ดังนั้นให้เปรียบเทียบผลการตรวจพบ ไม่ใช่เอาต์พุตระดับไบต์

หมายเหตุด้านความปลอดภัย

รายงานอธิบายโครงสร้าง ไม่ใช่ข้อมูลลับในเนื้อหา เอกสารที่กำลังวิเคราะห์อาจยังมีข้อมูลอ่อนไหวอยู่ จึงควรเก็บไว้ภายในขอบเขตความเชื่อถือของคุณ กระบวนการวิเคราะห์ไม่เขียนข้อมูลลงในระบบไฟล์

ความสอดคล้อง

ข้อความ	ข้อกำหนด	ข้อ
โครงสร้างเชิงตรรกะคือทรีของ structure element	ISO 32000-2	§14.7
ภาษาของเอกสารถูกประกาศผ่าน `Lang` ในรายการ	ISO 32000-2	§14.9
ต้องระบุภาษาธรรมชาติสำหรับการสร้างเอกสารที่เข้าถึงได้	PDF/UA-2	§8.4.4

check_accessibility รายงานตัวบ่งชี้เชิงโครงสร้างที่ สนับสนุน การสร้างเอกสารที่เข้าถึงได้ เครื่องมือนี้ไม่ยืนยันความสอดคล้องกับ PDF/UA หรือ WCAG การตัดสินดังกล่าวเป็นหน้าที่ของเครื่องมือตรวจสอบอิสระ

บริบทเชิงพาณิชย์

check_accessibility เป็นเครื่องมือระดับ Pro NextPDF จะลงทะเบียนเครื่องมือนี้เฉพาะเมื่อระบบ resolve แพ็กเกจ Pro ได้ขณะบูตเซิร์ฟเวอร์เท่านั้น

การจับคู่กับ PDF/UA-2

ตัวบ่งชี้เชิงโครงสร้างที่เครื่องมือนี้ตรวจสอบสอดคล้องกับสิ่งที่ต้องมีในการสร้างเอกสารตาม PDF/UA-2 ได้แก่ ทรีโครงสร้างแบบ tagged (ISO 32000-2 §14.7) และภาษาของเอกสารที่ประกาศไว้ (PDF/UA-2 §8.4.4) เครื่องมือนี้รายงานว่าตัวบ่งชี้เหล่านี้มีอยู่หรือไม่ การตัดสินความสอดคล้องกับ PDF/UA-2 เป็นหน้าที่ของเครื่องมือตรวจสอบ PDF/UA ไม่ใช่รายงานของเครื่องมือนี้

การอ้างอิงข้าม Tag → ISO 32000-2 §14

ผลการตรวจพบเกี่ยวกับหัวเรื่องและตารางสอดคล้องกับ structure element เชิงตรรกะในทรีโครงสร้าง ISO 32000-2 §14.7 ผลการตรวจพบเกี่ยวกับภาษาสอดคล้องกับรายการ Lang ใน §14.9 เครื่องมือนี้รายงานว่าจุดยึดเชิงโครงสร้างเหล่านี้มีอยู่หรือไม่ การตรวจสอบกฎ tag ทุกข้อใน §14 เป็นหน้าที่ของเครื่องมือตรวจสอบ

การจับคู่กับ WCAG 2.2

ผลการตรวจพบเกี่ยวกับคอนทราสต์และลำดับการอ่านเกี่ยวข้องกับเกณฑ์ความสำเร็จของ WCAG เช่น คอนทราสต์และลำดับที่สื่อความหมาย เครื่องมือนี้รายงานค่าตัวบ่งชี้ เช่น อัตราส่วนคอนทราสต์ที่วัดได้ การกล่าวอ้างความสอดคล้องกับ WCAG ต้องอาศัยการประเมิน WCAG อย่างครบถ้วน ซึ่งเครื่องมือนี้ไม่ได้ดำเนินการและไม่ได้ยืนยัน

ความพร้อมใช้งานของ transport

ทรานสปอร์ต	พร้อมใช้งาน	หมายเหตุ
MCP (stdio)	ใช่ (Pro)	รายงานเป็นผลลัพธ์ของเครื่องมือ
REST	ใช่ (Pro)	รายงานอยู่ในเนื้อหาการตอบกลับ
gRPC	ใช่ (Pro)	แบบ unary รายงานอยู่ในข้อความตอบกลับ

ระดับความเสี่ยง HITL

check_accessibility เป็นแบบปลอดภัย (การวิเคราะห์แบบอ่านอย่างเดียว) และไม่ถูกกั้นด้วยเกต output_pdf ไปยังไฟล์เป็นแบบต้องได้รับอนุมัติ และโหมด base64 เป็นแบบตรวจทาน (ระดับความเสี่ยง HITL)

ซอง JSON ของเกตยืนยัน

การวิเคราะห์ไม่ถูกกั้นด้วยเกต:

{ "allowed": true }