Pro Edition

Print Job — Ausführliche Referenz

Auf einen Blick

XjdfJobTicket erstellt ein XJDF-2.1-Job-Ticket (XML JDF 2.0) für produktive Druck-Workflows. Der Fluent-Builder erfasst Job-Metadaten, Bedruckstoff, Farbabsicht, Weiterverarbeitungsvorgänge, Priorität und Kopienzahl. toXml serialisiert anschließend ein XML-Dokument mit CIP4-Namespace. Das Modul erzeugt ausschließlich ein Ticket. Es übermittelt das Ticket nicht an einen Press-Controller oder an ein Gerät.

Verfügbarkeit und Lizenzierung

Diese Fähigkeit ist in NextPDF Pro (nextpdf/pro) enthalten und wird mit einem Lizenz-Envelope der Pro-Stufe aktiviert. Eine Bereitstellung ohne diese Berechtigung lädt die Klassen der Fähigkeit nicht. Editionen vergleichen und Lizenz erwerben.

Es gilt kein funktionsbezogenes Lizenz-Flag. Dies ist eine Fähigkeit der Pro-Edition.

Öffentliche API-Oberfläche

composer require nextpdf/pro:^3

Einstiegspunkt — der 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;
}

Bedruckstoff-Spezifikation — unveränderliches 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;
}

Farbabsicht — unveränderliches 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;
}

Weiterverarbeitungsabsicht — unveränderliches 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',
    );
}

Priorität — string-basiertes Enum:

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

    public function numericValue(): int;
}

Symbol	Parameter	Standardverhalten	Rückgabe	Wirft oder scheitert mit	Hinweise
`XjdfJobTicket::__construct`	keine	Priorität auf `JobPriority::Normal` initialisiert; Kopien auf 1.	Instanz	—	Wurzel des Fluent-Builders.
`XjdfJobTicket::setJobId`	`string $id`	Erfasst die Job-Kennung.	`self`	—	Ein leerer Wert ist zulässig; siehe `toXml`.
`XjdfJobTicket::setJobName`	`string $name`	Erfasst den menschenlesbaren Job-Namen.	`self`	—	Wird als `GeneralID` ausgegeben, wenn nicht leer.
`XjdfJobTicket::setPriority`	`JobPriority $priority`	Überschreibt die Standardpriorität `Normal`.	`self`	—	—
`XjdfJobTicket::setMedia`	`MediaSpec $media`	Hängt eine Bedruckstoff-Ressource an.	`self`	—	Optional; entfällt, wenn nicht gesetzt.
`XjdfJobTicket::setColor`	`ColorSpec $color`	Hängt eine Farbabsicht-Ressource an.	`self`	—	Optional; entfällt, wenn nicht gesetzt.
`XjdfJobTicket::setFinishing`	`FinishingSpec $finishing`	Hängt Weiterverarbeitungs-Ressourcen an.	`self`	—	Optional; entfällt, wenn nicht gesetzt.
`XjdfJobTicket::setCopies`	`int $copies`	Legt die Ausgabe-Kopienzahl fest.	`self`	`InvalidArgumentException`, wenn `$copies < 1`	Standard ist 1.
`XjdfJobTicket::toXml`	keine	Serialisiert das XJDF-2.1-Dokument.	`string`	—	Erzeugt eine zufällige `XJDF_<hex>`-Job-ID, wenn keine gesetzt wurde.
`MediaSpec::__construct`	`string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color`	Standard ist A4 weißes Papier mit 80 g/m².	Instanz	—	Alle Parameter optional.
`MediaSpec::isStandard`	keine	Trifft auf A4, US Letter oder A3 innerhalb von 0,5 mm zu.	`bool`	—	Hoch- oder Querformat.
`MediaSpec::toXjdfElement`	keine	Gibt ein `<Media>`-Element aus; wandelt Millimeter in Punkte um.	`string`	—	Lässt Beschichtung und Farbe bei ihren Standardwerten weg.
`ColorSpec::__construct`	`bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent`	Standard ist CMYK, relativ-farbmetrische Absicht.	Instanz	—	—
`ColorSpec::colorCount`	keine	Gibt 4 für CMYK plus eins pro Sonderfarbe zurück.	`int`	—	—
`FinishingSpec::__construct`	`bool $fold, bool $staple, bool $punch, bool $trim, string $binding`	Standard ist keine Weiterverarbeitung; Bindung `None`.	Instanz	—	—
`JobPriority`	Enum-Fälle `Idle`, `Low`, `Normal`, `High`, `Rush`	—	Enum	—	String-basiert.
`JobPriority::numericValue`	keine	Bildet den Fall auf 0, 25, 50, 75 oder 100 ab.	`int`	—	Höchster Wert ist `Rush` (100).

