Print Job — Derinlemesine başvuru

Bir bakışta

XjdfJobTicket, üretim baskı iş akışları için bir XJDF 2.1 (XML JDF 2.0) iş bileti oluşturur. Akıcı oluşturucu iş meta verilerini, ortamı, renk amacını, son işlem operasyonlarını, önceliği ve kopya sayısını kaydeder. toXml ardından CIP4 ad alanlı bir XML belgesi serileştirir. Modül yalnızca bir bilet üretir. Bileti bir baskı denetleyicisine veya cihaza göndermez.

Kullanılabilirlik ve lisanslama

Bu yetenek NextPDF Pro (nextpdf/pro) ile birlikte gelir ve bir Pro katmanı lisans zarfıyla etkinleşir. Bu yetkiye sahip olmayan bir dağıtım, yeteneğin sınıflarını yüklemez. Sürümleri karşılaştırın ve bir lisans edinin.

Özellik başına bir lisans bayrağı geçerli değildir. Bu, bir Pro sürümü yeteneğidir.

Genel API yüzeyi

composer require nextpdf/pro:^3

Giriş noktası — akıcı oluşturucu:

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;
}

Ortam belirtimi — değişmez değer nesnesi:

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;
}

Renk amacı — değişmez değer nesnesi:

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;
}

Son işlem amacı — değişmez değer nesnesi:

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',
    );
}

Öncelik — dize destekli numaralandırma:

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

    public function numericValue(): int;
}

Simge	Parametreler	Varsayılan davranış	Döndürür	Fırlatır veya şununla başarısız olur	Notlar
XjdfJobTicket::__construct	yok	Öncelik JobPriority::Normal olarak; kopyalar 1 olarak başlatılır.	örnek	—	Akıcı oluşturucunun kökü.
XjdfJobTicket::setJobId	string $id	İş tanımlayıcısını kaydeder.	self	—	Boş değere izin verilir; bkz. toXml.
XjdfJobTicket::setJobName	string $name	İnsan tarafından okunabilir iş adını kaydeder.	self	—	Boş olmadığında GeneralID olarak yayılır.
XjdfJobTicket::setPriority	JobPriority $priority	Varsayılan Normal önceliğini geçersiz kılar.	self	—	—
XjdfJobTicket::setMedia	MediaSpec $media	Bir ortam kaynağı ekler.	self	—	İsteğe bağlı; ayarlanmadığında atlanır.
XjdfJobTicket::setColor	ColorSpec $color	Bir renk amacı kaynağı ekler.	self	—	İsteğe bağlı; ayarlanmadığında atlanır.
XjdfJobTicket::setFinishing	FinishingSpec $finishing	Son işlem kaynakları ekler.	self	—	İsteğe bağlı; ayarlanmadığında atlanır.
XjdfJobTicket::setCopies	int $copies	Çıktı kopya sayısını ayarlar.	self	$copies < 1 olduğunda InvalidArgumentException	Varsayılan 1’dir.
XjdfJobTicket::toXml	yok	XJDF 2.1 belgesini serileştirir.	string	—	Hiçbiri ayarlanmadığında rastgele bir XJDF_<hex> iş kimliği üretir.
MediaSpec::__construct	string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color	Varsayılan olarak 80 g/m² A4 beyaz kâğıt.	örnek	—	Tüm parametreler isteğe bağlı.
MediaSpec::isStandard	yok	A4, US Letter veya A3 ile 0,5 mm içinde eşleşir.	bool	—	Dikey veya yatay.
MediaSpec::toXjdfElement	yok	Bir <Media> öğesi yayar; milimetreleri noktalara dönüştürür.	string	—	Varsayılan değerlerinde kaplama ve rengi atlar.
ColorSpec::__construct	bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent	Varsayılan olarak CMYK, göreli kolorimetrik amaç.	örnek	—	—
ColorSpec::colorCount	yok	CMYK için 4, artı her nokta rengi için bir döndürür.	int	—	—
FinishingSpec::__construct	bool $fold, bool $staple, bool $punch, bool $trim, string $binding	Varsayılan olarak son işlem yok; cilt None.	örnek	—	—
JobPriority	Idle, Low, Normal, High, Rush numaralandırma durumları	—	numaralandırma	—	Dize destekli.
JobPriority::numericValue	yok	Durumu 0, 25, 50, 75 veya 100’e eşler.	int	—	En yükseği Rush (100).

