Druckauftrag

Auf einen Blick

NextPDF Pro erstellt XJDF-(XML JDF 2.0-)Auftrags-Tickets für Produktionsdruck-Workflows: Auftragsmetadaten, Medienspezifikation, Farbintention, Finishing-Operationen, Priorität und Kopienanzahl.

Verfügbarkeit & Lizenzierung

Diese Funktion wird mit NextPDF Pro (nextpdf/pro) ausgeliefert und aktiviert sich mit einem Lizenzumschlag der Pro-Stufe. Eine Bereitstellung ohne diese Berechtigung lädt die Klassen der Funktion nicht. Print Job trägt kein separates Lizenz-Flag pro Funktion. Editionen vergleichen und eine Lizenz erwerben.

Installation

composer require nextpdf/pro:^3

Konzeptioneller Überblick

Ein Produktionsdrucksystem konsumiert ein Auftrags-Ticket, das beschreibt, wie ein Auftrag zu produzieren ist. NextPDF Pro gibt ein XJDF-2.1-Dokument mit einem Fluent-Builder aus:

• XjdfJobTicket — der Builder. Legen Sie Auftrags-ID und -name, Priorität, Medien, Farbe, Finishing und Kopienanzahl fest und serialisieren Sie anschließend zu einem XJDF-2.1-XML-Dokument.
• MediaSpec — unveränderliche Medieneigenschaften: Typ, Breite und Höhe in Millimetern, Gewicht in g/m², Beschichtung und Farbe. Standardwert ist weißes A4-Papier.
• ColorSpec, FinishingSpec, JobPriority — Farbintention, Finishing-Operationen und ein Prioritäts-Enum.

Das erzeugte XML folgt der vereinfachten XJDF-2.1-Struktur. Das Modul erzeugt das Ticket; es übermittelt es nicht an einen Druckmaschinen-Controller oder ein Gerät.

Warum es so funktioniert

Print Job erstellt ein Ticket und hört dort auf. Es übermittelt niemals den Auftrag und rendert keinen Druck-Stream. Diese Grenze ist bewusst gesetzt. Das XJDF-Dokument ist eine portable Beschreibung der Intention — Medien, Farbe, Finishing, Priorität, Kopien —, die ein nachgelagerter Druckmaschinen-Controller konsumiert und ausführt. Das Modul als reinen Serialisierer zu belassen, erlaubt es einem einzigen Ticket, einen Produktionslauf mit hohem Volumen zu steuern, ohne Ihren Code an ein Geräteprotokoll zu koppeln. Die Spezifikationsobjekte sind unveränderlich, sodass identische Eingaben stets dasselbe Ticket ergeben, was die Batch-Ausgabe reproduzierbar hält.

Design-Hintergrund: Dokumentgenerierung mit hohem Volumen.

API-Oberfläche

Klasse	Zuständigkeit
XjdfJobTicket	Fluent-XJDF-2.1-Auftrags-Ticket-Builder.
MediaSpec	Physische Medieneigenschaften.
ColorSpec	Farbintention.
FinishingSpec	Finishing-Operationen.
JobPriority	Prioritäts-Enum.

Codebeispiel — Schnellstart

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Codebeispiel — Produktion

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

Randfälle & Fallstricke

• Serialisieren Sie mit toXml(); ist die Auftrags-ID leer, erzeugt sie einen eindeutigen Identifikator, statt zu scheitern.
• setCopies() lehnt eine Kopienanzahl unter 1 ab.
• Mediendimensionen sind in Millimetern; rechnen Sie von Punkten um, bevor Sie sie übergeben.
• Die Ausgabe ist ein Ticket-Dokument, kein gerenderter Druck-Stream.

Performance

Die Ticket-Erstellung ist konstant-zeitlich relativ zur Dokumentgröße; sie hängt nur von den konfigurierten Ressourcen ab.

Sicherheitshinweise

Der Builder gibt XML aus den von Ihnen gelieferten Werten aus. Bereinigen Sie extern bezogene Auftragsnamen und Identifikatoren, bevor Sie bauen.

Konformität

Verhalten	Referenz	Status
XJDF-2.1-Auftrags-Ticket-Struktur	XJDF 2.1 (CIP4)	Ausgerichtet (vereinfachte Teilmenge)

Verhaltensvertrag

• XjdfJobTicket ist ein Fluent-Builder für Auftrags-ID und -name, Priorität, Medien, Farbe, Finishing und Kopienanzahl, der zu einem vereinfachten XJDF-2.1-XML-Dokument über toXml() serialisiert. setCopies() lehnt eine Kopienanzahl unter 1 ab; eine leere Auftrags-ID wird automatisch erzeugt.
• MediaSpec trägt unveränderliche Medieneigenschaften (Typ, Breite/Höhe in Millimetern, Gewicht in g/m², Beschichtung, Farbe) und hat als Standardwert weißes A4-Papier.
• ColorSpec, FinishingSpec und JobPriority beschreiben Farbintention, Finishing-Operationen und Priorität.
• Das Modul erzeugt ausschließlich ein Ticket-Dokument. Es rendert keinen Druck-Stream und übermittelt das Ticket nicht an einen Druckmaschinen-Controller oder ein Gerät.

Hinweis zur Enterprise-Grenze

Enterprise ändert das Verhalten von Print Job nicht. Enterprise ergänzt höherstufige Funktionen, die separat dokumentiert sind; sie sind nicht erforderlich, um ein XJDF-Auftrags-Ticket zu erstellen.

Core-Fallback / Alternative

Es gibt kein Core-Äquivalent für die XJDF-2.1-Auftrags-Ticket-Erzeugung. Dies ist eine Pro-Ergänzung.

Veröffentlichungsgrenze

Diese Seite dokumentiert ausschließlich extern beobachtbares Verhalten und die unterstützte öffentliche API-Oberfläche. Interne Namespace-Pfade, Hilfsklassen, Mechanismus-Tabellen, Runbook-Dateinamen und Ticket-Präfixe sind nicht im Umfang enthalten.

Siehe auch

• Print Job — Deep Reference — vollständige API-Oberfläche für das Print-Job-Modul.
• Output Pipeline — Output-Staging.
• Document — Dokumentzusammenstellung.