Tác vụ in

Tổng quan nhanh

NextPDF Pro dựng các phiếu công việc XJDF (XML JDF 2.0) cho các quy trình in sản xuất: metadata công việc, đặc tả vật liệu, ý định màu, các thao tác hoàn thiện, mức ưu tiên, và số lượng bản sao.

Khả dụng & cấp phép

Khả năng này có trong NextPDF Pro (nextpdf/pro) và được kích hoạt bằng một phong bì giấy phép bậc Pro. Một triển khai không có quyền đó sẽ không nạp các lớp của khả năng này. Print Job không mang cờ giấy phép riêng theo từng tính năng. So sánh các phiên bản và lấy giấy phép.

Cài đặt

composer require nextpdf/pro:^3

Tổng quan khái niệm

Một hệ thống sản xuất in tiêu thụ một phiếu công việc mô tả cách tạo ra một công việc. NextPDF Pro phát ra một tài liệu XJDF 2.1 với một builder kiểu fluent:

• XjdfJobTicket — builder. Đặt ID và tên công việc, mức ưu tiên, vật liệu, màu, hoàn thiện, và số lượng bản sao, rồi tuần tự hóa thành một tài liệu XML XJDF 2.1.
• MediaSpec — các thuộc tính vật liệu bất biến: loại, chiều rộng và chiều cao tính bằng milimet, định lượng tính bằng g/m², lớp phủ, và màu. Mặc định là giấy trắng A4.
• ColorSpec, FinishingSpec, JobPriority — ý định màu, các thao tác hoàn thiện, và một enum mức ưu tiên.

XML được tạo ra theo cấu trúc XJDF 2.1 đã đơn giản hóa. Module tạo ra phiếu công việc; nó không gửi phiếu đó đến một bộ điều khiển máy in hay thiết bị.

Vì sao nó hoạt động theo cách này

Print Job dựng một phiếu và dừng ở đó. Nó không bao giờ gửi công việc hay kết xuất một print stream. Ranh giới đó là có chủ đích. Tài liệu XJDF là một mô tả ý định có tính di động — vật liệu, màu, hoàn thiện, mức ưu tiên, số bản sao — mà một bộ điều khiển máy in phía sau tiêu thụ và thực thi. Việc giữ module là một trình tuần tự hóa thuần túy cho phép một phiếu điều khiển cả một đợt sản xuất khối lượng lớn mà không ràng buộc mã của bạn vào một giao thức thiết bị. Các đối tượng đặc tả là bất biến, nên các đầu vào giống hệt nhau luôn cho ra cùng một phiếu, điều này giữ cho đầu ra theo lô có thể tái lập.

Bối cảnh thiết kế: Tạo tài liệu khối lượng lớn.

Bề mặt API

Lớp	Trách nhiệm
XjdfJobTicket	Builder phiếu công việc XJDF 2.1 kiểu fluent.
MediaSpec	Các thuộc tính vật lý của vật liệu.
ColorSpec	Ý định màu.
FinishingSpec	Các thao tác hoàn thiện.
JobPriority	Enum mức ưu tiên.

Mẫu mã — Bắt đầu nhanh

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

Mẫu mã — Sản phẩm

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

Trường hợp ngoại lệ & lưu ý

• Tuần tự hóa bằng toXml(); khi job ID rỗng, nó tạo một định danh duy nhất thay vì thất bại.
• setCopies() từ chối số bản sao dưới 1.
• Kích thước vật liệu tính bằng milimet; hãy chuyển đổi từ point trước khi truyền vào.
• Đầu ra là một tài liệu phiếu, không phải một print stream đã kết xuất.

Hiệu năng

Việc dựng phiếu có thời gian hằng số so với kích thước tài liệu; nó chỉ phụ thuộc vào các tài nguyên đã cấu hình.

Lưu ý bảo mật

Builder phát ra XML từ các giá trị bạn cung cấp. Hãy làm sạch tên công việc và định danh có nguồn từ bên ngoài trước khi dựng.

Tính phù hợp

Hành vi	Tham chiếu	Tình trạng
Cấu trúc phiếu công việc XJDF 2.1	XJDF 2.1 (CIP4)	Căn chỉnh (tập con đã đơn giản hóa)

Hợp đồng hành vi

• XjdfJobTicket là một builder kiểu fluent cho ID và tên công việc, mức ưu tiên, vật liệu, màu, hoàn thiện, và số lượng bản sao, tuần tự hóa thành một tài liệu XML XJDF 2.1 đã đơn giản hóa qua toXml(). setCopies() từ chối số bản sao dưới 1; một job ID rỗng được tự động tạo.
• MediaSpec mang theo các thuộc tính vật liệu bất biến (loại, chiều rộng/chiều cao tính bằng milimet, định lượng tính bằng g/m², lớp phủ, màu) và mặc định là giấy trắng A4.
• ColorSpec, FinishingSpec, và JobPriority mô tả ý định màu, các thao tác hoàn thiện, và mức ưu tiên.
• Module chỉ tạo ra một tài liệu phiếu. Nó không kết xuất một print stream hay gửi phiếu đến một bộ điều khiển máy in hay thiết bị.

Lưu ý ranh giới Enterprise

Enterprise không thay đổi hành vi của Print Job. Enterprise bổ sung các tính năng bậc cao hơn được ghi tài liệu riêng; chúng không cần thiết để dựng một phiếu công việc XJDF.

Phương án dự phòng / thay thế ở Core

Không có thành phần tương đương ở Core cho việc tạo phiếu công việc XJDF 2.1. Đây là một bổ sung của Pro.

Ranh giới xuất bản

Trang này chỉ mô tả hành vi quan sát được từ bên ngoài và bề mặt API công khai được hỗ trợ. Các đường dẫn namespace nội bộ, lớp trợ giúp, bảng cơ chế, tên tệp runbook, và tiền tố phiếu nằm ngoài phạm vi.

Xem thêm

• Print Job — Deep Reference — toàn bộ bề mặt API của module print-job.
• Output Pipeline — dàn dựng đầu ra.
• Document — lắp ráp tài liệu.