مهمة الطباعة

لمحة سريعة

يبني ⁨NextPDF Pro⁩ تذاكر مهام ⁨XJDF⁩ (⁨XML JDF 2.0⁩) لسير عمل الطباعة الإنتاجية: البيانات الوصفية للمهمة، ومواصفة الوسائط، وقصد الألوان، وعمليات التشطيب، والأولوية، وعدد النُّسَخ.

التوفّر والترخيص

تتوفّر هذه القدرة في ⁨NextPDF Pro⁩ (nextpdf/pro) وتُفعَّل عبر مظروف ترخيص من فئة ⁨Pro⁩. وأي نشر لا يملك هذا الاستحقاق لا يُحمِّل أصناف هذه القدرة. ولا تحمل مهمة الطباعة أي علم ترخيص منفصل لكل ميزة. قارِن الإصدارات واحصل على ترخيص.

التثبيت

composer require nextpdf/pro:^3

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

يستهلك نظام إنتاج الطباعة تذكرة مهمة تصف كيفية إنتاج مهمة. يصدر ⁨NextPDF Pro⁩ مستند ⁨XJDF 2.1⁩ ببانٍ انسيابي:

• XjdfJobTicket — البانِي. اضبط مُعرِّف المهمة واسمها، والأولوية، والوسائط، والألوان، والتشطيب، وعدد النُّسَخ، ثم سلسِلْ إلى مستند ⁨XML⁩ بصيغة ⁨XJDF 2.1⁩.
• MediaSpec — خصائص وسائط غير قابلة للتغيير: النوع، والعرض والارتفاع بالمليمترات، والوزن بالغرام/م²، والطلاء، واللون. يُستخدَم ورق ⁨A4⁩ أبيض افتراضيًا.
• ColorSpec و**FinishingSpec** و**JobPriority** — قصد الألوان، وعمليات التشطيب، وتعداد أولوية.

يتبع ⁨XML⁩ المُولَّد بنية ⁨XJDF 2.1⁩ المُبسَّطة. وتُنتِج الوحدة التذكرة؛ وهي لا تُرسِلها إلى مُتحكِّم مطبعة أو جهاز.

لماذا يعمل بهذه الطريقة

تبني مهمة الطباعة تذكرة وتتوقّف عند هذا الحد. فهي لا تُرسِل المهمة قط ولا تُعرِض تدفّق طباعة. وهذا الحد مقصود. مستند ⁨XJDF⁩ هو وصف محمول للقصد — الوسائط، والألوان، والتشطيب، والأولوية، والنُّسَخ — يستهلكه مُتحكِّم مطبعة لاحق ويُنفِّذه. وإبقاء الوحدة مُسلسِلًا صرفًا يتيح لتذكرة واحدة أن تقود تشغيلًا إنتاجيًا كبير الحجم دون ربط شيفرتك ببروتوكول جهاز. وكائنات المواصفة غير قابلة للتغيير، لذا تُنتِج المدخلات المتطابقة التذكرة نفسها دائمًا، ما يُبقي مخرَج الدفعة قابلًا لإعادة الإنتاج.

خلفية التصميم: توليد المستندات كبير الحجم.

سطح الواجهة البرمجية (⁨API⁩)

الصنف	المسؤولية
XjdfJobTicket	بانِي تذكرة مهام ⁨XJDF 2.1⁩ انسيابي.
MediaSpec	خصائص الوسائط الفيزيائية.
ColorSpec	قصد الألوان.
FinishingSpec	عمليات التشطيب.
JobPriority	تعداد الأولوية.

مثال شيفرة — بداية سريعة

use NextPDF\Pro\PrintJob\XjdfJobTicket;

$xml = (new XjdfJobTicket())
    ->setJobId('JOB-1001')
    ->setJobName('Quarterly report')
    ->toXml();

مثال شيفرة — إنتاجي

use NextPDF\Pro\PrintJob\{XjdfJobTicket, MediaSpec, JobPriority};

$xml = (new XjdfJobTicket())
    ->setJobId($jobId)
    ->setPriority(JobPriority::High)
    ->setMedia(new MediaSpec(mediaType: 'Paper', widthMm: 297.0, heightMm: 420.0))
    ->setCopies(500)
    ->toXml();
$logger->info('printjob.ticket_built', ['job_id' => $jobId]);

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

• سلسِلْ عبر toXml()؛ وعندما يكون مُعرِّف المهمة فارغًا، تُولَّد هويّة فريدة بدلًا من الإخفاق.
• ‏setCopies() يرفض عدد نُسَخ أقل من 1.
• أبعاد الوسائط بالمليمترات؛ حوّل من النقاط قبل تمريرها.
• المخرَج مستند تذكرة، لا تدفّق طباعة مُعروض.

الأداء

بناء التذكرة ثابت الزمن نسبةً إلى حجم المستند؛ ويعتمد على الموارد المُعَدّة فقط.

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

يصدر البانِي ⁨XML⁩ من القيم التي تزوّدها. عقّم أسماء المهام ومُعرِّفاتها ذات المصدر الخارجي قبل البناء.

المطابقة

السلوك	المرجع	الحالة
بنية تذكرة مهام ⁨XJDF 2.1⁩	XJDF 2.1 (CIP4)	متوافق (مجموعة فرعية مُبسَّطة)

عقد السلوك

• ‏XjdfJobTicket بانٍ انسيابي لمُعرِّف المهمة واسمها، والأولوية، والوسائط، والألوان، والتشطيب، وعدد النُّسَخ، يسلسِل إلى مستند ⁨XML⁩ بصيغة ⁨XJDF 2.1⁩ مُبسَّطة عبر toXml(). يرفض setCopies() عدد نُسَخ أقل من 1؛ ويُولَّد مُعرِّف المهمة الفارغ تلقائيًا.
• يحمل MediaSpec خصائص وسائط غير قابلة للتغيير (النوع، والعرض/الارتفاع بالمليمترات، والوزن بالغرام/م²، والطلاء، واللون) ويُستخدَم ورق ⁨A4⁩ أبيض افتراضيًا.
• يصف ColorSpec وFinishingSpec وJobPriority قصد الألوان، وعمليات التشطيب، والأولوية.
• تُنتِج الوحدة مستند تذكرة فقط. وهي لا تُعرِض تدفّق طباعة ولا تُرسِل التذكرة إلى مُتحكِّم مطبعة أو جهاز.

ملاحظة عن حدّ ⁨Enterprise⁩

لا يغيّر ⁨Enterprise⁩ سلوك مهمة الطباعة. يضيف ⁨Enterprise⁩ ميزات أعلى مستوى مُوثَّقة على حدة؛ وهي ليست لازمة لبناء تذكرة مهمة ⁨XJDF⁩.

الرجوع إلى ⁨Core⁩ / البديل

لا يوجد مكافئ في ⁨Core⁩ لتوليد تذاكر مهام ⁨XJDF 2.1⁩. هذه إضافة من ⁨Pro⁩.

حدود النشر

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

انظر أيضًا

• مهمة الطباعة — مرجع متعمّق — سطح الواجهة البرمجية الكامل لوحدة مهمة الطباعة.
• مسار الإخراج — تجهيز الإخراج.
• المستند — تجميع المستند.