Pro phiên bản

Print Job — Tài liệu tham chiếu chuyên sâu

Tổng quan nhanh

XjdfJobTicket dựng một job ticket XJDF 2.1 (XML JDF 2.0) cho quy trình in sản xuất. Bộ dựng fluent ghi lại siêu dữ liệu job, media, ý định màu, các thao tác gia công sau in, độ ưu tiên và số bản. Sau đó toXml tuần tự hóa một tài liệu XML mang namespace CIP4. Module chỉ tạo ra ticket. Nó không gửi ticket tới một bộ điều khiển máy in hay thiết bị.

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

Khả năng này có trong NextPDF Pro (nextpdf/pro) và kích hoạt bằng một license envelope hạng Pro. Một triển khai không có quyền đó sẽ không nạp các class của khả năng này. So sánh các phiên bản và lấy giấy phép.

Không áp dụng cờ giấy phép theo từng tính năng. Đây là một khả năng của phiên bản Pro.

Bề mặt API công khai

composer require nextpdf/pro:^3

Điểm khởi đầu — bộ dựng fluent:

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

Đặc tả media — value object bất biến:

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

Ý định màu — value object bất biến:

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

Ý định gia công sau in — value object bất biến:

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

Độ ưu tiên — enum nền chuỗi:

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

    public function numericValue(): int;
}

Ký hiệu	Tham số	Hành vi mặc định	Trả về	Ném hoặc thất bại với	Ghi chú
`XjdfJobTicket::__construct`	không	Độ ưu tiên khởi tạo là `JobPriority::Normal`; số bản là 1.	instance	—	Gốc của bộ dựng fluent.
`XjdfJobTicket::setJobId`	`string $id`	Ghi lại định danh job.	`self`	—	Cho phép giá trị rỗng; xem `toXml`.
`XjdfJobTicket::setJobName`	`string $name`	Ghi lại tên job dạng đọc được.	`self`	—	Xuất ra dưới dạng `GeneralID` khi không rỗng.
`XjdfJobTicket::setPriority`	`JobPriority $priority`	Ghi đè độ ưu tiên mặc định `Normal`.	`self`	—	—
`XjdfJobTicket::setMedia`	`MediaSpec $media`	Gắn một tài nguyên media.	`self`	—	Tùy chọn; bỏ qua khi chưa đặt.
`XjdfJobTicket::setColor`	`ColorSpec $color`	Gắn một tài nguyên ý định màu.	`self`	—	Tùy chọn; bỏ qua khi chưa đặt.
`XjdfJobTicket::setFinishing`	`FinishingSpec $finishing`	Gắn các tài nguyên gia công sau in.	`self`	—	Tùy chọn; bỏ qua khi chưa đặt.
`XjdfJobTicket::setCopies`	`int $copies`	Đặt số bản đầu ra.	`self`	`InvalidArgumentException` khi `$copies < 1`	Mặc định là 1.
`XjdfJobTicket::toXml`	không	Tuần tự hóa tài liệu XJDF 2.1.	`string`	—	Sinh một job ID `XJDF_<hex>` ngẫu nhiên khi chưa đặt.
`MediaSpec::__construct`	`string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color`	Mặc định là giấy A4 trắng ở 80 g/m².	instance	—	Mọi tham số đều tùy chọn.
`MediaSpec::isStandard`	không	Khớp A4, US Letter hoặc A3 trong khoảng 0.5 mm.	`bool`	—	Dọc hoặc ngang.
`MediaSpec::toXjdfElement`	không	Xuất một phần tử `<Media>`; chuyển milimét sang point.	`string`	—	Bỏ qua coating và color ở giá trị mặc định của chúng.
`ColorSpec::__construct`	`bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent`	Mặc định là CMYK, ý định relative colorimetric.	instance	—	—
`ColorSpec::colorCount`	không	Trả về 4 cho CMYK cộng thêm một cho mỗi spot color.	`int`	—	—
`FinishingSpec::__construct`	`bool $fold, bool $staple, bool $punch, bool $trim, string $binding`	Mặc định không gia công; binding `None`.	instance	—	—
`JobPriority`	các case enum `Idle`, `Low`, `Normal`, `High`, `Rush`	—	enum	—	Nền chuỗi.
`JobPriority::numericValue`	không	Ánh xạ case sang 0, 25, 50, 75 hoặc 100.	`int`	—	Cao nhất là `Rush` (100).

Hợp đồng hành vi

XjdfJobTicket là một bộ dựng fluent. Mỗi setter trả về self để xâu chuỗi.
toXml tuần tự hóa một tài liệu XJDF 2.1 rút gọn dưới namespace CIP4 http://www.CIP4.org/JDFSchema_2_0, với Types="ConventionalPrinting".
Khi chưa đặt job ID, toXml thay bằng một định danh XJDF_ ngẫu nhiên thay vì thất bại.
Độ ưu tiên được ghi vừa dưới dạng Comment vừa dưới dạng thuộc tính số NodeInfo. Số bản được ghi dưới dạng lượng đầu ra Component.
Các tài nguyên media, màu và gia công sau in chỉ xuất hiện khi đặc tả của chúng đã được đặt.
Mọi giá trị thuộc tính đều được XML-escape trước khi tuần tự hóa.
Module tạo ra tài liệu ticket. Nó không kết xuất một luồng in hay gửi ticket tới một thiết bị.

Trường hợp biên & chế độ hỏng

setCopies với giá trị dưới 1 ném InvalidArgumentException. Đây là ngoại lệ duy nhất module phát sinh.
Một job ID rỗng hoặc chưa đặt không phải là lỗi. toXml thay bằng một định danh XJDF_<hex> ngẫu nhiên ở thời điểm tuần tự hóa.
Kích thước media tính theo milimét. toXjdfElement chuyển chúng sang point PDF bằng hệ số 72 / 25.4.
MediaSpec::isStandard áp dụng dung sai 0.5 mm và chấp nhận hướng dọc hoặc ngang.
MediaSpec::toXjdfElement bỏ qua FrontCoatings khi coating là None và MediaColorName khi color là White.
Module không thực hiện thao tác mã hóa nào. Chế độ FIPS không làm thay đổi hành vi của nó.

Tính phù hợp

NextPDF Pro xuất một tập con XJDF 2.1 rút gọn. Đây là sự căn chỉnh khả năng, không phải chứng nhận. NextPDF không có chứng nhận CIP4 nào.

Hành vi	Tham chiếu	Tình trạng
Cấu trúc job-ticket XJDF 2.1	XJDF 2.1 (CIP4)	Đã căn chỉnh — tập con rút gọn

Ghi chú phát triển

Gốc và namespace: một phần tử <XJDF> dưới http://www.CIP4.org/JDFSchema_2_0, với Types="ConventionalPrinting".
Bộ tuần tự hóa màu xuất NumColors và ColorsUsed. ColorSpec::renderingIntent được giữ lại trên value object nhưng không được ghi vào đầu ra rút gọn.
Gia công sau in ánh xạ các boolean sang thao tác XJDF: fold sang Folding, staple sang Stitching, punch sang HoleMaking, và trim sang Trimming. Một binding khác None xuất một BindingIntent.
Các giá trị được XML-escape, chứ không được kiểm định theo cách nào khác. Hãy làm sạch tên job và định danh có nguồn từ bên ngoài trước khi dựng.

Ranh giới công bố

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ộ, class trợ giúp, bảng cơ chế, tên tệp runbook và tiền tố ticket đều nằm ngoài phạm vi.