Tâche d'impression

En bref

NextPDF Pro construit des tickets de travail XJDF (XML JDF 2.0) pour les flux de production d’impression : métadonnées de travail, spécification de support, intention de couleur, opérations de finition, priorité et nombre de copies.

Disponibilité et licence

Cette capacité est livrée dans NextPDF Pro (nextpdf/pro) et s’active avec une enveloppe de licence de palier Pro. Un déploiement dépourvu de ce droit ne charge pas les classes de la capacité. Print Job ne comporte aucun indicateur de licence distinct par fonctionnalité. Comparer les éditions et obtenir une licence.

Installer

composer require nextpdf/pro:^3

Vue d’ensemble conceptuelle

Un système de production d’impression consomme un ticket de travail qui décrit comment produire un travail. NextPDF Pro émet un document XJDF 2.1 à l’aide d’un constructeur fluide :

• XjdfJobTicket — le constructeur. Définis l’identifiant et le nom du travail, la priorité, le support, la couleur, la finition et le nombre de copies, puis sérialise en un document XML XJDF 2.1.
• MediaSpec — propriétés de support immuables : type, largeur et hauteur en millimètres, poids en g/m², couchage et couleur. Par défaut, papier blanc A4.
• ColorSpec, FinishingSpec, JobPriority — intention de couleur, opérations de finition et une énumération de priorité.

Le XML généré suit la structure XJDF 2.1 simplifiée. Le module produit le ticket ; il ne le soumet pas à un contrôleur de presse ni à un périphérique.

Pourquoi ça fonctionne ainsi

Print Job construit un ticket et s’arrête là. Il ne soumet jamais le travail et ne rend jamais de flux d’impression. Cette frontière est délibérée. Le document XJDF est une description portable de l’intention — support, couleur, finition, priorité, copies — qu’un contrôleur de presse en aval consomme et exécute. Garder le module comme un pur sérialiseur permet à un seul ticket de piloter une production à fort volume sans coupler ton code à un protocole de périphérique. Les objets de spécification sont immuables, de sorte que des entrées identiques produisent toujours le même ticket, ce qui rend la sortie par lots reproductible.

Contexte de conception : Génération de documents à fort volume.

Surface d’API

Classe	Responsabilité
XjdfJobTicket	Constructeur fluide de ticket de travail XJDF 2.1.
MediaSpec	Propriétés physiques du support.
ColorSpec	Intention de couleur.
FinishingSpec	Opérations de finition.
JobPriority	Énumération de priorité.

Exemple de code — Démarrage rapide

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Exemple de code — Production

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

Cas limites et pièges

• Sérialise avec toXml() ; lorsque l’identifiant de travail est vide, il génère un identifiant unique au lieu d’échouer.
• setCopies() rejette un nombre de copies inférieur à 1.
• Les dimensions du support sont en millimètres ; convertis depuis les points avant de les passer.
• La sortie est un document de ticket, et non un flux d’impression rendu.

Performance

La construction du ticket est à temps constant par rapport à la taille du document ; elle ne dépend que des ressources configurées.

Notes de sécurité

Le constructeur émet du XML à partir des valeurs que tu fournis. Assainis les noms et identifiants de travail provenant de sources externes avant la construction.

Conformité

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

Contrat de comportement

• XjdfJobTicket est un constructeur fluide pour l’identifiant et le nom du travail, la priorité, le support, la couleur, la finition et le nombre de copies, sérialisant en un document XML XJDF 2.1 simplifié via toXml(). setCopies() rejette un nombre de copies inférieur à 1 ; un identifiant de travail vide est généré automatiquement.
• MediaSpec porte des propriétés de support immuables (type, largeur/hauteur en millimètres, poids en g/m², couchage, couleur) et adopte par défaut le papier blanc A4.
• ColorSpec, FinishingSpec et JobPriority décrivent l’intention de couleur, les opérations de finition et la priorité.
• Le module produit uniquement un document de ticket. Il ne rend pas de flux d’impression et ne soumet pas le ticket à un contrôleur de presse ni à un périphérique.

Note sur la frontière Enterprise

Enterprise ne change pas le comportement de Print Job. Enterprise ajoute des fonctionnalités de palier supérieur documentées séparément ; elles ne sont pas requises pour construire un ticket de travail XJDF.

Repli / alternative dans le Core

Il n’existe pas d’équivalent Core pour la génération de tickets de travail XJDF 2.1. C’est un ajout Pro.

Frontière 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 auxiliaires, les tables de mécanismes, les noms de fichiers de runbook et les préfixes de ticket sont hors périmètre.

Voir aussi

• Print Job — Référence approfondie — surface d’API complète du module print-job.
• Output Pipeline — préparation de la sortie.
• Document — assemblage de document.