기술문서
OZ Server
OZ Application
OZ Report
Google
웹    forcs.com
오즈 리포트
오즈 이폼

OZ Report
OZ Report
제목 : 리포트뷰어의 이벤트를 자바스크립트로 받는 방법(Command사용법)
오즈_LMK NOSPAM_mklee@forcs.com 12,929 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
 
번호 구분 제목 글쓴이 일자 조회
54 기술정보 비스타에서 권한에 따른 보고서 인쇄, 저장 방법 Tag 1 오즈_LMK 2008-05-09 5,012
53 문제해결 뷰어 설치나 실행이 안될 때 확인하는 방법 Tag 1 오즈_LMK 2008-05-07 10,561
52 기술정보 대용량 보고서 호출을 위한 뷰어 패러미터 설정 방법 Tag 2 오즈_LMK 2008-04-11 9,439
51 기술정보 보고서를 미리보기 없이 바로 파일로 저장하는 방법 Tag 1 오즈_LMK 2008-03-31 14,333
50 기술정보 보고서를 미리보기 없이 바로 인쇄하는 방법 Tag 1 오즈_LMK 2008-03-31 10,154
49 기술정보 Windows Vista 호환성 문제 개선 Tag 1 오즈_LMK 2008-03-25 3,414
기술정보 리포트뷰어의 이벤트를 자바스크립트로 받는 방법(Command사용법) Tag 3 오즈_LMK 2008-03-07 12,930
47 기술정보 OZ Report Applet Viewer가 제대로 동작되지 않을 때 문제 해결 방안 Tag 2 오즈_YSM 2007-11-12 6,527
46 기술정보 오즈 리포트 디버깅 방법 Tag 1 오즈_LMK 2007-12-04 6,058
45 기술정보 오즈보고서와 Fax연동 오즈_LMK 2007-11-16 983
44 기술정보 OZ Report 패러미터 종류 Tag 2 오즈_LMK 2007-11-09 23,998
43 기술정보 오즈 뷰어 공통 옵션 설정 파일로 분리하기 오즈_PJH 2007-11-06 1,420
42 기술정보 유니코드 데이터 인식하는 방법 오즈_KJJ 2007-11-01 1,921
41 기술정보 비스타 지원하는 뷰어인지 확인하는 방법 Tag 1 오즈_LMK 2007-11-05 1,834
40 문제해결 ZTransferX와 뷰어 패치할 때 재설치 안되는 경우 Tag 1 오즈_LMK 2007-10-31 2,467
39 기술정보 배포마법사 이용한 보고서 호출 HTML 생성하기 Tag 1 오즈_JJH 2007-10-19 1,788
38 문제해결 OZ Report Viewer 2.5 설치 장애 FAQ 오즈_LMK 2007-10-17 764
37 기술정보 멀티 보고서 호출하는 방법 Tag 1 오즈_LMK 2007-10-16 18,847
36 기술정보 IE버전에 따른 리포트 뷰어 호출 방법 Tag 2 오즈_LMK 2007-10-15 7,376
35 문제해결 "바인딩한 페이지가 존재하지 않습니다" 메시지 오즈_LMK 2007-10-15 2,832
 | 1 | 2 | 3 | 4 | 5 |  
copyright 2007-2024 by FORCS OZ