기술문서
OZ Server
OZ Application
OZ Report

OZ Report
OZ Report
제목 : 리포트뷰어의 이벤트를 자바스크립트로 받는 방법(Command사용법)
오즈_LMK NOSPAM_mklee@forcs.com 13,230 hit 
http://www.oztn.net/kb/article/kbrpt/120488050730500 2008-03-07 10:48:41
211.116.251.***

 

* 개요

리포트 뷰어의 이벤트를 자바 스크립트로 받는 방법을 설명합니다.

 

* 상세 설명

리포트 뷰어에서 뷰어가 뜰 때, 프린트 할 때, 저장할 때와 같은 이벤트를 받아서 자바스크립트를 수행할 수 있습니다.

 

1. Command 종류

 Command 이름

설명

뷰어 패러미터

자바스크립트

 postcommand  오즈 뷰어 실행이 완료되었음을 사용자 프로그램에 전달하기 위한 이벤
트로 자바 스크립트 함수를 호출하며 자바 스크립트 함수로 전달할 명
령어와 메시지를 구분해서 설정합니다.		  <param name="viewer.postcommand" value="command;messages">  OZPostCommand(cmd, msg)
 progresscommand  뷰어에서 보고서 생성 작업 진행 과정 이벤트를 자바 스크립트 함수를
이용하여 사용자 프로그램에 알려줍니다.		  <param name="viewer.progresscommand" value="true">  OZProgressCommand(step, state,reportname)
 printcommand  오즈 뷰어에서 보고서를 인쇄한 후 인쇄 결과 이벤트를 자바 스크립트
함수를 이용하여 사용자 프로그램에 알려줍니다.		  <param name="viewer.printcommand" value="true">  OZPrintCommand(msg, code, reportname, printername,
printcopy, printedpage, printrange, username)
 exportcommand 오즈 뷰어에서 보고서를 파일로 저장한 후 실행 결과를 담은 이벤트를 자바
스크립트를 이용하여 사용자 프로그램에 전달합니다.		  <param name="viewer.exportcommand" value="true">  OZExportCommand(code, path, filename)
 errorcommand  오즈 뷰어에서 에러 발생 시 해당 에러 메시지 정보를 자바 스크립트를
이용하여 사용자 프로그램에 전달합니다.		  <param name="viewer.errorcommand" value="true">  OZErrorCommand(code, message, detailmessage)
 useractioncommand  보고서 파일을 열거나 인쇄, 저장 등 오즈 뷰어에서 발생하는 사용자의
조작 이벤트를  자바
스크립트를 이용하여 사용자 프로그램에 전달합니다.		  <param name="viewer.useractioncommand" value="true">  OZUserActionCommand(type, attr)
 exitcommand  StandAlone 형태(viewer.isframe=true)로 띄운 뷰어가 종료될 때 이벤트 발생  <param name="viewer.exitcommand" value="true">  OZExitCommand()

 

2. 사용 예

 

아래의 예에서 버전마다 classid와 Command 이벤트의 패러미터는 달라질 수 있습니다. 참고사항에 있는 메뉴얼에서 확인하셔야 합니다.

 

"보고서가 열릴 때 OnProgressCommand 이벤트로 확인하는 방법"

 

아래 HTML을 보면 script의 for문에 있는 이름과 뷰어 실행하는 object 태그의 id는 같은 이름이어야 합니다.

object 태그내에 사용할 이벤트의 패러미터를 true로 설정하셔야 합니다.

 

(report_progresscommand.html)

<HTML>
<HEAD>

<script language = "JavaScript" for="OZReportViewer" event="OZProgressCommand(step, state, reportname)">
/*
뷰어에서 보고서 생성 작업 진행 과정을 이벤트로 알려줍니다.

1. step : 보고서 생성 단계 (0 : 1단계, 1 : 2단계, 2 : 3단계, 3 : 4단계, 4 : 5단계)

1단계 : 뷰어 옵션 체크
2단계 : 보고서 폼 받기
3단계 : 보고서 템플릿 생성
4단계 : 데이타 모듈 받기
5단계 : 보고서 바인딩

2. state : 보고서 생성 상태(1 : 시작, 2 : 완료)

각 단계별로 시작과 완료 상태를 알려줍니다.

3. reportname 보고서 이름
*/
 if(step == 0 && state == 1) {
  alert("뷰어 시작");
 }
 if(step == 4 && state == 2) {
  alert("전체 페이지: " + document.OZReportViewer.GetInformation('TOTAL_PAGE'));
  alert("바인딩 완료됨");
 }
