فحص إمكانية الوصول البنيوية باستخدام NextPDF Connect (Pro)

لمحة سريعة

شغّل تحليل إمكانية الوصول البنيوية باستخدام ⁨NextPDF Connect.⁩ استخدم الأداة check_accessibility؛ إذ يجري التحقق منها لدى مزوّد أدوات ⁨Pro⁩ الذي يسجّل 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

اربط ناقلًا، ثم تحقّق من توفّر الأداة باستخدام diagnostic.capabilities.

نظرة مفاهيمية عامة

تعتمد بنية المستند القابلة للوصول على أمرين: شجرة بنية منطقية من عناصر البنية (⁨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⁩) للمراجعة اليدوية إلى جانب التقرير.

مثال برمجي — بيئة الإنتاج

عامِل التقرير بوصفه مُدخلًا للفرز الأوّلي، لا حكمًا نهائيًا. اربط كل نتيجة بإصلاح محدّد: فعّل الإخراج المُوسوم، واضبط لغة المستند، وأضف بنية العناوين. لبوابة المطابقة، شغّل مدقّقًا خارجيًا. واجعل حكمه، لا درجة هذه الأداة، المرجع المعتمد. شغّل الفحص قبل output_pdf مع destroy: true، وإلا فلن يتمكن من رؤية المستند.

الحالات الحدّية والمزالق

لا يوجد محتوى. يُرجِع المستند الفارغ نتيجة عدم وجود محتوى، لا شهادة مطابقة.
مستند كبير. تفرض المهلة الزمنية حدًا على التحليل؛ قسّم المُدخلات الكبيرة أو حدّد نطاقها.
جلسة مُتلَفة. شغّل الفحص قبل أن يُتلِف الإخراج الجلسة.
مصدر مُشفَّر. وفّر كلمة المرور.
غياب ⁨Pro.⁩ عند استخدام ⁨Core⁩ وحده، لا يُسجَّل check_accessibility.

الأداء

تضع المهلة الزمنية في الميزانية حدًا للتحليل. تعني السمة semantic أن التقرير ناتج تحليل بنيوي؛ لذا قارن النتائج، لا الإخراج على مستوى البايت.

ملاحظات أمنية

يصف التقرير البنية، لا أسرار المحتوى. وقد يظل المستند قيد التحليل حساسًا، لذا أبقِه ضمن حدود الثقة لديك. لا يكتب مسار التحليل أي بيانات إلى نظام الملفات.

المطابقة

العبارة	المواصفة	البند
البنية المنطقية شجرة من عناصر البنية.	⁨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⁩ إلا عندما تُحلّ حزمة ⁨Pro⁩ عند إقلاع الخادم.

المواءمة مع ⁨PDF/UA-2⁩

تتوافق المؤشرات البنيوية التي تفحصها هذه الأداة مع متطلبات التأليف في ⁨PDF/UA-2⁩: شجرة بنية مُوسومة (⁨ISO 32000-2⁩ §14.7) ولغة مستند معلَنة (⁨PDF/UA-2⁩ §8.4.4). تُبلّغ الأداة عمّا إذا كانت هذه المؤشرات موجودة أو غائبة. يحدّد مدقّق ⁨PDF/UA⁩ المطابقة لـ ⁨PDF/UA-2⁩، وليس تقرير الأداة.

إحالة مرجعية بين الوسم و⁨ISO 32000-2⁩ §14

تقابل نتائج العناوين والجداول عناصر البنية المنطقية في شجرة البنية ⁨ISO 32000-2⁩ §14.7. وتقابل نتيجة اللغة مُدخَل Lang في §14.9. تُبلّغ الأداة عمّا إذا كانت هذه الركائز البنيوية موجودة. وهي لا تتحقق من كل قاعدة وسم في §14؛ فتلك مهمة المدقّق.

المواءمة مع ⁨WCAG 2.2⁩

تتصل نتائج التباين وترتيب القراءة بمعايير نجاح ⁨WCAG⁩، مثل التباين والتسلسل ذي المعنى. تُبلّغ الأداة عن قيم المؤشرات، مثل نسبة التباين المقاسة. يتطلب ادّعاء المطابقة لـ ⁨WCAG⁩ تقييمًا كاملًا وفق ⁨WCAG⁩، وهو ما لا تجريه هذه الأداة ولا تؤكّده.

توافر الناقل

الناقل	متاح	ملاحظات
⁨MCP⁩ (⁨stdio⁩)	نعم (⁨Pro⁩)	التقرير نتيجة أداة.
⁨REST⁩	نعم (⁨Pro⁩)	التقرير هو متن الاستجابة.
⁨gRPC⁩	نعم (⁨Pro⁩)	أحادي؛ التقرير في رسالة الاستجابة.

فئة مخاطر ⁨HITL⁩

check_accessibility آمن (تحليل للقراءة فقط) ولا يفرض أي بوابة أبدًا. يتطلب output_pdf عند الإخراج إلى ملف الموافقة، ووضع ⁨base64⁩ خاضع للمراجعة (فئات مخاطر ⁨HITL⁩).

غلاف ⁨JSON⁩ لبوابة التأكيد

لا يفرض التحليل أي بوابة أبدًا:

{ "allowed": true }