Print Job — 심층 참조

한눈에 보기

XjdfJobTicket은 프로덕션 인쇄 워크플로를 위한 XJDF 2.1(XML JDF 2.0) 작업 티켓을 구성합니다. 플루언트 빌더는 작업 메타데이터, 미디어, 색상 의도, 후가공(finishing) 작업, 우선순위, 매수를 기록합니다. 이어서 toXml이 CIP4 네임스페이스 XML 문서를 직렬화합니다. 이 모듈은 티켓만 생성합니다. 티켓을 프레스 컨트롤러나 디바이스에 제출하지는 않습니다.

가용성 및 라이선스

이 기능은 NextPDF Pro(nextpdf/pro)에 포함되며 Pro 등급 라이선스 엔벌로프로 활성화됩니다. 해당 권한이 없는 배포에서는 이 기능의 클래스가 로드되지 않습니다. 에디션 비교 및 라이선스 받기.

기능별 라이선스 플래그는 적용되지 않습니다. 이것은 Pro 에디션 기능입니다.

공개 API 표면

composer require nextpdf/pro:^3

진입점 — 플루언트 빌더:

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

미디어 사양 — 불변 값 객체:

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

색상 의도 — 불변 값 객체:

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

후가공 의도 — 불변 값 객체:

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

우선순위 — 문자열 기반 enum:

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

    public function numericValue(): int;
}

심볼	매개변수	기본 동작	반환	예외 또는 실패	비고
XjdfJobTicket::__construct	없음	우선순위를 JobPriority::Normal로, 매수를 1로 초기화합니다.	인스턴스	—	플루언트 빌더 루트.
XjdfJobTicket::setJobId	string $id	작업 식별자를 기록합니다.	self	—	빈 값도 허용됩니다. toXml 참조.
XjdfJobTicket::setJobName	string $name	사람이 읽을 수 있는 작업 이름을 기록합니다.	self	—	비어 있지 않으면 GeneralID로 방출됩니다.
XjdfJobTicket::setPriority	JobPriority $priority	기본 Normal 우선순위를 재정의합니다.	self	—	—
XjdfJobTicket::setMedia	MediaSpec $media	미디어 리소스를 첨부합니다.	self	—	선택 사항이며, 미설정 시 생략됩니다.
XjdfJobTicket::setColor	ColorSpec $color	색상 의도 리소스를 첨부합니다.	self	—	선택 사항이며, 미설정 시 생략됩니다.
XjdfJobTicket::setFinishing	FinishingSpec $finishing	후가공 리소스를 첨부합니다.	self	—	선택 사항이며, 미설정 시 생략됩니다.
XjdfJobTicket::setCopies	int $copies	출력 매수를 설정합니다.	self	$copies < 1일 때 InvalidArgumentException	기본값은 1입니다.
XjdfJobTicket::toXml	없음	XJDF 2.1 문서를 직렬화합니다.	string	—	설정된 값이 없으면 무작위 XJDF_<hex> 작업 ID를 생성합니다.
MediaSpec::__construct	string $mediaType, float $widthMm, float $heightMm, int $weight, string $coating, string $color	기본값은 80 g/m²의 A4 백색 용지입니다.	인스턴스	—	모든 매개변수가 선택 사항입니다.
MediaSpec::isStandard	없음	A4, US Letter, A3를 0.5 mm 이내로 매칭합니다.	bool	—	세로 또는 가로 방향.
MediaSpec::toXjdfElement	없음	<Media> 요소를 방출하며 밀리미터를 포인트로 변환합니다.	string	—	기본값인 코팅과 색상은 생략합니다.
ColorSpec::__construct	bool $useCmyk, bool $useSpotColors, list<string> $spotColorNames, string $renderingIntent	기본값은 CMYK, 상대 색도 의도입니다.	인스턴스	—	—
ColorSpec::colorCount	없음	CMYK에 대해 4를, 스팟 색상마다 1을 더해 반환합니다.	int	—	—
FinishingSpec::__construct	bool $fold, bool $staple, bool $punch, bool $trim, string $binding	기본값은 후가공 없음, 제본 None입니다.	인스턴스	—	—
JobPriority	enum 케이스 Idle, Low, Normal, High, Rush	—	enum	—	문자열 기반.
JobPriority::numericValue	없음	케이스를 0, 25, 50, 75, 100으로 매핑합니다.	int	—	최고값은 Rush(100)입니다.

