مهمة الطباعة — مرجع متعمّق

لمحة سريعة

يُنشئ XjdfJobTicket بطاقة مهام ⁨XJDF 2.1⁩ (⁨XML JDF 2.0⁩) لسير عمل الطباعة الإنتاجية. تُسجّل أداة الإنشاء السلسة بيانات المهمة الوصفية، والوسائط، ونيّة اللون، وعمليات التشطيب، والأولوية، وعدد النسخ. ثم يُسلسِل toXml مستند ⁨XML⁩ ضمن مساحة أسماء ⁨CIP4⁩. تُنتج الوحدة بطاقةً فقط. وهي لا تُرسل البطاقة إلى وحدة تحكّم مطبعة أو إلى جهاز.

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

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

لا تنطبق أي راية ترخيص لكل ميزة على حدة. هذه قدرة من الفئة Pro.

سطح الـ ⁨API⁩ العام

composer require nextpdf/pro:^3

نقطة الدخول — أداة الإنشاء السلسة:

final class XjdfJobTicket
{
    public function __construct();
    public function setJobId(string $id): self;
    public function setJobName(string $name): self;
    public function setPriority(JobPriority $priority): self;
    public function setMedia(MediaSpec $media): self;
    public function setColor(ColorSpec $color): self;
    public function setFinishing(FinishingSpec $finishing): self;
    public function setCopies(int $copies): self;
    public function toXml(): string;
}

مواصفة الوسائط — كائن قيمة غير قابل للتغيير:

final readonly class MediaSpec
{
    public function __construct(
        public string $mediaType = 'Paper',
        public float $widthMm = 210.0,
        public float $heightMm = 297.0,
        public int $weight = 80,
        public string $coating = 'None',
        public string $color = 'White',
    );
    public function isStandard(): bool;
    public function toXjdfElement(): string;
}

نيّة اللون — كائن قيمة غير قابل للتغيير:

final readonly class ColorSpec
{
    public function __construct(
        public bool $useCmyk = true,
        public bool $useSpotColors = false,
        public array $spotColorNames = [],
        public string $renderingIntent = 'RelativeColorimetric',
    );
    public function colorCount(): int;
}

نيّة التشطيب — كائن قيمة غير قابل للتغيير:

final readonly class FinishingSpec
{
    public function __construct(
        public bool $fold = false,
        public bool $staple = false,
        public bool $punch = false,
        public bool $trim = false,
        public string $binding = 'None',
    );
}

الأولوية — تعداد مدعوم بسلسلة نصية:

enum JobPriority: string
{
    case Idle = 'Idle';
    case Low = 'Low';
    case Normal = 'Normal';
    case High = 'High';
    case Rush = 'Rush';

    public function numericValue(): int;
}

الرمز	المعاملات	السلوك الافتراضي	المُرجَع	يرمي أو يفشل بـ	ملاحظات
XjdfJobTicket::__construct	لا شيء	تُهيَّأ الأولوية إلى JobPriority::Normal؛ والنسخ إلى 1.	نسخة	—	جذر أداة الإنشاء السلسة.
XjdfJobTicket::setJobId	string $id	يُسجّل مُعرّف المهمة.	self	—	القيمة الفارغة مسموح بها؛ انظر toXml.
XjdfJobTicket::setJobName	string $name	يُسجّل اسم المهمة المقروء بشرياً.	self	—	يُصدَر كـ GeneralID عندما لا يكون فارغاً.
XjdfJobTicket::setPriority	JobPriority $priority	يتجاوز أولوية Normal الافتراضية.	self	—	—
XjdfJobTicket::setMedia	MediaSpec $media	يُرفق مورد وسائط.	self	—	اختياري؛ يُحذف عند عدم تعيينه.
XjdfJobTicket::setColor	ColorSpec $color	يُرفق مورد نيّة لون.	self	—	اختياري؛ يُحذف عند عدم تعيينه.
XjdfJobTicket::setFinishing	FinishingSpec $finishing	يُرفق موارد التشطيب.	self	—	اختياري؛ يُحذف عند عدم تعيينه.
XjdfJobTicket::setCopies	int $copies	يُعيّن عدد نسخ الإخراج.	self	InvalidArgumentException عندما يكون $copies < 1	الافتراضي هو 1.
XjdfJobTicket::toXml	لا شيء	يُسلسِل مستند ⁨XJDF 2.1⁩.	string	—	يُولّد مُعرّف مهمة عشوائياً XJDF_<hex> عند عدم تعيين أي مُعرّف.
MediaSpec::__construct	string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color	افتراضياً ورق ⁨A4⁩ أبيض بوزن ⁨80 g/m²⁩.	نسخة	—	جميع المعاملات اختيارية.
MediaSpec::isStandard	لا شيء	يطابق ⁨A4⁩ أو ⁨US Letter⁩ أو ⁨A3⁩ ضمن ⁨0.5 mm⁩.	bool	—	عمودي أو أفقي.
MediaSpec::toXjdfElement	لا شيء	يُصدر عنصر <Media>؛ يُحوّل الملّيمترات إلى نقاط.	string	—	يُحذف الطلاء واللون عند قيمهما الافتراضية.
ColorSpec::__construct	bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent	افتراضياً ⁨CMYK⁩، نيّة لونية نسبية قياسية.	نسخة	—	—
ColorSpec::colorCount	لا شيء	يُرجع 4 لـ ⁨CMYK⁩ زائد واحد لكل لون موضعي.	int	—	—
FinishingSpec::__construct	bool $fold, bool $staple, bool $punch, bool $trim, string $binding	افتراضياً بلا تشطيب؛ التجليد None.	نسخة	—	—
JobPriority	حالات التعداد Idle وLow وNormal وHigh وRush	—	تعداد	—	مدعوم بسلسلة نصية.
JobPriority::numericValue	لا شيء	يُطابق الحالة بـ 0 أو 25 أو 50 أو 75 أو 100.	int	—	الأعلى هو Rush (100).

