تشغيل فحص مطابقة المعايير عبر Connect

تشغيل فحص مطابقة المعايير عبر ⁨Connect⁩

لمحة سريعة

استخدم هذه الوصفة لتقييم ملف ⁨PDF⁩ وفق مجموعة قواعد لمعيار مُسمّى عبر وسائط نقل ⁨Connect.⁩ تشمل الأمثلة ⁨PDF/A-4⁩، أو مستوىً أساسيًا من التوقيعات الإلكترونية المتقدمة لملفات ⁨PDF⁩ (⁨PAdES⁩)، أو سياسة تنظيمية. تنتمي أداة فحص المطابقة إلى فئة ⁨Enterprise⁩. يكتشفها الخادم عبر فحص استكشافي باستخدام class_exists()، ولا يسجّلها إلا عند تثبيت nextpdf/premium إلى جانب الخادم. في التثبيت الذي يقتصر على الإصدار المفتوح المصدر، تكون الأداة غائبة، ويفشل الاستدعاء بخطأ يفيد بأن الأداة غير معروفة.

تعرض الأداة نتيجة ⁨pass/fail⁩ لكل قاعدة تطبّقها على المعيار المطلوب. هذه النتيجة تخص فحص الأداة نفسه، وليست شهادة مطابقة مستقلة. ما يحسم المطابقة هو أداة تحقق، مثل ⁨veraPDF⁩ لمعيار ⁨PDF/A⁩. تصف هذه الصفحة سلوك الأداة، لا ضمانًا بالمطابقة.

التثبيت

composer require nextpdf/server

تأكّد من توافر أداة المطابقة من فئة ⁨Enterprise⁩ في بيئة النشر العاملة عبر استدعاء tools/list. راجع /⁨connect/tool-catalog/.⁩

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

يحدّد معيار مثل ⁨PDF/A-4⁩ متطلبات المستند. ويقيّم المُدقّق المستند وفق تلك المتطلبات (⁨PDF/A-4⁩ §6.2.3). تُحسم المطابقة بناءً على متطلبات المعيار، ولا يؤكّدها البرنامج الذي أنتج المستند (⁨PDF/A-4⁩ §6.7.3). أما في المعايير المتعلقة بالتوقيع، فيتحقق الفحص مما إذا حدث تعديل بعد التوقيع مقابل نطاق البايتات الموقّع (⁨ISO 32000-2⁩ §12.8).

تعني حالة “النجاح” في الأداة: “لم تفشل أي قاعدة تطبّقها الأداة لهذا المعيار”. هذه النتيجة أضيق نطاقًا من شهادة مطابقة رسمية للمستند بأكمله.

واجهة ⁨API⁩

تحقّق من أسماء الأدوات في السجل العامل باستخدام tools/list. الكتالوج المرجعي هو /⁨connect/tool-catalog/.⁩ لا تُعيد هذه الوصفة ذكر عدد الأدوات؛ فهو خاصية تُحدَّد في زمن تشغيل عملية النشر.

نموذج برمجي — بداية سريعة

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "compliance_check",
    "arguments": { "document_id": "<id>", "standard": "pdfa-4" }
  }
}

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

تعامل مع نتيجة “⁨fail⁩” على أنها بيانات يمكن اتخاذ إجراء بناءً عليها. ميّز بين فشل النقل وبين حالة عادية غير ناجحة في بروتوكول نقل النص التشعبي (⁨HTTP⁩) عبر وسيط نقل شبكي:

curl -sS -X POST https://connect.example.com/v1/tools/compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"source":"/var/lib/nextpdf/in/report.pdf","standard":"pdfa-4"}' \
  -o /tmp/check.json -w '%{http_code}' > /tmp/check-status || {
    echo "transport failure invoking compliance_check" >&2; exit 1; }

[ "$(cat /tmp/check-status)" = "200" ] || {
  echo "compliance_check returned non-200; inspect /tmp/check.json" >&2; }