</script>
</HEAD>
<BODY scroll=no>
<OBJECT width = "0" height = "0" ID="ZTransferX" CLASSID="CLSID:C7C7225A-9476-47AC-B0B0-FF3B79D55E67" codebase="http://127.0.0.1:8080/OZServlet4.0/OZViewerActiveX40_20071010100/ZTransferX_2,1,1,6.cab#version=2,1,1,6">
<PARAM NAME="download.Server" VALUE="http://127.0.0.1/OZServlet4.0/OZViewerActiveX40_20071010100">
<PARAM NAME="download.Port" VALUE="8080">
<PARAM NAME="download.Instruction" VALUE="ozrviewer.idf">
<PARAM NAME="install.Base" VALUE="<PROGRAMS>/Forcs">
<PARAM NAME="install.Namespace" VALUE="test_ozviewer">
</OBJECT>
 
 
<OBJECT id = "OZReportViewer" CLASSID="CLSID:0DEF32F8-170F-46f8-B1FF-4BF7443F5F25" width="100%" height="100%">
<param name="connection.servlet" value="http://127.0.0.1:8080/OZServlet4.0/server">
<param name="connection.reportname" value="test.ozr">
<param name="viewer.isframe" value="false">
<param name="viewer.namespace" value="test_ozviewer\ozviewer">
<param name="information.debug" value="true">

<param name="viewer.progresscommand" value="true">   

</OBJECT>
</BODY>
</HTML>

 

"보고서 띄울 때 에러나면 뷰어를 안보이게하고 에러메시지 사용자가 만든 메시지로 나오게 하는 방법"

 

뷰어가 실행되고 나서 에러메시지는 모두 안나오게 하고 에러 발생시 호출되는 OZErrorCommand에서 에러 메시지를 별도 alert으로 띄우게 한후 뷰어 사이즈를 1,1로 줄여 실제로 화면상에는 안보이게 처리한 HTML입니다.
뷰어가 IE에 embed되는 경우에 사용하실 수 있습니다.

 

(ozviewer.js)

 function oz_activex_build(parent, tag, paramTag){
 var OZViewerObjectElement = document.createElement(tag);
 for(var i = 0 ; i < paramTag.length; i++){
  var OZViewerParamElement = document.createElement(paramTag[i]);
  OZViewerObjectElement.appendChild(OZViewerParamElement);
 }
 parent.appendChild(OZViewerObjectElement);
}

 

(report_errorcommand.html)

 <HTML>
<HEAD>
<script src="ozviewer.js"></script>

<!--호출되는 이벤트  -->
<script language="JavaScript"
 for="ozrviewer" event="OZErrorCommand(code, message, detailmessage)">
 
 // 예) 10102002,리포트 로더:  데이터를 가져오기 위해서 DB 접근시도 중 에러가 발생했습니다.,Fail to get a database connection. java.sql.SQLException: There is no key name.

 alert(code+","+ message+","+ detailmessage);
// ozrviewer.script('close'); // viewer.isframe=false일 때 IE 종료됨.
    ozrviewer.width=1;
    ozrviewer.height=1;
</script>

</HEAD>
<body leftmargin="0" topmargin="0" marginheight="0" marginwidth="0">

<div id="OZEmbedControlLocation">
<script LANGUAGE="Javascript">
var tag = '<OBJECT width = "0" height = "0" ID="ZTransferX" CLASSID="CLSID:C7C7225A-9476-47AC-B0B0-FF3B79D55E67" codebase="http://127.0.0.1:8080/OZServlet5.0/OZViewerActiveX50_20080111100/ZTransferX.cab"></OBJECT>';
var paramTag = new Array();
paramTag[paramTag.length] = '<PARAM NAME="download.Server" VALUE="http://127.0.0.1/OZServlet5.0/OZViewerActiveX50_20080111100">';
paramTag[paramTag.length] = '<PARAM NAME="download.Port" VALUE="8080">';
paramTag[paramTag.length] = '<PARAM NAME="download.Instruction" VALUE="ozrviewer.idf">';
paramTag[paramTag.length] = '<PARAM NAME="install.Base" VALUE="<PROGRAMS>/Forcs">';
paramTag[paramTag.length] = '<PARAM NAME="install.Namespace" VALUE="OZViewerActiveX50_20080111100">';
oz_activex_build(OZEmbedControlLocation, tag, paramTag);
</script>
</div>