عقد السلوك

• XjdfJobTicket أداة إنشاء سلسة. تُرجع كل دالة تعيين self للتسلسل.
• يُسلسِل toXml مستند ⁨XJDF 2.1⁩ مُبسّطاً ضمن مساحة أسماء ⁨CIP4⁩ http://www.CIP4.org/JDFSchema_2_0، مع Types="ConventionalPrinting".
• عند عدم تعيين أي مُعرّف مهمة، يستبدل toXml ذلك بمُعرّف XJDF_ عشوائي بدلاً من أن يفشل.
• تُكتب الأولوية كـ Comment وكسمة عددية NodeInfo معاً. وتُكتب النسخ كمقدار إخراج Component.
• لا تظهر موارد الوسائط واللون والتشطيب إلا عند تعيين مواصفاتها.
• تُهرَّب جميع قيم السمات بترميز ⁨XML⁩ قبل التسلسل.
• تُنتج الوحدة مستند البطاقة. وهي لا تُصيّر تدفّق طباعة ولا تُرسل البطاقة إلى جهاز.

الحالات الحدّية وأنماط الفشل

• setCopies بقيمة أقل من 1 يرمي InvalidArgumentException. هذا هو الاستثناء الوحيد الذي تُطلقه الوحدة.
• مُعرّف المهمة الفارغ أو غير المُعيّن ليس خطأً. يستبدل toXml ذلك بمُعرّف XJDF_<hex> عشوائي وقت التسلسل.
• أبعاد الوسائط بالملّيمترات. يُحوّلها toXjdfElement إلى نقاط ⁨PDF⁩ باستخدام المعامل ⁨72 / 25.4⁩.
• يطبّق MediaSpec::isStandard تفاوتاً قدره ⁨0.5 mm⁩ ويقبل التوجّه العمودي أو الأفقي.
• يُحذف MediaSpec::toXjdfElement سمة FrontCoatings عندما يكون الطلاء None وسمة MediaColorName عندما يكون اللون White.
• لا تُجري الوحدة أي عمليات تشفير. ووضع ⁨FIPS⁩ لا يُغيّر سلوكها.

المطابقة

يُصدر ⁨NextPDF⁩ Pro مجموعة فرعية مُبسّطة من ⁨XJDF 2.1⁩. هذا توافق قدرات، وليس اعتماداً. لا يملك ⁨NextPDF⁩ أي اعتماد من ⁨CIP4⁩.

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

ملاحظات التطوير

• الجذر ومساحة الأسماء: عنصر <XJDF> ضمن http://www.CIP4.org/JDFSchema_2_0، مع Types="ConventionalPrinting".
• يُصدر مُسلسِل اللون NumColors وColorsUsed. ويُحتفظ بـ ColorSpec::renderingIntent على كائن القيمة لكنه لا يُكتب في الإخراج المُبسّط.
• يُطابق التشطيب القيم المنطقية بعمليات ⁨XJDF⁩: الطيّ إلى Folding، والتدبيس إلى Stitching، والخرم إلى HoleMaking، والقصّ إلى Trimming. ويُصدر التجليد غير None عنصر BindingIntent.
• تُهرَّب القيم بترميز ⁨XML⁩ فقط، دون التحقّق منها بغير ذلك. طهّر أسماء المهام والمُعرّفات ذات المصدر الخارجي قبل الإنشاء.

حدود النشر

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

انظر أيضاً

• مهمة الطباعة — نظرة عامة على القدرة
• خط أنابيب الإخراج — مرجع متعمّق