넥사크로 클립리포트 호출 가이드

넥사크로 화면에서 클립리포트로 작성한 .crf 출력물을 호출하는 방법을 정리한 문서입니다.^[1] 출력 방식은 화면 안에서 바로 출력하는 방식과 공통 출력 팝업을 호출하는 방식으로 나뉩니다.

빠른 선택 기준

방식	사용 상황	핵심 설정
화면 내 출력	현재 화면 안에서 출력물을 바로 보여줄 때	EzReport 컴포넌트의 filepath, param
팝업 출력	별도 출력 창에서 미리보기, 인쇄를 처리할 때	report_form.xfdl 호출 시 arg.filepath, arg.param

출력물 경로는 넥사크로 화면 경로처럼 업무명/업무상세/파일명 형식으로 관리합니다. 출력 전용 화면의 경우 넥사크로 파일명은 보통 r로 끝납니다.

예시:

HHJ/HHJ01/hhj_0101_r01.crf

---

1. 화면에서 바로 출력하기

화면에 EzReport 컴포넌트를 추가한 뒤, 컴포넌트에 출력물 경로와 파라미터를 설정하여 출력합니다.

// 공통 버튼 출력 함수
this.fn_print = function() {
	this.rpt_main.filepath = "WORK/HSE/HSE04/hse_0411_r01.crf";
	this.rpt_main.param = $f.mkArg({
		$div : this.div_search,
		TASK_DTL_CD : taskDtlCd,
	});
	this.rpt_main.open();
};

설정 항목	설명
filepath	출력할 .crf 파일 경로를 지정합니다.
param	출력물에 전달할 조회 조건과 파라미터를 지정합니다.
open()	설정한 출력물과 파라미터로 화면 안에서 출력을 실행합니다.

---

2. 출력 팝업으로 출력하기

공통 출력 팝업 화면을 호출하여 별도 팝업 창에서 출력물을 확인하는 방식입니다.

// 출력물 팝업을 띄우는 함수
this.fn_print = function() {
	const reportParam = $f.mkArg({
		CAMP_DVCD : $util.nvl(
			this.ds_main.getColumn(this.ds_main.rowposition, "CAMP_DVCD"),
			""
		),
		YY : $util.nvl(
			this.ds_main.getColumn(this.ds_main.rowposition, "YY"),
			""
		),
	});

	this.pop.popup({
		id : "fn_print",
		title : "출력물제목",
		url : "MODULE::REPORT/report_form.xfdl",
		arg : {
			filepath : "WORK/BUL/BUL04/bul_0401_r01.crf",
			param : reportParam,
		},
		width : 1000,
		height : 700,
	});
};

설정 항목	설명
id	팝업을 구분하는 ID입니다.
title	출력 팝업 상단에 표시할 제목입니다.
url	공통 출력 팝업 화면 경로입니다.[2]
arg.filepath	출력할 .crf 파일 경로입니다.
arg.param	출력물에 전달할 파라미터 문자열입니다.
width, height	출력 팝업의 가로, 세로 크기입니다.

---

정리

화면 내 출력 방식은 EzReport 컴포넌트를 직접 제어할 때 사용합니다. 팝업 출력 방식은 공통 출력 팝업인 report_form.xfdl을 호출할 때 사용합니다. 두 방식 모두 출력물 경로와 파라미터가 핵심이므로, 실제 출력 전 경로와 파라미터명을 먼저 확인하세요.

---

1. .crf는 클립리포트 디자이너에서 작성한 출력물 파일입니다. ↩︎

2. MODULE::REPORT/report_form.xfdl은 프로젝트에서 사용하는 공통 출력 팝업 화면 경로입니다. ↩︎

3. $f.mkArg(obj)는 객체를 KEY='VALUE' 형태의 출력 파라미터 문자열로 변환하는 공통 함수입니다. ↩︎