Print Job

In sintesi

NextPDF Pro costruisce ticket di processo XJDF (XML JDF 2.0) per i flussi di lavoro di stampa di produzione: metadati del processo, specifica del supporto, intento cromatico, operazioni di finitura, priorità e numero di copie.

Disponibilità e licenza

Questa funzionalità è inclusa in NextPDF Pro (nextpdf/pro) e si attiva con un envelope di licenza di livello Pro. Un deployment privo di tale entitlement non carica le classi della funzionalità. Print Job non prevede un flag di licenza separato per singola funzionalità. Confronta le edizioni e ottieni una licenza.

Installazione

composer require nextpdf/pro:^3

Panoramica concettuale

Un sistema di stampa di produzione consuma un ticket di processo che descrive come produrre un lavoro. NextPDF Pro emette un documento XJDF 2.1 con un builder fluente:

• XjdfJobTicket — il builder. Si impostano l’ID e il nome del processo, la priorità, il supporto, il colore, la finitura e il numero di copie, quindi si serializza in un documento XML XJDF 2.1.
• MediaSpec — proprietà immutabili del supporto: tipo, larghezza e altezza in millimetri, grammatura in g/m², patinatura e colore. Per impostazione predefinita corrisponde a carta bianca A4.
• ColorSpec, FinishingSpec, JobPriority — intento cromatico, operazioni di finitura e un enum di priorità.

L’XML generato segue la struttura XJDF 2.1 semplificata. Il modulo produce il ticket; non lo invia a un controller di stampa o a un dispositivo.

Perché funziona così

Print Job costruisce un ticket e si ferma lì. Non invia mai il processo né renderizza uno stream di stampa. Quel confine è deliberato. Il documento XJDF è una descrizione portabile dell’intento — supporto, colore, finitura, priorità, copie — che un controller di stampa a valle consuma ed esegue. Mantenere il modulo un puro serializzatore permette a un singolo ticket di guidare una tiratura di produzione ad alto volume senza accoppiare il codice a un protocollo di dispositivo. Gli oggetti di specifica sono immutabili, quindi input identici producono sempre lo stesso ticket, il che mantiene riproducibile l’output in batch.

Contesto di progettazione: Generazione di documenti ad alto volume.

Superficie API

Classe	Responsabilità
XjdfJobTicket	Builder fluente di ticket di processo XJDF 2.1.
MediaSpec	Proprietà fisiche del supporto.
ColorSpec	Intento cromatico.
FinishingSpec	Operazioni di finitura.
JobPriority	Enum di priorità.

Esempio di codice — Avvio rapido

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Esempio di codice — Produzione

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

Casi limite e insidie

• Serializzare con toXml(); quando l’ID del processo è vuoto, genera un identificatore univoco anziché fallire.
• setCopies() rifiuta un numero di copie inferiore a 1.
• Le dimensioni del supporto sono in millimetri; convertirle dai punti prima di passarle.
• L’output è un documento ticket, non uno stream di stampa renderizzato.

Prestazioni

La costruzione del ticket è a tempo costante rispetto alla dimensione del documento; dipende soltanto dalle risorse configurate.

Note sulla sicurezza

Il builder emette XML a partire dai valori forniti. Sanificare i nomi e gli identificatori di processo di origine esterna prima della costruzione.

Conformità

Comportamento	Riferimento	Stato
Struttura del ticket di processo XJDF 2.1	XJDF 2.1 (CIP4)	Allineato (sottoinsieme semplificato)

Contratto di comportamento

• XjdfJobTicket è un builder fluente per ID e nome del processo, priorità, supporto, colore, finitura e numero di copie, che serializza in un documento XML XJDF 2.1 semplificato tramite toXml(). setCopies() rifiuta un numero di copie inferiore a 1; un ID di processo vuoto viene generato automaticamente.
• MediaSpec porta con sé proprietà immutabili del supporto (tipo, larghezza/altezza in millimetri, grammatura in g/m², patinatura, colore) e per impostazione predefinita corrisponde a carta bianca A4.
• ColorSpec, FinishingSpec e JobPriority descrivono l’intento cromatico, le operazioni di finitura e la priorità.
• Il modulo produce esclusivamente un documento ticket. Non renderizza uno stream di stampa né invia il ticket a un controller di stampa o a un dispositivo.

Nota sul confine Enterprise

Enterprise non modifica il comportamento di Print Job. Enterprise aggiunge funzionalità di tier superiore documentate separatamente; non sono richieste per costruire un ticket di processo XJDF.

Fallback / alternativa di Core

Non esiste un equivalente in Core per la generazione di ticket di processo XJDF 2.1. Questa è un’aggiunta di Pro.

Confine di pubblicazione

Questa pagina documenta esclusivamente il comportamento osservabile dall’esterno e la superficie API pubblica supportata. Percorsi di namespace interni, classi helper, tabelle di meccanismo, nomi di file di runbook e prefissi di ticket sono fuori ambito.

Vedere anche

• Print Job — Riferimento approfondito — superficie API completa per il modulo print-job.
• Output Pipeline — staging dell’output.
• Document — assemblaggio del documento.