Print Job

Sekilas pandang

NextPDF Pro membangun tiket job XJDF (XML JDF 2.0) untuk alur kerja cetak produksi: metadata job, spesifikasi media, intent warna, operasi finishing, prioritas, dan jumlah salinan.

Ketersediaan & lisensi

Kapabilitas ini dikirim dalam NextPDF Pro (nextpdf/pro) dan aktif dengan envelope lisensi tingkat Pro. Deployment tanpa entitlement tersebut tidak memuat kelas-kelas kapabilitas ini. Print Job tidak membawa flag lisensi per-fitur yang terpisah. Bandingkan edisi dan dapatkan lisensi.

Pemasangan

composer require nextpdf/pro:^3

Tinjauan konseptual

Sistem produksi-cetak mengonsumsi tiket job yang menjelaskan cara memproduksi sebuah job. NextPDF Pro mengeluarkan dokumen XJDF 2.1 dengan builder fluen:

• XjdfJobTicket — builder-nya. Setel ID dan nama job, prioritas, media, warna, finishing, dan jumlah salinan, lalu serialisasikan menjadi dokumen XML XJDF 2.1.
• MediaSpec — properti media imutabel: tipe, lebar dan tinggi dalam milimeter, berat dalam g/m², coating, dan warna. Baku ke kertas putih A4.
• ColorSpec, FinishingSpec, JobPriority — intent warna, operasi finishing, dan enum prioritas.

XML yang dihasilkan mengikuti struktur XJDF 2.1 yang disederhanakan. Modul menghasilkan tiket; ia tidak mengirimkannya ke pengendali atau perangkat mesin cetak.

Mengapa cara kerjanya seperti ini

Print Job membangun tiket dan berhenti di situ. Ia tidak pernah mengirimkan job atau merender stream cetak. Batas itu disengaja. Dokumen XJDF adalah deskripsi intent yang portabel — media, warna, finishing, prioritas, salinan — yang dikonsumsi dan dijalankan oleh pengendali mesin cetak di hilir. Dengan menjaga modul sebagai serializer murni, satu tiket dapat menggerakkan proses produksi bervolume tinggi tanpa mengikat kode Anda ke protokol perangkat. Objek spesifikasi bersifat imutabel, sehingga input yang identik selalu menghasilkan tiket yang sama, yang menjaga keluaran batch tetap reproducible.

Latar belakang desain: Pembuatan dokumen bervolume tinggi.

Permukaan API

Kelas	Tanggung jawab
XjdfJobTicket	Builder tiket job XJDF 2.1 yang fluen.
MediaSpec	Properti fisik media.
ColorSpec	Intent warna.
FinishingSpec	Operasi finishing.
JobPriority	Enum prioritas.

Contoh kode — Mulai cepat

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Contoh kode — Produksi

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]);

Kasus tepi & jebakan

• Serialisasikan dengan toXml(); ketika ID job kosong, ia menghasilkan pengenal unik alih-alih gagal.
• setCopies() menolak jumlah salinan di bawah 1.
• Dimensi media dalam milimeter; konversi dari titik sebelum meneruskannya.
• Keluaran adalah dokumen tiket, bukan stream cetak yang dirender.

Kinerja

Konstruksi tiket bersifat waktu-konstan relatif terhadap ukuran dokumen; ia hanya bergantung pada sumber daya yang dikonfigurasi.

Catatan keamanan

Builder mengeluarkan XML dari nilai yang Anda suplai. Sanitasi nama job dan pengenal yang bersumber dari luar sebelum membangunnya.

Kesesuaian

Perilaku	Acuan	Status
Struktur tiket job XJDF 2.1	XJDF 2.1 (CIP4)	Aligned (simplified subset)

Kontrak perilaku

• XjdfJobTicket adalah builder fluen untuk ID dan nama job, prioritas, media, warna, finishing, dan jumlah salinan, yang diserialisasikan menjadi dokumen XML XJDF 2.1 yang disederhanakan via toXml(). setCopies() menolak jumlah salinan di bawah 1; ID job yang kosong dibuat secara otomatis.
• MediaSpec membawa properti media imutabel (tipe, lebar/tinggi dalam milimeter, berat dalam g/m², coating, warna) dan baku ke kertas putih A4.
• ColorSpec, FinishingSpec, dan JobPriority menjelaskan intent warna, operasi finishing, dan prioritas.
• Modul hanya menghasilkan dokumen tiket. Ia tidak merender stream cetak atau mengirimkan tiket ke pengendali atau perangkat mesin cetak.

Catatan batas Enterprise

Enterprise tidak mengubah perilaku Print Job. Enterprise menambahkan fitur tingkat lebih tinggi yang didokumentasikan secara terpisah; fitur tersebut tidak diperlukan untuk membangun tiket job XJDF.

Fallback / alternatif Core

Tidak ada padanan Core untuk pembuatan tiket job XJDF 2.1. Ini adalah tambahan Pro.

Batas publikasi

Halaman ini hanya mendokumentasikan perilaku yang dapat diamati secara eksternal dan permukaan API publik yang didukung. Path namespace internal, kelas pembantu, tabel mekanisme, nama berkas runbook, dan prefiks tiket berada di luar cakupan.

Lihat juga

• Print Job — Referensi Mendalam — permukaan API lengkap untuk modul print-job.
• Output Pipeline — staging keluaran.
• Document — perakitan dokumen.