Zadanie drukowania

W skrócie

NextPDF Pro buduje zlecenia druku XJDF (XML JDF 2.0) na potrzeby produkcyjnych procesów drukowania: metadane zlecenia, specyfikację nośnika, intencję kolorystyczną, operacje wykończeniowe, priorytet oraz liczbę kopii.

Dostępność i licencjonowanie

Ta funkcja jest dostarczana w NextPDF Pro (nextpdf/pro) i aktywuje się wraz z kopertą licencyjną w warstwie Pro. Wdrożenie bez tego uprawnienia nie ładuje klas tej funkcji. Print Job nie posiada osobnej flagi licencyjnej dla poszczególnych funkcji. Porównaj edycje i uzyskaj licencję.

Instalacja

composer require nextpdf/pro:^3

Przegląd koncepcyjny

System produkcji drukarskiej konsumuje zlecenie druku, które opisuje sposób wytworzenia zadania. NextPDF Pro emituje dokument XJDF 2.1 za pomocą płynnego buildera:

• XjdfJobTicket — builder. Ustaw identyfikator i nazwę zadania, priorytet, nośnik, kolor, wykończenie oraz liczbę kopii, a następnie zserializuj do dokumentu XML XJDF 2.1.
• MediaSpec — niezmienne właściwości nośnika: typ, szerokość i wysokość w milimetrach, gramatura w g/m², powlekanie oraz kolor. Domyślnie biały papier A4.
• ColorSpec, FinishingSpec, JobPriority — intencja kolorystyczna, operacje wykończeniowe oraz enum priorytetu.

Wygenerowany XML jest zgodny z uproszczoną strukturą XJDF 2.1. Moduł tworzy zlecenie; nie przekazuje go do kontrolera maszyny drukarskiej ani urządzenia.

Dlaczego działa to w ten sposób

Print Job buduje zlecenie i na tym się zatrzymuje. Nigdy nie przekazuje zadania ani nie renderuje strumienia druku. Ta granica jest celowa. Dokument XJDF to przenośny opis intencji — nośnik, kolor, wykończenie, priorytet, kopie — który konsumuje i wykonuje docelowy kontroler maszyny drukarskiej. Utrzymanie modułu jako czystego serializatora pozwala, aby jedno zlecenie napędzało wysokonakładową produkcję bez wiązania Twojego kodu z protokołem urządzenia. Obiekty specyfikacji są niezmienne, więc identyczne dane wejściowe zawsze dają to samo zlecenie, co utrzymuje powtarzalność wyjścia wsadowego.

Tło projektowe: Wysokonakładowe generowanie dokumentów.

Powierzchnia API

Klasa	Odpowiedzialność
XjdfJobTicket	Płynny builder zlecenia druku XJDF 2.1.
MediaSpec	Fizyczne właściwości nośnika.
ColorSpec	Intencja kolorystyczna.
FinishingSpec	Operacje wykończeniowe.
JobPriority	Enum priorytetu.

Przykład kodu — Szybki start

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Przykład kodu — Produkcja

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

Przypadki brzegowe i pułapki

• Serializuj za pomocą toXml(); gdy identyfikator zadania jest pusty, generuje unikalny identyfikator zamiast zgłaszać błąd.
• setCopies() odrzuca liczbę kopii poniżej 1.
• Wymiary nośnika są w milimetrach; przelicz z punktów przed ich przekazaniem.
• Wynikiem jest dokument zlecenia, a nie wyrenderowany strumień druku.

Wydajność

Konstruowanie zlecenia działa w czasie stałym względem rozmiaru dokumentu; zależy wyłącznie od skonfigurowanych zasobów.

Uwagi dotyczące bezpieczeństwa

Builder emituje XML z podanych przez Ciebie wartości. Oczyszczaj zewnętrznie pochodzące nazwy zadań i identyfikatory przed zbudowaniem.

Konformancja

Zachowanie	Odniesienie	Status
Struktura zlecenia druku XJDF 2.1	XJDF 2.1 (CIP4)	Zgodne (uproszczony podzbiór)

Kontrakt zachowania

• XjdfJobTicket to płynny builder identyfikatora i nazwy zadania, priorytetu, nośnika, koloru, wykończenia oraz liczby kopii, serializujący do uproszczonego dokumentu XML XJDF 2.1 przez toXml(). setCopies() odrzuca liczbę kopii poniżej 1; pusty identyfikator zadania jest generowany automatycznie.
• MediaSpec niesie niezmienne właściwości nośnika (typ, szerokość/wysokość w milimetrach, gramaturę w g/m², powlekanie, kolor) i domyślnie przyjmuje biały papier A4.
• ColorSpec, FinishingSpec oraz JobPriority opisują intencję kolorystyczną, operacje wykończeniowe oraz priorytet.
• Moduł tworzy wyłącznie dokument zlecenia. Nie renderuje strumienia druku ani nie przekazuje zlecenia do kontrolera maszyny drukarskiej ani urządzenia.

Uwaga o granicy Enterprise

Enterprise nie zmienia zachowania Print Job. Enterprise dodaje funkcje wyższej warstwy udokumentowane osobno; nie są one wymagane do zbudowania zlecenia druku XJDF.

Rozwiązanie awaryjne / alternatywa Core

Nie ma odpowiednika Core dla generowania zleceń druku XJDF 2.1. Jest to dodatek Pro.

Granica publikacji

Ta strona dokumentuje wyłącznie zewnętrznie obserwowalne zachowanie oraz obsługiwaną publiczną powierzchnię API. Wewnętrzne ścieżki przestrzeni nazw, klasy pomocnicze, tabele mechanizmów, nazwy plików runbooków oraz prefiksy zleceń są poza zakresem.

Zobacz też

• Print Job — Pełna dokumentacja — pełna powierzchnia API modułu print-job.
• Output Pipeline — etapowanie wyjścia.
• Document — składanie dokumentu.