Davranış sözleşmesi

• XjdfJobTicket, akıcı bir oluşturucudur. Her ayarlayıcı, zincirleme için self döndürür.
• toXml, CIP4 ad alanı http://www.CIP4.org/JDFSchema_2_0 altında, Types="ConventionalPrinting" ile basitleştirilmiş bir XJDF 2.1 belgesi serileştirir.
• Hiçbir iş kimliği ayarlanmadığında, toXml başarısız olmak yerine rastgele bir XJDF_ tanımlayıcısı koyar.
• Öncelik hem bir Comment hem de sayısal bir NodeInfo özniteliği olarak yazılır. Kopyalar bir Component çıktı miktarı olarak yazılır.
• Ortam, renk ve son işlem kaynakları yalnızca belirtimleri ayarlandığında görünür.
• Tüm öznitelik değerleri serileştirmeden önce XML olarak kaçışlanır.
• Modül bilet belgesini üretir. Bir baskı akışı işlemez veya bileti bir cihaza göndermez.

Uç durumlar ve başarısızlık modları

• 1’in altında bir değerle setCopies, InvalidArgumentException fırlatır. Bu, modülün oluşturduğu tek istisnadır.
• Boş veya ayarlanmamış bir iş kimliği bir hata değildir. toXml, serileştirme sırasında rastgele bir XJDF_<hex> tanımlayıcısı koyar.
• Ortam boyutları milimetredir. toXjdfElement, bunları 72 / 25.4 çarpanını kullanarak PDF noktalarına dönüştürür.
• MediaSpec::isStandard, 0,5 mm’lik bir tolerans uygular ve dikey veya yatay yönlendirmeyi kabul eder.
• MediaSpec::toXjdfElement, kaplama None olduğunda FrontCoatings’i ve renk White olduğunda MediaColorName’i atlar.
• Modül hiçbir kriptografik işlem gerçekleştirmez. FIPS modu davranışını değiştirmez.

Uygunluk

NextPDF Pro, basitleştirilmiş bir XJDF 2.1 alt kümesi yayar. Bu, sertifikasyon değil, yetenek hizalamasıdır. NextPDF hiçbir CIP4 sertifikasına sahip değildir.

Davranış	Başvuru	Durum
XJDF 2.1 iş bileti yapısı	XJDF 2.1 (CIP4)	Hizalanmış — basitleştirilmiş alt küme

Geliştirme notları

• Kök ve ad alanı: http://www.CIP4.org/JDFSchema_2_0 altında, Types="ConventionalPrinting" ile bir <XJDF> öğesi.
• Renk serileştiricisi NumColors ve ColorsUsed yayar. ColorSpec::renderingIntent, değer nesnesinde korunur ancak basitleştirilmiş çıktıya yazılmaz.
• Son işlem, boole değerlerini XJDF operasyonlarına eşler: katlamayı Folding’e, zımbalamayı Stitching’e, delmeyi HoleMaking’e ve kırpmayı Trimming’e. None olmayan bir cilt, bir BindingIntent yayar.
• Değerler XML olarak kaçışlanır, başka türlü doğrulanmaz. Dış kaynaklı iş adlarını ve tanımlayıcıları oluşturmadan önce temizleyin.

Yayın sınırı

Bu sayfa yalnızca dışarıdan gözlemlenebilir davranışı ve desteklenen genel API yüzeyini belgeler. Dahili ad alanı yolları, yardımcı sınıflar, mekanizma tabloları, çalıştırma kılavuzu dosya adları ve bilet ön ekleri kapsam dışıdır.

Ayrıca bkz.

• Print Job — yetenek genel bakışı
• Output Pipeline — Derinlemesine başvuru