Verhaltensvertrag

XjdfJobTicket ist ein Fluent-Builder. Jeder Setter gibt self zur Verkettung zurück.
toXml serialisiert ein vereinfachtes XJDF-2.1-Dokument unter dem CIP4-Namespace http://www.CIP4.org/JDFSchema_2_0, mit Types="ConventionalPrinting".
Wenn keine Job-ID gesetzt wurde, setzt toXml eine zufällige XJDF_-Kennung ein, anstatt zu scheitern.
Die Priorität wird sowohl als Comment als auch als numerisches NodeInfo-Attribut geschrieben. Kopien werden als Component-Ausgabemenge geschrieben.
Bedruckstoff-, Farb- und Weiterverarbeitungs-Ressourcen erscheinen nur, wenn ihre Spezifikationen gesetzt wurden.
Alle Attributwerte werden vor der Serialisierung XML-escaped.
Das Modul erzeugt das Ticket-Dokument. Es rendert keinen Druckdatenstrom und übermittelt das Ticket nicht an ein Gerät.

Grenzfälle und Fehlermodi

setCopies mit einem Wert unter 1 wirft InvalidArgumentException. Dies ist die einzige Ausnahme, die das Modul auslöst.
Eine leere oder nicht gesetzte Job-ID ist kein Fehler. toXml setzt zur Serialisierungszeit eine zufällige XJDF_<hex>-Kennung ein.
Bedruckstoff-Abmessungen sind Millimeter. toXjdfElement wandelt sie mit dem Faktor 72 / 25,4 in PDF-Punkte um.
MediaSpec::isStandard wendet eine Toleranz von 0,5 mm an und akzeptiert Hoch- oder Querformat.
MediaSpec::toXjdfElement lässt FrontCoatings weg, wenn die Beschichtung None ist, und MediaColorName, wenn die Farbe White ist.
Das Modul führt keine kryptografischen Operationen durch. Der FIPS-Modus ändert sein Verhalten nicht.

Konformität

NextPDF Pro gibt eine vereinfachte XJDF-2.1-Teilmenge aus. Dies ist eine Fähigkeitsangleichung, keine Zertifizierung. NextPDF verfügt über keine CIP4-Zertifizierung.

Verhalten	Referenz	Status
XJDF-2.1-Job-Ticket-Struktur	XJDF 2.1 (CIP4)	Angeglichen — vereinfachte Teilmenge

Entwicklungshinweise

Wurzel und Namespace: ein <XJDF>-Element unter http://www.CIP4.org/JDFSchema_2_0, mit Types="ConventionalPrinting".
Der Farb-Serialisierer gibt NumColors und ColorsUsed aus. ColorSpec::renderingIntent bleibt auf dem Value Object erhalten, wird aber nicht in die vereinfachte Ausgabe geschrieben.
Die Weiterverarbeitung bildet Booleans auf XJDF-Vorgänge ab: fold auf Folding, staple auf Stitching, punch auf HoleMaking und trim auf Trimming. Eine von None abweichende Bindung gibt ein BindingIntent aus.
Werte werden XML-escaped, ansonsten nicht validiert. Bereinigen Sie extern bezogene Job-Namen und Kennungen vor dem Erstellen.

Veröffentlichungsgrenze

Diese Seite dokumentiert ausschließlich extern beobachtbares Verhalten und die unterstützte öffentliche API-Oberfläche. Interne Namespace-Pfade, Hilfsklassen, Mechanismustabellen, Runbook-Dateinamen und Ticket-Präfixe liegen außerhalb des Geltungsbereichs.