<div id="OZEmbedControlLocation2">
<script LANGUAGE="Javascript">
var tag = '<OBJECT id = "ozrviewer" CLASSID="CLSID:0DEF32F8-170F-46f8-B1FF-4BF7443F5F25" width="100%" height="100%"></OBJECT>';
var paramTag = new Array();

paramTag[paramTag.length] = '<param name="connection.servlet" value="http://127.0.0.1:8080/OZServlet4.0/server">';
paramTag[paramTag.length] = '<param name="connection.reportname" value="Carinfo.ozr">';
paramTag[paramTag.length] = '<param name="viewer.namespace" value="OZViewerActiveX50_20080111100\\ozviewer">';
paramTag[paramTag.length] = '<param name="viewer.isframe" value="false">';
paramTag[paramTag.length] = '<param name="viewer.errorcommand" value="true">';
paramTag[paramTag.length] = '<param name="viewer.showerrormessage" value="false">';
paramTag[paramTag.length] = '<param name="viewer.useprogressbar" value="false">';
oz_activex_build(OZEmbedControlLocation2, tag, paramTag);
</script>
</div>

</BODY>
</HTML>


 

"UserActionCommand 이벤트가 발생할 때마다 내용을 텍스트박스에 보여주는 예제"

 

(report_useractioncommand.html)

<HTML>
<HEAD>

<script language = "JavaScript" for="OZReportViewer" event="OZUserActionCommand(type, attr)">
document.form1.textarea1.value = "type=" + type+ " >>> attr="+attr + "\n\n" + document.form1.textarea1.value ;
</script>

</HEAD>
<BODY>

<form name="form1">
<textarea name=textarea1 cols=120 rows=20>

</textarea>
</form>

<OBJECT width = "0" height = "0" ID="ZTransferX" CLASSID="CLSID:C7C7225A-9476-47AC-B0B0-FF3B79D55E67" codebase="http://127.0.0.1:8080/OZServlet4.0/OZViewerActiveX40_20071010100/ZTransferX_2,1,1,6.cab#version=2,1,1,6">
<PARAM NAME="download.Server" VALUE="http://127.0.0.1/OZServlet4.0/OZViewerActiveX40_20071010100">
<PARAM NAME="download.Port" VALUE="8080">
<PARAM NAME="download.Instruction" VALUE="ozrviewer.idf">
<PARAM NAME="install.Base" VALUE="<PROGRAMS>/Forcs">
<PARAM NAME="install.Namespace" VALUE="OZViewerActiveX40_20071010100">
</OBJECT>
 
 
<OBJECT id = "OZReportViewer" CLASSID="CLSID:0DEF32F8-170F-46f8-B1FF-4BF7443F5F25" width="100%" height="400">
<param name="connection.servlet" value="http://127.0.0.1:8080/OZServlet4.0/server">
<param name="connection.reportname" value="test.ozr">
<param name="viewer.isframe" value="false">
<param name="viewer.namespace" value="OZViewerActiveX40_20071010100\ozviewer">
<param name="information.debug" value="true">

<param name="viewer.useractioncommand" value="true">   
</OBJECT>

</BODY>
</HTML>

 

"기타 예제"

 

(report_command.html)

<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=euc-kr">
</head>
<body>

<!------------------------------------------------------
테스트 버전 : 오즈뷰어 40
-------------------------------------------------------->

