印刷ジョブ

概要

NextPDF Pro は、本番印刷ワークフロー向けに XJDF（XML JDF 2.0）ジョブチケットを構築します。ジョブメタデータ、メディア仕様、色の意図、後加工の操作、優先度、部数を扱います。

提供とライセンス

この機能は NextPDF Pro（nextpdf/pro）で提供され、Pro ティアのライセンスエンベロープで有効化されます。そのエンタイトルメントを持たないデプロイメントでは、この機能のクラスは読み込まれません。印刷ジョブに、機能ごとの個別のライセンスフラグはありません。エディションを比較してライセンスを取得する。

インストール

composer require nextpdf/pro:^3

概念の概要

印刷生産システムは、ジョブをどのように生産するかを記述したジョブチケットを消費します。NextPDF Pro は、フルエントビルダーで XJDF 2.1 ドキュメントを出力します。

• XjdfJobTicket — ビルダー。ジョブ ID と名前、優先度、メディア、色、後加工、部数を設定し、続いて XJDF 2.1 XML ドキュメントにシリアライズします。
• MediaSpec — 不変のメディアプロパティ。種別、ミリメートル単位の幅と高さ、g/m² 単位の重量、コーティング、色です。既定は A4 の白い用紙です。
• ColorSpec、FinishingSpec、JobPriority — 色の意図、後加工の操作、優先度の列挙型です。

生成される XML は、簡略化された XJDF 2.1 の構造に従います。このモジュールはチケットを生成しますが、それをプレスコントローラーやデバイスに送信することはありません。

なぜこの方式なのか

印刷ジョブはチケットを構築し、そこで止まります。ジョブを送信したり、印刷ストリームをレンダリングしたりすることは一切ありません。この境界は意図的なものです。XJDF ドキュメントは、意図（メディア、色、後加工、優先度、部数）をポータブルに記述したものであり、下流のプレスコントローラーがそれを消費して実行します。モジュールを純粋なシリアライザーに保つことで、コードをデバイスプロトコルに結合させることなく、1 枚のチケットで大量の本番生産を駆動できます。仕様オブジェクトは不変なので、同じ入力からは常に同じチケットが得られ、バッチ出力の再現性が保たれます。

設計背景：大量ドキュメント生成。

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() でシリアライズします。ジョブ ID が空の場合は、失敗させるのではなく一意の識別子を生成します。
• setCopies() は、1 未満の部数を拒否します。
• メディアの寸法はミリメートルです。渡す前にポイントから変換してください。
• 出力はチケットドキュメントであり、レンダリングされた印刷ストリームではありません。

パフォーマンス

チケットの構築は、ドキュメントサイズに対して定数時間です。構成されたリソースのみに依存します。

セキュリティに関する注意

ビルダーは、供給した値から 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 サーフェスのみを記述しています。内部の名前空間パス、ヘルパークラス、メカニズムの表、ランブックのファイル名、チケットのプレフィックスは対象外です。

関連項目

• Print Job — Deep Reference — 印刷ジョブモジュールの完全な API サーフェス。
• Output Pipeline — 出力のステージング。
• Document — ドキュメントの組み立て。