يسرد الرد كل قاعدة جرى تقييمها مع حالتها ⁨pass/fail⁩ وسبب كل فشل. استخدم حالات الفشل لتوجيه المعالجة. لا تتعامل مع “⁨pass⁩” على أنها شهادة.

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

• اسم معيار غير معروف. تُرجع الأداة خطأ يفيد بأن المعيار غير معروف، مع المُعرّفات المعترف بها. استخدم المُعرّف الدقيق (pdfa-4، أو مستوىً أساسيًا من ⁨PAdES⁩، أو مُعرّف سياسة تنظيمية).
• المستند غير موجود. تحقق من أن document_id ناتج من استدعاء إخراج سابق، أو مرّر مسار source صالحًا.
• مرجع متقاطع تالف. يدل فشل التحليل على أن المُدخل ليس ملف ⁨PDF⁩ صالحًا أو أنه مبتور. أعد توليد المصدر.
• الأداة غائبة. من دون nextpdf/premium، لا تُسجَّل أداة المطابقة من فئة ⁨Enterprise⁩، ويفشل الاستدعاء بخطأ يفيد بأن الأداة غير معروفة.

الأداء

ميزانية المقدمة (⁨front-matter⁩) حد توثيقي، وليست ضمان مستوى خدمة.

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

لا تسجّل مسار المصدر أو التقرير الكامل في مستوى سجلات يُرسَل إلى خارج النظام. سجّل اسم الأداة، ومُعرّف الطلب، ونتيجة ⁨pass/fail⁩ الإجمالية. يصف “⁨pass⁩” مجموعة القواعد التي تطبّقها الأداة، ولا يمثل ضمانًا أمنيًا أو قانونيًا.

المطابقة

الادّعاء	البند	⁨reference_id⁩
يحدّد المعيار المتطلبات؛ ويقيّمها المُدقّق	⁨PDF/A-4⁩ §6.2.3
تُحسم المطابقة مقابل المتطلبات، ولا يؤكّدها المُنتِج	⁨PDF/A-4⁩ §6.7.3
يمكن كشف التعديل بعد التوقيع مقابل نطاق البايتات الموقّع	⁨ISO 32000-2⁩ §12.8

دعم فحص المعايير ليس شهادة مطابقة. أداة تحقق مستقلة هي التي تحسم المطابقة.

السياق التجاري

تنتمي أداة فحص المطابقة إلى فئة ⁨Enterprise.⁩ ولا تُسجَّل إلا عند تثبيت nextpdf/premium إلى جانب الخادم.

تفاصيل ⁨Connect⁩

توافر وسائط النقل (⁨MCP⁩ / ⁨REST⁩ / ⁨gRPC⁩)

استدعِ الأداة بالطريقة نفسها عبر tools/call في بروتوكول سياق النموذج (⁨MCP⁩)، وعبر نقطة نهاية أداة نقل الحالة التمثيلي (⁨REST⁩)، وعبر خدمة ⁨gRPC⁩، وذلك من خلال مُنفّذ الأدوات المشترك.

فئة مخاطر ⁨HITL⁩

الفحص للقراءة فقط، وليس approval_required افتراضيًا. قد يرفع تجاوز من المُشغّل مستوى المخاطر. لا يستطيع التجاوز إلا رفع المستوى، ولا يمكنه خفضه أبدًا. راجع /⁨connect/hitl-risk-tiers/.⁩

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

لا تُشغّل الأداة البوابة ما لم يرفعها تجاوز من المُشغّل إلى approval_required. غلاف التحدي وعقد الرمز المميز ذي الاستخدام الواحد موثّقان في /⁨connect/hitl-risk-tiers/.⁩

انظر أيضًا

• /⁨cookbook/connect/batch-compliance/⁩ — تشغيل الفحص على مستندات عديدة.
• /⁨cookbook/connect/ai-ready-certification/⁩ — تشغيل فحص جاهزية الذكاء الاصطناعي الأوسع.
• /⁨connect/tool-catalog/⁩ — مراجعة كيفية احتساب مجموعة الأدوات لكل فئة.
• /⁨connect/hitl-risk-tiers/⁩ — مراجعة نموذج المخاطر والبوابة.