Pro editie

Print Job — Diepe referentie

In het kort

XjdfJobTicket bouwt een XJDF 2.1 (XML JDF 2.0) job-ticket voor productieprintworkflows. De fluent builder legt jobmetadata, media, kleurintentie, afwerkingsbewerkingen, prioriteit en aantal exemplaren vast. toXml serialiseert vervolgens een XML-document in de CIP4-namespace. De module produceert alleen een ticket. Het verstuurt het ticket niet naar een perscontroller of apparaat.

Beschikbaarheid en licentie

Deze functionaliteit wordt geleverd in NextPDF Pro (nextpdf/pro) en activeert met een licentie-envelop van het Pro-niveau. Een deployment zonder die rechten laadt de klassen van de functionaliteit niet. Vergelijk edities en vraag een licentie aan.

Er geldt geen licentievlag per feature. Dit is een Pro-editie-functionaliteit.

Publiek API-oppervlak

composer require nextpdf/pro:^3

Instappunt — de fluent builder:

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

Mediaspecificatie — onveranderlijk value object:

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

Kleurintentie — onveranderlijk value object:

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

Afwerkingsintentie — onveranderlijk value object:

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

Prioriteit — string-backed enum:

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

    public function numericValue(): int;
}

Symbool	Parameters	Standaardgedrag	Retourneert	Werpt of faalt met	Opmerkingen
`XjdfJobTicket::__construct`	geen	Prioriteit geïnitialiseerd op `JobPriority::Normal`; exemplaren op 1.	instance	—	Basis van de fluent builder.
`XjdfJobTicket::setJobId`	`string $id`	Legt de job-identifier vast.	`self`	—	Lege waarde is toegestaan; zie `toXml`.
`XjdfJobTicket::setJobName`	`string $name`	Legt de leesbare jobnaam vast.	`self`	—	Uitgevoerd als een `GeneralID` indien niet-leeg.
`XjdfJobTicket::setPriority`	`JobPriority $priority`	Overschrijft de standaardprioriteit `Normal`.	`self`	—	—
`XjdfJobTicket::setMedia`	`MediaSpec $media`	Koppelt een media-resource.	`self`	—	Optioneel; weggelaten indien niet gezet.
`XjdfJobTicket::setColor`	`ColorSpec $color`	Koppelt een kleurintentie-resource.	`self`	—	Optioneel; weggelaten indien niet gezet.
`XjdfJobTicket::setFinishing`	`FinishingSpec $finishing`	Koppelt afwerkings-resources.	`self`	—	Optioneel; weggelaten indien niet gezet.
`XjdfJobTicket::setCopies`	`int $copies`	Stelt het aantal uitvoerexemplaren in.	`self`	`InvalidArgumentException` wanneer `$copies < 1`	Standaard is 1.
`XjdfJobTicket::toXml`	geen	Serialiseert het XJDF 2.1-document.	`string`	—	Genereert een willekeurige `XJDF_<hex>` job-ID wanneer er geen is gezet.
`MediaSpec::__construct`	`string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color`	Standaard A4 wit papier van 80 g/m².	instance	—	Alle parameters optioneel.
`MediaSpec::isStandard`	geen	Komt overeen met A4, US Letter of A3 binnen 0,5 mm.	`bool`	—	Staand of liggend.
`MediaSpec::toXjdfElement`	geen	Zendt een `<Media>`-element uit; converteert millimeters naar punten.	`string`	—	Laat coating en kleur weg bij hun standaardwaarden.
`ColorSpec::__construct`	`bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent`	Standaard CMYK, relatief-colorimetrische intentie.	instance	—	—
`ColorSpec::colorCount`	geen	Retourneert 4 voor CMYK plus één per steunkleur.	`int`	—	—
`FinishingSpec::__construct`	`bool $fold, bool $staple, bool $punch, bool $trim, string $binding`	Standaard geen afwerking; binding `None`.	instance	—	—
`JobPriority`	enum-cases `Idle`, `Low`, `Normal`, `High`, `Rush`	—	enum	—	String-backed.
`JobPriority::numericValue`	geen	Mapt de case naar 0, 25, 50, 75 of 100.	`int`	—	Hoogste is `Rush` (100).

Gedragscontract

XjdfJobTicket is een fluent builder. Elke setter retourneert self om te ketenen.
toXml serialiseert een vereenvoudigd XJDF 2.1-document onder de CIP4-namespace http://www.CIP4.org/JDFSchema_2_0, met Types="ConventionalPrinting".
Wanneer er geen job-ID is gezet, vervangt toXml dit door een willekeurige XJDF_-identifier in plaats van te falen.
Prioriteit wordt zowel als Comment als als numeriek NodeInfo-attribuut geschreven. Exemplaren worden geschreven als een Component-uitvoerhoeveelheid.
Media-, kleur- en afwerkings-resources verschijnen alleen wanneer hun specificaties zijn gezet.
Alle attribuutwaarden worden XML-escaped vóór serialisatie.
De module produceert het ticketdocument. Het rendert geen printstream en verstuurt het ticket niet naar een apparaat.

Randgevallen en faalmodi

setCopies met een waarde onder 1 werpt InvalidArgumentException. Dit is de enige exception die de module opwerpt.
Een lege of niet-gezette job-ID is geen fout. toXml vervangt dit door een willekeurige XJDF_<hex>-identifier op het moment van serialisatie.
Mediadimensies zijn in millimeters. toXjdfElement converteert ze naar PDF-punten met de factor 72 / 25.4.
MediaSpec::isStandard past een tolerantie van 0,5 mm toe en accepteert staande of liggende oriëntatie.
MediaSpec::toXjdfElement laat FrontCoatings weg wanneer coating None is en MediaColorName wanneer kleur White is.
De module voert geen cryptografische bewerkingen uit. De FIPS-modus verandert het gedrag niet.

Conformiteit

NextPDF Pro zendt een vereenvoudigde XJDF 2.1-subset uit. Dit is afstemming van functionaliteit, geen certificering. NextPDF beschikt niet over een CIP4-certificering.

Gedrag	Referentie	Status
XJDF 2.1 job-ticketstructuur	XJDF 2.1 (CIP4)	Afgestemd — vereenvoudigde subset

Ontwikkelnotities

Root en namespace: een <XJDF>-element onder http://www.CIP4.org/JDFSchema_2_0, met Types="ConventionalPrinting".
De kleurserializer zendt NumColors en ColorsUsed uit. ColorSpec::renderingIntent blijft op het value object behouden maar wordt niet in de vereenvoudigde uitvoer geschreven.
Afwerking mapt booleans naar XJDF-bewerkingen: fold naar Folding, staple naar Stitching, punch naar HoleMaking en trim naar Trimming. Een binding anders dan None zendt een BindingIntent uit.
Waarden worden XML-escaped, verder niet gevalideerd. Saniteer extern afkomstige jobnamen en identifiers voordat je bouwt.

Publicatiegrens

Deze pagina documenteert alleen extern waarneembaar gedrag en het ondersteunde publieke API-oppervlak. Interne namespace-paden, helper-klassen, mechanismetabellen, runbook-bestandsnamen en ticket-prefixes vallen buiten de scope.