동작 계약

• XjdfJobTicket은 플루언트 빌더입니다. 각 세터는 체이닝을 위해 self를 반환합니다.
• toXml은 CIP4 네임스페이스 http://www.CIP4.org/JDFSchema_2_0 하에서 Types="ConventionalPrinting"인 단순화된 XJDF 2.1 문서를 직렬화합니다.
• 작업 ID가 설정되지 않은 경우, toXml은 실패하는 대신 무작위 XJDF_ 식별자로 대체합니다.
• 우선순위는 Comment와 숫자형 NodeInfo 속성 양쪽으로 기록됩니다. 매수는 Component 출력 수량으로 기록됩니다.
• 미디어, 색상, 후가공 리소스는 해당 사양이 설정된 경우에만 나타납니다.
• 모든 속성 값은 직렬화 전에 XML 이스케이프 처리됩니다.
• 이 모듈은 티켓 문서를 생성합니다. 인쇄 스트림을 렌더링하거나 티켓을 디바이스에 제출하지는 않습니다.

엣지 케이스 및 실패 모드

• 1보다 작은 값으로 setCopies를 호출하면 InvalidArgumentException을 던집니다. 이것이 이 모듈이 발생시키는 유일한 예외입니다.
• 비어 있거나 설정되지 않은 작업 ID는 오류가 아닙니다. toXml은 직렬화 시점에 무작위 XJDF_<hex> 식별자로 대체합니다.
• 미디어 치수는 밀리미터 단위입니다. toXjdfElement은 계수 72 / 25.4를 사용하여 이를 PDF 포인트로 변환합니다.
• MediaSpec::isStandard는 0.5 mm 허용 오차를 적용하며 세로 또는 가로 방향을 허용합니다.
• MediaSpec::toXjdfElement은 코팅이 None일 때 FrontCoatings를, 색상이 White일 때 MediaColorName을 생략합니다.
• 이 모듈은 암호 연산을 수행하지 않습니다. FIPS 모드는 동작을 변경하지 않습니다.

적합성

NextPDF Pro는 단순화된 XJDF 2.1 부분집합을 방출합니다. 이것은 기능 정렬이며 인증이 아닙니다. NextPDF는 CIP4 인증을 보유하지 않습니다.

동작	참조	상태
XJDF 2.1 작업 티켓 구조	XJDF 2.1 (CIP4)	부합 — 단순화된 부분집합

개발 참고 사항

• 루트 및 네임스페이스: http://www.CIP4.org/JDFSchema_2_0 하의 <XJDF> 요소이며 Types="ConventionalPrinting"입니다.
• 색상 직렬화기는 NumColors와 ColorsUsed를 방출합니다. ColorSpec::renderingIntent는 값 객체에 보존되지만 단순화된 출력에는 기록되지 않습니다.
• 후가공은 불리언을 XJDF 작업으로 매핑합니다: fold는 Folding, staple은 Stitching, punch는 HoleMaking, trim은 Trimming으로. None이 아닌 binding은 BindingIntent를 방출합니다.
• 값은 XML 이스케이프되며 그 외의 검증은 하지 않습니다. 외부에서 유입된 작업 이름과 식별자는 빌드 전에 정제(sanitize)하십시오.

발행 범위

이 페이지는 외부에서 관측 가능한 동작과 지원되는 공개 API 표면만 문서화합니다. 내부 네임스페이스 경로, 헬퍼 클래스, 메커니즘 테이블, 런북 파일명, 티켓 접두사는 범위 밖입니다.

함께 보기

• Print Job — 기능 개요
• Output Pipeline — 심층 참조