Pro edición

Print Job — Referencia detallada

De un vistazo

XjdfJobTicket construye un ticket de trabajo XJDF 2.1 (XML JDF 2.0) para flujos de impresión de producción. El constructor fluido registra los metadatos del trabajo, el material, la intención de color, las operaciones de acabado, la prioridad y el número de copias. toXml serializa entonces un documento XML con espacio de nombres CIP4. El módulo solo produce un ticket. No envía el ticket a un controlador de prensa ni a un dispositivo.

Disponibilidad y licencias

Esta capacidad se incluye en NextPDF Pro (nextpdf/pro) y se activa con un sobre de licencia de nivel Pro. Un despliegue sin esa titularidad no carga las clases de la capacidad. Comparar ediciones y obtener una licencia.

No se aplica ningún indicador de licencia por función. Es una capacidad de la edición Pro.

Superficie pública de la API

composer require nextpdf/pro:^3

Punto de entrada: el constructor fluido:

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

Especificación del material: objeto de valor inmutable:

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

Intención de color: objeto de valor inmutable:

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

Intención de acabado: objeto de valor inmutable:

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',
    );
}

Prioridad: enumeración respaldada por cadena:

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

    public function numericValue(): int;
}

Símbolo	Parámetros	Comportamiento por defecto	Devuelve	Lanza o falla con	Notas
`XjdfJobTicket::__construct`	ninguno	Prioridad inicializada a `JobPriority::Normal`; copias a 1.	instancia	—	Raíz del constructor fluido.
`XjdfJobTicket::setJobId`	`string $id`	Registra el identificador del trabajo.	`self`	—	Se permite un valor vacío; véase `toXml`.
`XjdfJobTicket::setJobName`	`string $name`	Registra el nombre legible del trabajo.	`self`	—	Se emite como `GeneralID` cuando no está vacío.
`XjdfJobTicket::setPriority`	`JobPriority $priority`	Sustituye la prioridad `Normal` por defecto.	`self`	—	—
`XjdfJobTicket::setMedia`	`MediaSpec $media`	Adjunta un recurso de material.	`self`	—	Opcional; se omite cuando no se establece.
`XjdfJobTicket::setColor`	`ColorSpec $color`	Adjunta un recurso de intención de color.	`self`	—	Opcional; se omite cuando no se establece.
`XjdfJobTicket::setFinishing`	`FinishingSpec $finishing`	Adjunta recursos de acabado.	`self`	—	Opcional; se omite cuando no se establece.
`XjdfJobTicket::setCopies`	`int $copies`	Establece el número de copias de salida.	`self`	`InvalidArgumentException` cuando `$copies < 1`	El valor por defecto es 1.
`XjdfJobTicket::toXml`	ninguno	Serializa el documento XJDF 2.1.	`string`	—	Genera un ID de trabajo `XJDF_<hex>` aleatorio cuando no se ha establecido ninguno.
`MediaSpec::__construct`	`string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color`	Por defecto, papel blanco A4 a 80 g/m².	instancia	—	Todos los parámetros son opcionales.
`MediaSpec::isStandard`	ninguno	Coincide con A4, US Letter o A3 dentro de 0,5 mm.	`bool`	—	Vertical u horizontal.
`MediaSpec::toXjdfElement`	ninguno	Emite un elemento `<Media>`; convierte milímetros a puntos.	`string`	—	Omite el recubrimiento y el color en sus valores por defecto.
`ColorSpec::__construct`	`bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent`	Por defecto, CMYK, intención colorimétrica relativa.	instancia	—	—
`ColorSpec::colorCount`	ninguno	Devuelve 4 para CMYK más uno por cada color directo.	`int`	—	—
`FinishingSpec::__construct`	`bool $fold, bool $staple, bool $punch, bool $trim, string $binding`	Por defecto, sin acabado; encuadernación `None`.	instancia	—	—
`JobPriority`	casos de enumeración `Idle`, `Low`, `Normal`, `High`, `Rush`	—	enum	—	Respaldada por cadena.
`JobPriority::numericValue`	ninguno	Asigna el caso a 0, 25, 50, 75 o 100.	`int`	—	El más alto es `Rush` (100).

Contrato de comportamiento

XjdfJobTicket es un constructor fluido. Cada método de asignación devuelve self para el encadenamiento.
toXml serializa un documento XJDF 2.1 simplificado bajo el espacio de nombres CIP4 http://www.CIP4.org/JDFSchema_2_0, con Types="ConventionalPrinting".
Cuando no se ha establecido ningún ID de trabajo, toXml sustituye un identificador XJDF_ aleatorio en lugar de fallar.
La prioridad se escribe tanto como un atributo Comment como un atributo numérico NodeInfo. Las copias se escriben como una cantidad de salida Component.
Los recursos de material, color y acabado aparecen solo cuando se han establecido sus especificaciones.
Todos los valores de atributo se escapan como XML antes de la serialización.
El módulo produce el documento del ticket. No renderiza un flujo de impresión ni envía el ticket a un dispositivo.

Casos límite y modos de fallo

setCopies con un valor inferior a 1 lanza InvalidArgumentException. Es la única excepción que genera el módulo.
Un ID de trabajo vacío o sin establecer no es un error. toXml sustituye un identificador XJDF_<hex> aleatorio en el momento de la serialización.
Las dimensiones del material están en milímetros. toXjdfElement las convierte a puntos PDF usando el factor 72 / 25,4.
MediaSpec::isStandard aplica una tolerancia de 0,5 mm y acepta orientación vertical u horizontal.
MediaSpec::toXjdfElement omite FrontCoatings cuando el recubrimiento es None y MediaColorName cuando el color es White.
El módulo no realiza operaciones criptográficas. El modo FIPS no cambia su comportamiento.

Conformidad

NextPDF Pro emite un subconjunto simplificado de XJDF 2.1. Esto es una alineación de capacidad, no una certificación. NextPDF no posee ninguna certificación CIP4.

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

Notas de desarrollo

Raíz y espacio de nombres: un elemento <XJDF> bajo http://www.CIP4.org/JDFSchema_2_0, con Types="ConventionalPrinting".
El serializador de color emite NumColors y ColorsUsed. ColorSpec::renderingIntent se conserva en el objeto de valor, pero no se escribe en la salida simplificada.
El acabado asigna valores booleanos a operaciones XJDF: plegado a Folding, grapado a Stitching, perforado a HoleMaking y recorte a Trimming. Una encuadernación distinta de None emite un BindingIntent.
Los valores se escapan como XML, pero no se validan de otro modo. Sanee los nombres e identificadores de trabajo de origen externo antes de construir.

Límite de publicación

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