تعيين وضع المطابقة عبر Connect

تعيين وضع المطابقة عبر ⁨Connect⁩

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

لمحة سريعة

يحمل المستند مُميِّز مطابقة واحدًا بالضبط: عادي، أو وضع موسوم/⁨PDF-UA⁩، أو وضع ⁨PDF/A.⁩ ويُخبر هذا المُميِّز أداة الكتابة بأيِّ توصيل للكتالوج والبنية والبيانات الوصفية ينبغي إصداره. استخدم هذه الوصفة لضبط المُميِّز عبر نواقل ⁨Connect.⁩ مُعيِّن الوضع الموسوم جزء من النواة. أمَّا مُعيِّن وضع ⁨PDF/A-4⁩ فهو من الفئة ⁨Premium⁩ بشكل دائم (⁨ADR-011⁩) ولا يُسجَّل إلا عند تثبيت nextpdf/premium إلى جانب الخادم.

إذا استدعيت كلا المُعيِّنين، تُطبَّق حزمتا الميزات معًا على شكل طبقات. ومع ذلك، يظل المُميِّز ذو القيمة الواحدة خاضعًا لمبدأ “الأخير يفوز”، ويُصدِر المحرك تحذير استبدال كي تتمكن الأدوات من رصد الكتابة فوق القيمة.

التثبيت

composer require nextpdf/server

تحقَّق من وجود مُعيِّن وضع ⁨PDF/A⁩ عبر استدعاء tools/list. راجع /⁨connect/tool-catalog/.⁩

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

يُعلِن مُؤشِّر المطابقة عن مطابقة مقصودة. وأداة التحقق هي التي تحدِّد المطابقة الفعلية (⁨PDF/A-4⁩ §6.7.3). تُحَدَّد المطابقة بناءً على متطلبات المعيار، ولا يؤكِّدها البرنامج المُنتِج (⁨PDF/A-4⁩ §6.7.3). يوصِّل الوضع الموسوم شجرة البنية ومُدخلات ⁨mark-info⁩ في الكتالوج (⁨ISO 32000-2⁩ §14.7).

تبديل الوضع عملية توصيل: فهو يُهيِّئ المستند للفحص مقابل المعيار، لكنه في حد ذاته ليس نتيجة مطابقة.

واجهة ⁨API⁩

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

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

أنشئ مستندًا، ثم بدِّله إلى الوضع الموسوم/⁨PDF-UA⁩:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

يُبلِّغ الرد عن مُسنَدات الوضع النشط (موسوم / إتاحة الوصول / أرشفة) التي تفحصها أداة الكتابة عند كل موضع إصدار. كما يُبلِّغ عن توصيل الكتالوج الذي أضافه. تُظهر المُسنَدات ما ستُصدِره أداة الكتابة؛ لكنها لا تؤكِّد أن النتيجة مطابقة.

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

بدِّل إلى ⁨PDF/A-4⁩ (الفئة ⁨Premium⁩)، ثم نفِّذ الفحص. وتعامَل مع حالة عدم النجاح على أنها نتيجة عادية للفحص:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

إذا استدعيت كلا المُعيِّنين، يخضع المُميِّز لمبدأ “الأخير يفوز” ويُصدِر المحرك تحذير استبدال. نفِّذ فحص المعايير لـكل نكهة تظل حزمة ميزاتها موصَّلة، لأن التوصيل تراكمي رغم أن المُميِّز المفرد ليس كذلك.

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

• ضبط الوضع بعد أول صفحة يُرفض بخطأ “الوضع مُجمَّد”. اضبط الوضع فور إنشاء المستند.
• مُعيِّن ⁨PDF/A⁩ بدون ⁨Premium⁩ يفشل — فهو من الفئة ⁨Premium⁩ بشكل دائم (⁨ADR-011⁩). المستند العادي بصيغة ⁨PDF 2.0⁩ لا يحتاج إلى وضع ⁨PDF/A.⁩
• حالة تعداد غير معروفة تُرفض. حالة الأرشفة المدعومة هي ⁨PDF/A-4⁩ (أُلغيت ملفات تعريف ⁨PDF/A⁩ القديمة).
• عملية يحظرها وضع الأرشفة (مثل ⁨JavaScript⁩ المضمَّن) تُرفض أثناء نشاط مُسنَد الأرشفة.
• عدم تطابق النكهة/الوضع عند الفحص يُعيد نتيجة مُؤشِّر غير مطابق. مرِّر النكهة التي تطابق الوضع النشط، أو كلتيهما عندما تكون كلتا الحزمتين موصَّلتين.

الأداء

ميزانية الواجهة الأمامية (⁨frontmatter⁩) حد أعلى توثيقي. لا يُضيف توصيل الوضع أي مرحلة منفصلة قابلة للقياس.

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

لا توجد ملاحظات تتجاوز الإرشادات العامة لنواقل ⁨Connect.⁩

المطابقة

الادعاء	البند	⁨reference_id⁩
يُعلِن مُؤشِّر المطابقة عن مطابقة مقصودة؛ وأداة التحقق هي التي تقرِّر	⁨PDF/A-4⁩ §6.7.3
المطابقة تُحَدَّد بناءً على المتطلبات، ولا يؤكِّدها المُنتِج	⁨PDF/A-4⁩ §6.7.3
يوصِّل الوضع الموسوم شجرة البنية ومُدخلات ⁨mark-info⁩	⁨ISO 32000-2⁩ §14.7

يجعل تعيين وضع المطابقة المحرك يُنتج مخرجات يُقصد بها أن تطابق. وهو ليس شهادة مطابقة. أداة التحقق هي التي تحدِّد النتيجة.

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

مُعيِّن وضع ⁨PDF/A-4⁩ من الفئة ⁨Premium⁩ بشكل دائم (⁨ADR-011⁩) ولا يُسجَّل إلا عند تثبيت nextpdf/premium إلى جانب الخادم. مُعيِّن الوضع الموسوم إحدى قدرات النواة.

تفاصيل ⁨Connect⁩

توفُّر النواقل (⁨MCP⁩ / ⁨REST⁩ / ⁨gRPC⁩)

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

فئة مخاطر ⁨HITL⁩

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

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

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

انظر أيضًا

• /⁨cookbook/connect/compliance-check/⁩ — التحقق مقابل المعيار النشط.
• /⁨cookbook/connect/tagged-pdf-tutorial/⁩ — شرح تفصيلي كامل للـ ⁨PDF⁩ الموسوم.
• /⁨connect/tool-catalog/⁩ — حساب مجموعة الأدوات لكل فئة.
• /⁨connect/hitl-risk-tiers/⁩ — نموذج المخاطر والبوابة.