Print Job

Visão geral

O NextPDF Pro monta tickets de job XJDF (XML JDF 2.0) para fluxos de trabalho de impressão de produção: metadados do job, especificação de mídia, intenção de cor, operações de acabamento, prioridade e contagem de cópias.

Disponibilidade e licenciamento

Este recurso é fornecido no NextPDF Pro (nextpdf/pro) e é ativado com um envelope de licença de nível Pro. Uma implantação sem esse direito não carrega as classes do recurso. O Print Job não carrega um sinalizador de licença por recurso separado. Compare as edições e obtenha uma licença.

Instalação

composer require nextpdf/pro:^3

Visão conceitual

Um sistema de produção de impressão consome um ticket de job que descreve como produzir um job. O NextPDF Pro emite um documento XJDF 2.1 com um builder fluente:

• XjdfJobTicket — o builder. Defina o ID e o nome do job, a prioridade, a mídia, a cor, o acabamento e a contagem de cópias e, em seguida, serialize para um documento XML XJDF 2.1.
• MediaSpec — propriedades de mídia imutáveis: tipo, largura e altura em milímetros, gramatura em g/m², revestimento e cor. O padrão é papel branco A4.
• ColorSpec, FinishingSpec, JobPriority — intenção de cor, operações de acabamento e um enum de prioridade.

O XML gerado segue a estrutura simplificada do XJDF 2.1. O módulo produz o ticket; ele não o submete a um controlador de impressão ou dispositivo.

Por que funciona assim

O Print Job monta um ticket e para por aí. Ele nunca submete o job nem renderiza um fluxo de impressão. Esse limite é deliberado. O documento XJDF é uma descrição portátil da intenção — mídia, cor, acabamento, prioridade, cópias — que um controlador de impressão downstream consome e executa. Manter o módulo como um serializador puro permite que um único ticket conduza uma tiragem de produção de alto volume sem acoplar seu código a um protocolo de dispositivo. Os objetos de especificação são imutáveis, então entradas idênticas sempre produzem o mesmo ticket, o que mantém a saída em lote reproduzível.

Contexto de design: Geração de documentos em alto volume.

Superfície da API

Classe	Responsabilidade
XjdfJobTicket	Builder fluente de ticket de job XJDF 2.1.
MediaSpec	Propriedades físicas da mídia.
ColorSpec	Intenção de cor.
FinishingSpec	Operações de acabamento.
JobPriority	Enum de prioridade.

Exemplo de código — Início rápido

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Exemplo de código — Produção

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 extremos e armadilhas

• Serialize com toXml(); quando o ID do job está vazio, ele gera um identificador único em vez de falhar.
• setCopies() rejeita uma contagem de cópias abaixo de 1.
• As dimensões da mídia são em milímetros; converta de pontos antes de passá-las.
• A saída é um documento de ticket, não um fluxo de impressão renderizado.

Desempenho

A construção do ticket tem tempo constante em relação ao tamanho do documento; ela depende apenas dos recursos configurados.

Notas de segurança

O builder emite XML a partir dos valores que você fornece. Sanitize nomes e identificadores de job de origem externa antes de montar.

Conformidade

Comportamento	Referência	Status
Estrutura de ticket de job XJDF 2.1	XJDF 2.1 (CIP4)	Alinhado (subconjunto simplificado)

Contrato de comportamento

• XjdfJobTicket é um builder fluente para o ID e o nome do job, a prioridade, a mídia, a cor, o acabamento e a contagem de cópias, serializando para um documento XML XJDF 2.1 simplificado via toXml(). setCopies() rejeita uma contagem de cópias abaixo de 1; um ID de job vazio é gerado automaticamente.
• MediaSpec carrega propriedades de mídia imutáveis (tipo, largura/altura em milímetros, gramatura em g/m², revestimento, cor) e tem como padrão papel branco A4.
• ColorSpec, FinishingSpec e JobPriority descrevem a intenção de cor, as operações de acabamento e a prioridade.
• O módulo produz apenas um documento de ticket. Ele não renderiza um fluxo de impressão nem submete o ticket a um controlador de impressão ou dispositivo.

Nota sobre o limite do Enterprise

O Enterprise não altera o comportamento do Print Job. O Enterprise acrescenta recursos de nível superior documentados separadamente; eles não são necessários para montar um ticket de job XJDF.

Fallback / alternativa do Core

Não há equivalente no Core para a geração de tickets de job XJDF 2.1. Esta é uma adição do Pro.

Limite de publicação

Esta página documenta apenas o comportamento observável externamente e a superfície pública de API suportada. Caminhos de namespace internos, classes auxiliares, tabelas de mecanismo, nomes de arquivo de runbook e prefixos de ticket estão fora de escopo.

Veja também

• Print Job — Referência Profunda — superfície de API completa do módulo print-job.
• Output Pipeline — preparação da saída.
• Document — montagem de documentos.