Print Job

De un vistazo

NextPDF Pro genera tickets de trabajo XJDF (XML JDF 2.0) para flujos de trabajo de impresión de producción: metadatos del trabajo, especificación de soporte, intención de color, operaciones de acabado, prioridad y número de copias.

Disponibilidad y licencia

Esta capacidad se incluye en NextPDF Pro (nextpdf/pro) y se activa con un sobre de licencia de nivel Pro. Un despliegue sin ese derecho no carga las clases de la capacidad. Print Job no lleva ningún indicador de licencia por función independiente. Comparar ediciones y obtener una licencia.

Instalación

composer require nextpdf/pro:^3

Panorama conceptual

Un sistema de impresión de producción consume un ticket de trabajo que describe cómo producir un trabajo. NextPDF Pro emite un documento XJDF 2.1 con un generador fluido:

• XjdfJobTicket — el generador. Establece el ID y el nombre del trabajo, la prioridad, el soporte, el color, el acabado y el número de copias, y luego serializa a un documento XML XJDF 2.1.
• MediaSpec — propiedades inmutables del soporte: tipo, anchura y altura en milímetros, peso en g/m², revestimiento y color. El valor predeterminado es papel blanco A4.
• ColorSpec, FinishingSpec, JobPriority — intención de color, operaciones de acabado y una enumeración de prioridad.

El XML generado sigue la estructura XJDF 2.1 simplificada. El módulo produce el ticket; no lo envía a un controlador de prensa ni a un dispositivo.

Por qué funciona así

Print Job genera un ticket y ahí se detiene. Nunca envía el trabajo ni renderiza un flujo de impresión. Ese límite es deliberado. El documento XJDF es una descripción portátil de la intención —soporte, color, acabado, prioridad, copias— que un controlador de prensa posterior consume y ejecuta. Mantener el módulo como un serializador puro permite que un único ticket impulse una tirada de producción de gran volumen sin acoplar tu código a un protocolo de dispositivo. Los objetos de especificación son inmutables, por lo que entradas idénticas siempre producen el mismo ticket, lo que mantiene la salida por lotes reproducible.

Antecedentes de diseño: Generación de documentos de gran volumen.

Superficie de API

Clase	Responsabilidad
XjdfJobTicket	Generador fluido de tickets de trabajo XJDF 2.1.
MediaSpec	Propiedades físicas del soporte.
ColorSpec	Intención de color.
FinishingSpec	Operaciones de acabado.
JobPriority	Enumeración de prioridad.

Ejemplo de código — Inicio rápido

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Ejemplo de código — Producción

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

Casos límite y trampas

• Serializa con toXml(); cuando el ID del trabajo está vacío, genera un identificador único en lugar de fallar.
• setCopies() rechaza un número de copias inferior a 1.
• Las dimensiones del soporte están en milímetros; conviértelas desde puntos antes de pasarlas.
• La salida es un documento de ticket, no un flujo de impresión renderizado.

Rendimiento

La construcción del ticket es de tiempo constante en relación con el tamaño del documento; depende únicamente de los recursos configurados.

Notas de seguridad

El generador emite XML a partir de los valores que suministras. Sanea los nombres e identificadores de trabajo de origen externo antes de construir.

Conformidad

Comportamiento	Referencia	Estado
Estructura de ticket de trabajo XJDF 2.1	XJDF 2.1 (CIP4)	Alineado (subconjunto simplificado)

Contrato de comportamiento

• XjdfJobTicket es un generador fluido para el ID y el nombre del trabajo, la prioridad, el soporte, el color, el acabado y el número de copias, que serializa a un documento XML XJDF 2.1 simplificado mediante toXml(). setCopies() rechaza un número de copias inferior a 1; un ID de trabajo vacío se genera automáticamente.
• MediaSpec lleva propiedades inmutables del soporte (tipo, anchura/altura en milímetros, peso en g/m², revestimiento, color) y su valor predeterminado es papel blanco A4.
• ColorSpec, FinishingSpec y JobPriority describen la intención de color, las operaciones de acabado y la prioridad.
• El módulo produce únicamente un documento de ticket. No renderiza un flujo de impresión ni envía el ticket a un controlador de prensa o dispositivo.

Nota sobre el límite de Enterprise

Enterprise no cambia el comportamiento de Print Job. Enterprise añade funciones de nivel superior documentadas por separado; no son necesarias para construir un ticket de trabajo XJDF.

Alternativa / opción de respaldo en Core

No existe un equivalente en Core para la generación de tickets de trabajo XJDF 2.1. Es una adición de Pro.

Límite de publicación

Esta página documenta únicamente el comportamiento observable externamente y la superficie pública de API compatible. Las rutas de espacios de nombres internos, las clases auxiliares, las tablas de mecanismos, los nombres de archivos de runbook y los prefijos de ticket quedan fuera del alcance.

Consulta también

• Print Job — Referencia profunda — superficie completa de API del módulo print-job.
• Output Pipeline — preparación de la salida.
• Document — ensamblaje de documentos.