<!-- 뷰어프로그래스바가 뜨면서 호출되는 이벤트 -->
<script language = "JavaScript" for="OZReportViewer" event="OZProgressCommand(step, state)">

 today = new Date();
 h = today.getHours();
 m = today.getMinutes();
 s = today.getSeconds();
 ms = today.getMilliseconds();

 var str = "";
 if (step == 0) {
  if(state == 1)
  str += "<OZProgressCommand>\n";
  str += "뷰어 옵션 체크 시작\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
  if(state == 2)       
  str += "뷰어 옵션 체크 종료\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
 }
 else if (step == 1) {
  if(state == 1)
  str += "보고서 폼 받기 시작\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
  if(state == 2)       
  str += "보고서 폼 받기 종료\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
 }
 else if (step == 2) {
  if(state == 1)
  str += "보고서 템플릿 생성 시작\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
  if(state == 2)       
  str += "보고서 템플릿 생성 종료\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
 }
 else if (step == 3) {
  if(state == 1)
  str += "데이타 모듈 받기 시작\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
  if(state == 2)       
  str += "데이타 모듈 받기 종료\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
 }
 else if (step == 4) {
  if(state == 1)
  str += "보고서 바인딩 시작\t\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
  if(state == 2) {
  str += "보고서 바인딩 종료\t\t" + h +"시 " + m + "분 " + s + "초 " + ms + "msec \n";
  str += "바인딩된 페이지 수=" +  OZReportViewer.GetInformation("TOTAL_PAGE") + "\n";
  }
 }

 form1.textarea1.value += str + "\n\n";

</script>

 

<!-- 오즈뷰어가 뜬 이후에 호출되는 이벤트. viewer.postcommand 파라미터 값이 cmd;msg로 넘어옴 -->
<script language= "JavaScript" for="OZReportViewer" event="OZPostCommand(cmd, msg)">   
 var str = "";
 str += "\n<OZPostCommand>\n";
 if(cmd=="test")
 str += "pass\n";
 else
 str += msg + "\n";
 form1.textarea1.value += str + "\n\n";
</script>

 

<!-- 프린트 이후 호출되는 이벤트  -->
<script language="JavaScript"
 for="OZReportViewer" event="OZPrintCommand(msg, code, reportname, printername, printcopy, printpages, printrange, username)">
var str = "";
str += "\n<OZPrintCommand>\n";
str += "msg="+msg+ "\n";
str += "code="+code+ "\n"; // code=="1" 출력실패, code=="0" 출력성공
str += "reportname="+reportname+ "\n";
str += "printername="+printername+ "\n";
str += "printcopy="+printcopy+ "\n";
str += "printpages="+printpages+ "\n";
str += "printrange="+printrange+ "\n";
str += "username="+username+ "\n";
 form1.textarea1.value += str + "\n\n";
</script>

 

<!-- Export이후 호출되는 이벤트 -->
<script language="JavaScript"  for="OZReportViewer" event="OZExportCommand(code,path,filename)">
var str = "";
str += "\n<OZExportCommand>\n";
str += "path="+path+ "\n";
str += "filename="+filename+ "\n";
 if(code=="1") // Export 성공
 str += "성공"+ "\n";
 if(code=="0") // Export 실패
 str += "실패"+ "\n";
 form1.textarea1.value += str + "\n\n";
</script>

<script language = "JavaScript" for="OZReportViewer" event="OZUserActionCommand(type, attr)">
 var str = "";
 str += "\n<OZUserActionCommand>\n";
 str += "type=" + type+ " >>> attr="+attr;
 form1.textarea1.value += str + "\n\n";
</script>

<form name="form1">
<textarea name=textarea1 cols=120 rows=20></textarea>
<input type="button" value="삭제" onClick="form1.textarea1.value=''">
</form>

<OBJECT id = "OZReportViewer" CLASSID="CLSID:0DEF32F8-170F-46f8-B1FF-4BF7443F5F25" width="900" height="600">
 <param name="connection.servlet" value="http://127.0.0.1:8080/OZServlet4.0/server">
 <param name="connection.reportname" value="가로.ozr">
 <param name="viewer.configmode" value="html">
 <param name="viewer.isframe" value="false">
 <param name="viewer.mode" value="preview">
 <!--param name="viewer.namespace" value="forcs_testviewer\ozviewer"-->
 
 <!--Progress Command-->
 <param name="viewer.progresscommand" value="true">
 <!--Post Command-->
 <param name="viewer.postcommand" value="test;pass">
 <!--Print Command-->
 <param name="viewer.printcommand" value="true"> 
 <!--Export Command-->
 <param name="viewer.exportcommand" value="true">
 <!--UserAction Command-->
 <!--param name="viewer.useractioncommand" value="true"-->
