Print Job

速覽

NextPDF Pro 會為正式列印工作流程建構 XJDF（XML JDF 2.0）工作票：工作中繼資料、媒材規格、色彩意圖、加工作業、優先順序，以及份數。

可用性與授權

此功能隨 NextPDF Pro（nextpdf/pro）出貨，並以 Pro 層級授權封套啟用。未持有該權利的部署不會載入此功能的類別。Print Job 不帶任何獨立的逐功能授權旗標。比較各版本並取得授權。

安裝

composer require nextpdf/pro:^3

概念總覽

列印生產系統會消費一張描述如何製作工作的工作票。NextPDF Pro 以一個流暢式建構器發出一份 XJDF 2.1 文件：

• XjdfJobTicket — 建構器。設定工作 ID 與名稱、優先順序、媒材、色彩、加工與份數，接著序列化為一份 XJDF 2.1 XML 文件。
• MediaSpec — 不可變的媒材屬性：類型、以公釐為單位的寬與高、以 g/m² 為單位的重量、塗布，以及色彩。預設為 A4 白紙。
• ColorSpec、FinishingSpec、JobPriority — 色彩意圖、加工作業，以及一個優先順序 enum。

所產生的 XML 遵循簡化的 XJDF 2.1 結構。此模組產生工作票；它不會將其提交給印刷機控制器或裝置。

它為何這樣運作

Print Job 只建構一張工作票就到此為止。它從不提交工作，也不彩現列印串流。這道界線是刻意為之。XJDF 文件是一份可攜的意圖描述——媒材、色彩、加工、優先順序、份數——由下游的印刷機控制器消費並執行。讓此模組維持為純序列化器，可使單一工作票驅動一次大量的生產作業，而不必將你的程式碼耦合到某個裝置協定。這些規格物件都是不可變的，因此相同的輸入永遠產出相同的工作票，讓批次輸出保持可重現。

設計背景：大量文件產生。

API 介面

類別	職責
XjdfJobTicket	流暢式 XJDF 2.1 工作票建構器。
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 的份數。
• 媒材尺寸以公釐為單位；傳入前請從點（point）換算。
• 輸出是一份工作票文件，而非一份彩現後的列印串流。

效能

工作票建構相對於文件大小是常數時間；它只取決於所設定的資源。

安全注意事項

建構器會從你提供的值發出 XML。在建構前，請先清理外部來源的工作名稱與識別碼。

一致性

行為	參考	狀態
XJDF 2.1 工作票結構	XJDF 2.1 (CIP4)	已對齊（簡化子集）

行為合約

• XjdfJobTicket 是一個用於工作 ID 與名稱、優先順序、媒材、色彩、加工與份數的流暢式建構器，透過 toXml() 序列化為一份簡化的 XJDF 2.1 XML 文件。setCopies() 會拒絕小於 1 的份數；空白的工作 ID 會自動產生。
• MediaSpec 承載不可變的媒材屬性（類型、以公釐為單位的寬/高、以 g/m² 為單位的重量、塗布、色彩），並預設為 A4 白紙。
• ColorSpec、FinishingSpec 與 JobPriority 描述色彩意圖、加工作業與優先順序。
• 此模組只產生一份工作票文件。它不會彩現列印串流，也不會將工作票提交給印刷機控制器或裝置。

Enterprise 邊界註記

Enterprise 不會改變 Print Job 的行為。Enterprise 加入的是另行記載的更高階功能；建構 XJDF 工作票並不需要它們。

Core 回退/替代方案

XJDF 2.1 工作票產生沒有 Core 對應功能。這是 Pro 新增的功能。

發佈界線

本頁僅記載外部可觀察的行為，以及所支援的公開 API 介面。內部命名空間路徑、輔助類別、機制表格、runbook 檔名，以及工作票前綴皆不在範圍內。

另請參閱

• Print Job — 深入參考 — print-job 模組的完整 API 介面。
• Output Pipeline — 輸出暫存。
• Document — 文件組裝。