งานพิมพ์

โดยสรุป

NextPDF Pro สร้างใบสั่งงาน XJDF (XML JDF 2.0) สำหรับเวิร์กโฟลว์การพิมพ์ระดับการผลิต ได้แก่ เมทาดาทาของงาน ข้อกำหนดวัสดุพิมพ์ เจตนาด้านสี การดำเนินการตกแต่งสำเร็จ ลำดับความสำคัญ และจำนวนสำเนา

ความพร้อมใช้งานและการอนุญาต

ความสามารถนี้มาพร้อมกับ NextPDF Pro (nextpdf/pro) และเปิดใช้งานด้วยซองสิทธิ์ใช้งานระดับ Pro การนำไปใช้งานที่ไม่มีสิทธิ์ดังกล่าวจะไม่โหลดคลาสของความสามารถนี้ Print Job ไม่มีแฟล็กสิทธิ์ใช้งานแยกต่างหากรายฟีเจอร์ เปรียบเทียบรุ่นและขอรับสิทธิ์ใช้งาน

การติดตั้ง

composer require nextpdf/pro:^3

ภาพรวมเชิงแนวคิด

ระบบการผลิตงานพิมพ์บริโภคใบสั่งงานที่อธิบายว่าจะผลิตงานอย่างไร NextPDF Pro ส่งออกเอกสาร XJDF 2.1 ด้วยตัวสร้างแบบ fluent:

• XjdfJobTicket — ตัวสร้าง ตั้งค่า ID และชื่องาน ลำดับความสำคัญ วัสดุพิมพ์ สี การตกแต่งสำเร็จ และจำนวนสำเนา จากนั้นซีเรียลไลซ์เป็นเอกสาร XML แบบ XJDF 2.1
• MediaSpec — คุณสมบัติวัสดุพิมพ์แบบ immutable ได้แก่ ประเภท ความกว้างและความสูงเป็นมิลลิเมตร น้ำหนักเป็น g/m² การเคลือบ และสี ค่าเริ่มต้นเป็นกระดาษ A4 สีขาว
• ColorSpec, FinishingSpec, JobPriority — เจตนาด้านสี การดำเนินการตกแต่งสำเร็จ และ enum ลำดับความสำคัญ

XML ที่สร้างขึ้นเป็นไปตามโครงสร้าง XJDF 2.1 แบบลดทอน โมดูลผลิตใบสั่งงาน ไม่ได้ส่งไปยังตัวควบคุมแท่นพิมพ์หรืออุปกรณ์

เหตุใดจึงทำงานเช่นนี้

Print Job สร้างใบสั่งงานแล้วหยุดอยู่แค่นั้น ไม่เคยส่งงานหรือเรนเดอร์กระแสการพิมพ์ ขอบเขตนี้เป็นไปโดยเจตนา เอกสาร XJDF เป็นคำอธิบายเจตนาที่พกพาได้ ทั้งวัสดุพิมพ์ สี การตกแต่งสำเร็จ ลำดับความสำคัญ และจำนวนสำเนา ซึ่งตัวควบคุมแท่นพิมพ์ปลายทางจะบริโภคและดำเนินการ การให้โมดูลเป็นเพียงตัวซีเรียลไลซ์ล้วน ๆ ทำให้ใบสั่งงานเดียวขับเคลื่อนการผลิตปริมาณสูงได้โดยไม่ผูกโค้ดของคุณเข้ากับโปรโตคอลของอุปกรณ์ อ็อบเจกต์ข้อกำหนดเป็น immutable ดังนั้นอินพุตที่เหมือนกันจะให้ใบสั่งงานเดียวกันเสมอ ซึ่งทำให้เอาต์พุตแบบชุดสามารถทำซ้ำได้

พื้นหลังการออกแบบ: การสร้างเอกสารปริมาณสูง

พื้นผิว API

คลาส	ความรับผิดชอบ
XjdfJobTicket	ตัวสร้างใบสั่งงาน XJDF 2.1 แบบ fluent
MediaSpec	คุณสมบัติทางกายภาพของวัสดุพิมพ์
ColorSpec	เจตนาด้านสี
FinishingSpec	การดำเนินการตกแต่งสำเร็จ
JobPriority	enum ลำดับความสำคัญ

