فحص الامتثال للمعايير على دفعات عبر Connect

فحص الامتثال للمعايير على دفعات عبر ⁨Connect⁩

لمحة سريعة

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

كما في فحص المستند الواحد، يعني “النجاح” لكل سياسة أن الأداة فحصت القواعد التي تنفِّذها فقط. وهو ليس شهادة امتثال مستقلة. أداة التحقق هي التي تبتّ في الامتثال.

التثبيت

composer require nextpdf/server

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

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

يحدِّد المعيار متطلبات كل مستند، ويُقيِّم الفاحص كل مستند مقابل تلك المتطلبات (⁨PDF/A-4⁩ §6.2.3). ويُحدَّد الامتثال وفق المتطلبات، لا وفق تأكيد المُنتِج (⁨PDF/A-4⁩ §6.7.3). أما السياسات المتعلقة بالتوقيع، فالمستويات الأساسية لتوقيعات ⁨PDF⁩ الإلكترونية المتقدمة (⁨PAdES⁩) متمايزة، ويُعد المستويان ⁨B-LT/B-LTA⁩ (مادة التحقق، الطابع الزمني للأرشفة) قدرةً خاصة بفئة ⁨Enterprise⁩ وحدها (⁨ETSI EN 319 142-2⁩ §5.5). وتطبِّق نتيجة الدفعة المعنى الضيق نفسه: “لم تفشل أي قاعدة منفَّذة” على مجموعة المستندات.

واجهة ⁨API⁩

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

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

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "batch_compliance_check",
    "arguments": {
      "sources": ["/data/q1.pdf", "/data/q2.pdf"],
      "policies": ["pdfa-4"]
    }
  }
}

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

curl -sS -X POST https://connect.example.com/v1/tools/batch_compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sources":["/data/q1.pdf","/data/q2.pdf"],"policies":["pdfa-4"]}' \
  -o /tmp/batch.json -w '%{http_code}' > /tmp/batch-status || {
    echo "transport failure invoking batch_compliance_check" >&2; exit 1; }

تتضمن الاستجابة معرِّف دفعة، وإجمالي أعداد ⁨pass/fail⁩، ومصفوفة checks لكل مستند، مع نتائج كل سياسة وأسباب الفشل. رشِّح حالات الفشل، وعالِجها، ثم أعِد إرسال المستندات المتأثرة فقط.

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

• sources أو policies الفارغة تُرجِع خطأ معامِلات غير صالحة.
• الملف المفقود يظهر كخطأ في كل نتيجة بدلاً من أن يُفشل الدفعة بأكملها. افحص كل نتيجة بحثاً عن حقل خطأ.
• تجاوُز حد حجم الدفعة يُرجِع خطأً صريحاً. قسِّم العمل إلى دفعات أصغر.
• معرِّف السياسة غير المعروف ينتج عنه خطأ معيار غير معروف يذكر المعرِّفات المعترَف بها. سياسات التوقيع التي تشير إلى ⁨B-LT/B-LTA⁩ لا تكون ذات معنى إلا في بيئة نشر ⁨Enterprise⁩ قادرة على إنتاج تلك المادة.
• الأداة غائبة. من دون nextpdf/premium لا تُسجَّل أداة الدفعات من فئة ⁨Enterprise⁩؛ ويفشل الاستدعاء بخطأ يفيد بأن الأداة غير معروفة.

الأداء

ميزانية الأداء في مقدمة الملف هي سقف توثيقي. تعالِج الأداة المستندات على جانب الخادم، ويمكن لكل مستند أن يستهلك قدراً معتبراً من الذاكرة التشغيلية. حدِّد حجم الدفعة بناءً على ذاكرة المضيف بدلاً من رفع مهلة زمنية عامة.

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

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

المطابقة

الادعاء	البند	⁨reference_id⁩
المعيار يحدِّد المتطلبات؛ والفاحص يُقيِّم كل مستند	⁨PDF/A-4⁩ §6.2.3
يُحدَّد الامتثال مقابل المتطلبات، ولا يؤكِّده المُنتِج	⁨PDF/A-4⁩ §6.7.3
⁨B-LT/B-LTA⁩ يضيفان مادة التحقق؛ وهما مستويان متمايزان خاصان بفئة ⁨Enterprise⁩ وحدها	⁨ETSI EN 319 142-2⁩ §5.5

دعم فحص الامتثال للمعايير على دفعات ليس شهادة امتثال. أداة تحقق مستقلة هي التي تبتّ في امتثال كل مستند.

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

تنتمي أداة الامتثال على دفعات إلى فئة ⁨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/compliance-check/⁩ — فحص المعايير لمستند واحد.
• /⁨cookbook/connect/ai-ready-certification/⁩ — فحص أوسع للجاهزية للذكاء الاصطناعي.
• /⁨connect/tool-catalog/⁩ — حساب مجموعة الأدوات حسب الفئة.
• /⁨connect/hitl-risk-tiers/⁩ — نموذج المخاطر وسلوك البوابة.