인쇄 작업

한눈에 보기

NextPDF Pro는 프로덕션 인쇄 워크플로를 위한 XJDF(XML JDF 2.0) 작업 티켓을 빌드합니다. 작업 메타데이터, 미디어 사양, 색상 의도, 마무리 작업, 우선순위, 부수를 담습니다.

가용성 및 라이선싱

이 기능은 NextPDF Pro(nextpdf/pro)에 포함되며 Pro 계층 라이선스 엔벨로프로 활성화됩니다. 해당 자격이 없는 배포에서는 이 기능의 클래스가 로드되지 않습니다. Print Job에는 별도의 기능별 라이선스 플래그가 없습니다. 에디션 비교 및 라이선스 받기.

설치

composer require nextpdf/pro:^3

개념 개요

인쇄 프로덕션 시스템은 작업을 어떻게 생산할지 설명하는 작업 티켓을 소비합니다. NextPDF Pro는 플루언트 빌더로 XJDF 2.1 문서를 방출합니다.

• XjdfJobTicket — 빌더입니다. 작업 ID와 이름, 우선순위, 미디어, 색상, 마무리, 부수를 설정한 뒤 XJDF 2.1 XML 문서로 직렬화합니다.
• MediaSpec — 불변 미디어 속성입니다. 유형, 밀리미터 단위 너비와 높이, g/m² 단위 무게, 코팅, 색상을 담으며 기본값은 A4 흰색 용지입니다.
• ColorSpec, FinishingSpec, JobPriority — 색상 의도, 마무리 작업, 우선순위 enum입니다.

생성된 XML은 단순화된 XJDF 2.1 구조를 따릅니다. 이 모듈은 티켓을 생성할 뿐, 이를 프레스 컨트롤러나 기기에 제출하지는 않습니다.

이렇게 동작하는 이유

Print Job은 티켓을 빌드하고 거기서 멈춥니다. 작업을 제출하거나 인쇄 스트림을 렌더링하지 않습니다. 그 경계는 의도적입니다. XJDF 문서는 의도(미디어, 색상, 마무리, 우선순위, 부수)를 담은 이식 가능한 설명이며, 하류의 프레스 컨트롤러가 이를 소비하고 실행합니다. 모듈을 순수 직렬 변환기로 유지하면 코드를 기기 프로토콜에 결합하지 않고도 하나의 티켓으로 대량 프로덕션 실행을 구동할 수 있습니다. 사양 객체는 불변이므로 동일한 입력은 항상 동일한 티켓을 산출하고, 이는 배치 출력의 재현성을 유지합니다.

설계 배경: 대량 문서 생성.

API 표면

클래스	책임
XjdfJobTicket	플루언트 XJDF 2.1 작업 티켓 빌더.
MediaSpec	미디어 물리적 속성.
ColorSpec	색상 의도.
FinishingSpec	마무리 작업.
JobPriority	우선순위 enum.

코드 샘플 — 빠른 시작

use NextPDF\Pro\PrintJob\XjdfJobTicket;

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

코드 샘플 — 프로덕션

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

엣지 케이스 및 함정

• toXml()로 직렬화합니다. 작업 ID가 비어 있으면 실패하는 대신 고유 식별자를 생성합니다.
• setCopies()는 1 미만의 부수를 거부합니다.
• 미디어 치수는 밀리미터입니다. 전달하기 전에 포인트에서 변환하십시오.
• 출력은 렌더링된 인쇄 스트림이 아니라 티켓 문서입니다.

성능

티켓 생성은 문서 크기에 대해 상수 시간이며, 구성된 리소스에만 의존합니다.

보안 참고

빌더는 제공한 값으로부터 XML을 방출합니다. 빌드하기 전에 외부에서 가져온 작업 이름과 식별자를 정화(sanitize)하십시오.

적합성

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

동작 계약

• XjdfJobTicket은 작업 ID와 이름, 우선순위, 미디어, 색상, 마무리, 부수를 위한 플루언트 빌더이며, toXml()을 통해 단순화된 XJDF 2.1 XML 문서로 직렬화합니다. setCopies()는 1 미만의 부수를 거부하고, 비어 있는 작업 ID는 자동 생성됩니다.
• MediaSpec은 불변 미디어 속성(유형, 밀리미터 단위 너비/높이, g/m² 단위 무게, 코팅, 색상)을 담으며 기본값은 A4 흰색 용지입니다.
• ColorSpec, FinishingSpec, JobPriority는 색상 의도, 마무리 작업, 우선순위를 설명합니다.
• 이 모듈은 티켓 문서만 생성합니다. 인쇄 스트림을 렌더링하거나 티켓을 프레스 컨트롤러나 기기에 제출하지 않습니다.

Enterprise 경계 참고

Enterprise는 Print Job 동작을 변경하지 않습니다. Enterprise는 별도로 문서화된 상위 계층의 기능을 추가하지만, 이는 XJDF 작업 티켓을 빌드하는 데 필요하지 않습니다.

Core 폴백 / 대안

XJDF 2.1 작업 티켓 생성에 해당하는 Core 등가물은 없습니다. 이것은 Pro 추가 기능입니다.

게시 경계

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

함께 보기

• Print Job — 심층 레퍼런스 — 인쇄 작업 모듈의 전체 API 표면.
• Output Pipeline — 출력 스테이징.
• Document — 문서 조립.