ตัวอย่างโค้ด — เริ่มต้นอย่างรวดเร็ว

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() เมื่อ ID งานว่างเปล่า จะสร้างตัวระบุที่ไม่ซ้ำกันแทนที่จะล้มเหลว
• setCopies() ปฏิเสธจำนวนสำเนาที่ต่ำกว่า 1
• มิติของวัสดุพิมพ์เป็นมิลลิเมตร ให้แปลงจากพอยต์ก่อนส่งเข้ามา
• เอาต์พุตเป็นเอกสารใบสั่งงาน ไม่ใช่กระแสการพิมพ์ที่เรนเดอร์แล้ว

ประสิทธิภาพ

การสร้างใบสั่งงานใช้เวลาคงที่เทียบกับขนาดเอกสาร โดยขึ้นอยู่กับทรัพยากรที่กำหนดค่าไว้เท่านั้น

หมายเหตุด้านความปลอดภัย

ตัวสร้างส่งออก XML จากค่าที่คุณจัดหา ให้ทำให้ชื่องานและตัวระบุที่มาจากแหล่งภายนอกสะอาดก่อนสร้าง

การเป็นไปตามข้อกำหนด

พฤติกรรม	การอ้างอิง	สถานะ
โครงสร้างใบสั่งงาน XJDF 2.1	XJDF 2.1 (CIP4)	สอดคล้อง (ชุดย่อยแบบลดทอน)

สัญญาพฤติกรรม

• XjdfJobTicket เป็นตัวสร้างแบบ fluent สำหรับ ID และชื่องาน ลำดับความสำคัญ วัสดุพิมพ์ สี การตกแต่งสำเร็จ และจำนวนสำเนา โดยซีเรียลไลซ์เป็นเอกสาร XML แบบ XJDF 2.1 ที่ลดทอนผ่าน toXml() setCopies() ปฏิเสธจำนวนสำเนาที่ต่ำกว่า 1 ส่วน ID งานที่ว่างเปล่าจะถูกสร้างอัตโนมัติ
• MediaSpec พกพาคุณสมบัติวัสดุพิมพ์แบบ immutable (ประเภท ความกว้าง/ความสูงเป็นมิลลิเมตร น้ำหนักเป็น g/m² การเคลือบ สี) และมีค่าเริ่มต้นเป็นกระดาษ A4 สีขาว
• ColorSpec, FinishingSpec และ JobPriority อธิบายเจตนาด้านสี การดำเนินการตกแต่งสำเร็จ และลำดับความสำคัญ
• โมดูลผลิตเอกสารใบสั่งงานเท่านั้น ไม่ได้เรนเดอร์กระแสการพิมพ์หรือส่งใบสั่งงานไปยังตัวควบคุมแท่นพิมพ์หรืออุปกรณ์

หมายเหตุขอบเขตของ Enterprise

Enterprise ไม่เปลี่ยนพฤติกรรมของ Print Job Enterprise เพิ่มฟีเจอร์ระดับสูงกว่าซึ่งจัดทำเอกสารแยกต่างหาก ฟีเจอร์เหล่านั้นไม่จำเป็นสำหรับการสร้างใบสั่งงาน XJDF

ทางเลือกสำรองของ Core

ไม่มีสิ่งเทียบเท่าใน Core สำหรับการสร้างใบสั่งงาน XJDF 2.1 นี่เป็นส่วนเพิ่มของ Pro

ขอบเขตการเผยแพร่

หน้านี้อธิบายเฉพาะพฤติกรรมที่สังเกตได้จากภายนอกและพื้นผิว API สาธารณะที่รองรับเท่านั้น พาธเนมสเปซภายใน คลาสตัวช่วย ตารางกลไก ชื่อไฟล์ runbook และคำนำหน้าใบสั่งงานอยู่นอกขอบเขต

ดูเพิ่มเติม

• Print Job — Deep Reference — พื้นผิว API ฉบับเต็มสำหรับโมดูล print-job
• Output Pipeline — การจัดเตรียมเอาต์พุต
• Document — การประกอบเอกสาร