Pro édition

Print Job — Référence détaillée

En un coup d’œil

XjdfJobTicket construit un ticket de travail XJDF 2.1 (XML JDF 2.0) pour les flux d’impression de production. Le générateur fluide enregistre les métadonnées du travail, le support, l’intention colorimétrique, les opérations de finition, la priorité et le nombre de copies. toXml sérialise ensuite un document XML dans l’espace de noms CIP4. Le module produit uniquement un ticket. Il ne soumet pas le ticket à un contrôleur de presse ou à un périphérique.

Disponibilité et licence

Cette capacité est fournie dans NextPDF Pro (nextpdf/pro) et s’active avec une enveloppe de licence de niveau Pro. Un déploiement dépourvu de cette autorisation ne charge pas les classes de la capacité. Comparer les éditions et obtenir une licence.

Aucun indicateur de licence par fonctionnalité ne s’applique. Il s’agit d’une capacité de l’édition Pro.

Surface d’API publique

composer require nextpdf/pro:^3

Point d’entrée — le générateur fluide :

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

Spécification du support — objet-valeur immuable :

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

Intention colorimétrique — objet-valeur immuable :

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

Intention de finition — objet-valeur immuable :

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é — énumération basée sur une chaîne :

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

    public function numericValue(): int;
}

Symbole	Paramètres	Comportement par défaut	Retour	Lève ou échoue avec	Notes
`XjdfJobTicket::__construct`	aucun	Priorité initialisée à `JobPriority::Normal` ; copies à 1.	instance	—	Racine du générateur fluide.
`XjdfJobTicket::setJobId`	`string $id`	Enregistre l’identifiant du travail.	`self`	—	La valeur vide est autorisée ; voir `toXml`.
`XjdfJobTicket::setJobName`	`string $name`	Enregistre le nom lisible du travail.	`self`	—	Émis en tant que `GeneralID` lorsqu’il est non vide.
`XjdfJobTicket::setPriority`	`JobPriority $priority`	Remplace la priorité `Normal` par défaut.	`self`	—	—
`XjdfJobTicket::setMedia`	`MediaSpec $media`	Rattache une ressource de support.	`self`	—	Facultatif ; omis lorsqu’il n’est pas défini.
`XjdfJobTicket::setColor`	`ColorSpec $color`	Rattache une ressource d’intention colorimétrique.	`self`	—	Facultatif ; omis lorsqu’il n’est pas défini.
`XjdfJobTicket::setFinishing`	`FinishingSpec $finishing`	Rattache les ressources de finition.	`self`	—	Facultatif ; omis lorsqu’il n’est pas défini.
`XjdfJobTicket::setCopies`	`int $copies`	Définit le nombre de copies en sortie.	`self`	`InvalidArgumentException` lorsque `$copies < 1`	La valeur par défaut est 1.
`XjdfJobTicket::toXml`	aucun	Sérialise le document XJDF 2.1.	`string`	—	Génère un identifiant de travail `XJDF_<hex>` aléatoire si aucun n’a été défini.
`MediaSpec::__construct`	`string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color`	Par défaut : papier blanc A4 à 80 g/m².	instance	—	Tous les paramètres sont facultatifs.
`MediaSpec::isStandard`	aucun	Correspond à A4, US Letter ou A3 à 0,5 mm près.	`bool`	—	Portrait ou paysage.
`MediaSpec::toXjdfElement`	aucun	Émet un élément `<Media>` ; convertit les millimètres en points.	`string`	—	Omet le couchage et la couleur à leurs valeurs par défaut.
`ColorSpec::__construct`	`bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent`	Par défaut : CMJN, intention colorimétrique relative.	instance	—	—
`ColorSpec::colorCount`	aucun	Retourne 4 pour CMJN plus une par couleur d’accompagnement.	`int`	—	—
`FinishingSpec::__construct`	`bool $fold, bool $staple, bool $punch, bool $trim, string $binding`	Par défaut : aucune finition ; reliure `None`.	instance	—	—
`JobPriority`	cas d’énumération `Idle`, `Low`, `Normal`, `High`, `Rush`	—	énumération	—	Basée sur une chaîne.
`JobPriority::numericValue`	aucun	Mappe le cas sur 0, 25, 50, 75 ou 100.	`int`	—	La plus élevée est `Rush` (100).

Contrat de comportement

XjdfJobTicket est un générateur fluide. Chaque mutateur retourne self pour le chaînage.
toXml sérialise un document XJDF 2.1 simplifié sous l’espace de noms CIP4 http://www.CIP4.org/JDFSchema_2_0, avec Types="ConventionalPrinting".
Lorsqu’aucun identifiant de travail n’a été défini, toXml substitue un identifiant XJDF_ aléatoire plutôt que d’échouer.
La priorité est écrite à la fois comme un Comment et comme un attribut numérique NodeInfo. Les copies sont écrites comme une quantité de sortie Component.
Les ressources de support, de couleur et de finition n’apparaissent que lorsque leurs spécifications ont été définies.
Toutes les valeurs d’attribut sont échappées en XML avant la sérialisation.
Le module produit le document du ticket. Il ne restitue pas de flux d’impression et ne soumet pas le ticket à un périphérique.

Cas limites et modes de défaillance

setCopies avec une valeur inférieure à 1 lève InvalidArgumentException. C’est la seule exception que le module lève.
Un identifiant de travail vide ou non défini n’est pas une erreur. toXml substitue un identifiant XJDF_<hex> aléatoire au moment de la sérialisation.
Les dimensions du support sont exprimées en millimètres. toXjdfElement les convertit en points PDF à l’aide du facteur 72 / 25.4.
MediaSpec::isStandard applique une tolérance de 0,5 mm et accepte l’orientation portrait ou paysage.
MediaSpec::toXjdfElement omet FrontCoatings lorsque le couchage est None et MediaColorName lorsque la couleur est White.
Le module n’effectue aucune opération cryptographique. Le mode FIPS ne modifie pas son comportement.

Conformité

NextPDF Pro émet un sous-ensemble XJDF 2.1 simplifié. Il s’agit d’un alignement de capacité, pas d’une certification. NextPDF ne détient aucune certification CIP4.

Comportement	Référence	Statut
Structure de ticket de travail XJDF 2.1	XJDF 2.1 (CIP4)	Aligné — sous-ensemble simplifié

Notes de développement

Racine et espace de noms : un élément <XJDF> sous http://www.CIP4.org/JDFSchema_2_0, avec Types="ConventionalPrinting".
Le sérialiseur de couleur émet NumColors et ColorsUsed. ColorSpec::renderingIntent est conservé sur l’objet-valeur mais n’est pas écrit dans la sortie simplifiée.
La finition mappe les booléens sur les opérations XJDF : fold vers Folding, staple vers Stitching, punch vers HoleMaking et trim vers Trimming. Une reliure non-None émet un BindingIntent.
Les valeurs sont échappées en XML, sans autre validation. Assainis les noms de travaux et les identifiants d’origine externe avant la construction.

Limite de publication

Cette page documente uniquement le comportement observable de l’extérieur et la surface d’API publique prise en charge. Les chemins d’espace de noms internes, les classes utilitaires, les tables de mécanismes, les noms de fichiers de runbook et les préfixes de tickets sont hors périmètre.