</OBJECT>

</body>
</html>


* 참고 사항

command에 대한 자세한 사항은 사용하는 버전에 해당하는 "OZ Report Viewer User's Guide.pdf" 메뉴얼을 참고하세요.

 

 
키워드 : 뷰어태그 자바스크립트 커맨드
 
OZ 버젼 : 3.1
OZ 제품 : Report Viewer
 
번호 구분 제목 글쓴이 일자 조회
95 문제해결 Windows11 24H2 Update 후 OZ Report 에러 조치 방안 오즈_LMK 2025-02-24 306
94 기술정보 [OZ EXE뷰어] 뷰어 패러미터 호출 예 Tag 1 오즈_LMK 2022-09-20 3,647
93 기술정보 [OZ HTML5뷰어] 뷰어 패러미터 호출 예 Tag 1 오즈_LMK 2022-09-20 4,094
92 문제해결 디자이너 실행시 윈도우 화면 범위를 벗어나서 안보이는 경우 오즈_LMK 2022-08-01 592
91 문제해결 '카테고리 주소'와 'ODI 이름'을 잘못 입력한 경우 에러 Tag 2 오즈_LMK 2022-07-06 1,723
90 기술정보 오즈서버 정식라이선스 요청시 REQUEST-URI 확인 방법 Tag 1 오즈_LMK 2022-05-26 1,166
89 기술정보 DB연결 방법 - 오즈 서버 Tag 1 오즈_LMK 2022-05-26 1,876
88 기술정보 DB연결 방법 - 쿼리디자이너, 리포트디자이너(jdbc드라이버 설정 등) Tag 1 오즈_LMK 2022-05-25 2,491
87 기술정보 [OZ HTML5뷰어] 멀티보고서 호출 예제 Tag 2 오즈_LMK 2021-02-16 5,400
86 문제해결 디자이너 실행 시 Loading JVM failed 오류 발생되며 닷넷으로 실행될 때 조치 방법 Tag 2 오즈_CSH 2020-02-27 1,873
85 기술정보 Chrome 77버전으로 업데이트 후 OZHtml5 뷰어 인쇄창이 뜨지 않을 때 조치 방법 오즈_CSH 2019-09-19 3,114
84 문제해결 exe뷰어(custom uri 방식)에서 구분자를 ^로 주면 보고서 출력이 안되는 현상 Tag 2 오즈_LMK 2019-05-30 1,718
83 문제해결 리포트 디자이너가 느린 현상이 발생하면 최신 패치로 해결됩니다. 오즈_LMK 2019-05-13 2,230
82 기술정보 OZ ActiveX 뷰어 - 52버전부터 Firefox 브라우저 지원 중단 오즈_CSH 2017-03-28 3,307
81 기술정보 OZ Applet 뷰어 - 52버전부터 Firefox 브라우저 지원 중단 오즈_CSH 2017-03-28 2,110
80 문제해결 2015년 12월부터 발생한 크롬, 오페라 브라우저에서 Flash/HTML5뷰어 인쇄 장애 건 대부분 해결 오즈_CSH 2016-03-16 4,095
79 문제해결 Flash Player(21,0,0,182버전) Windows 8/10 IE에서 인쇄 축소 문제가 해결 오즈_CSH 2016-03-11 2,893
78 기술정보 인터넷 익스플로러에서 OZ ActiveX 뷰어 호출 방법 오즈_CSH 2016-03-11 5,560
77 기술정보 [6.0] 표시형식으로 월, 요일, 오전, 오후를 영문으로 표기하는 방법 오즈_CSH 2016-02-29 2,817
76 문제해결 Flash Player(20.0.0.306 버전) Windows 8/10 IE에서 인쇄 축소 오즈_CSH 2016-02-24 3,053
 | 1 | 2 | 3 | 4 | 5 |  
copyright 2007-2025 by FORCS OZ