* 개요
Application툴인 MiPlatform에서 OZ ReportViewer를 추가하여 보고서를 보여주는 방법을 설명합니다.
* 상세 설명
1. OZ Viewer 설치
웹브라우저로 아래 html을 호출하여 ZTransferX.cab을 통해서 필요한 모듈을 설치합니다.
(ozinstall.html)
|
<OBJECT width = "0" height = "0" ID="ZTransferX"
CLASSID="CLSID:C7C7225A-9476-47AC-B0B0-FF3B79D55E67"
codebase="http://localhost:8081/ypk/ozrviewer/ZTransferX.cab#version=2,0,1,7">
<PARAM NAME="download.Server" VALUE="http://localhost/ypk/ozrviewer/">'
<PARAM NAME="download.Port" VALUE="8081">
<PARAM NAME="download.Instruction" VALUE="ozrviewer.idf">
<PARAM NAME="install.Base" VALUE="<PROGRAMS>/Forcs">
<PARAM NAME="install.Namespace" VALUE="ypk">
</OBJECT> |
뷰어 경로는 해당 사이트에 맞게 조절하셔야 합니다.
위의 태그를 실행하면 아래 3가지 작업이 수행됩니다.
1. 로컬 pc에 ZTransferX.cab 설치
2. ZTransferX가 로컬pc의 install.Base, install.Namespace위치에 뷰어를 다운받음
예) c:\program files\forcs\oz family\ypk\
3. ZTransferX가 다운받은 뷰어를 설치함 (레지스트리 등록됨)
뷰어 태그에 대한 자세한 설명은 “http://oztn.net/kb/article/kbrpt/119131496150307”을 참고하세요.
2. MiPlatform에서 오즈 뷰어 추가
MiPlatform의 PID 툴을 실행한 후 오즈 뷰어를 띄울 Form으로 이동합니다.
상단 Tools 메뉴의 Project Manager에서 URL옆의 + 기호를 클릭하세요.
Active X Controls 탭에서 EXOZViewer30 Control을 선택하고 Insert - OK 버튼을 클릭하세요.
오즈뷰어 버전이 5.0인 경우에는 EXOZViewer50 Control을 선택하면 됩니다.
툴바의 EXOZViewer30 아이콘을 클릭하여 Form에 뷰어를 추가합니다.
3. 보고서 호출
아래와 같이 뷰어에 전달할 패러미터를 설정한 str 변수를 위의 2번에서 추가한 EXOZViewer30 의 CreateReport 함수로
전달합니다. CreateReport 함수는 패러미터 정보로 보고서를 뷰어에 보여주는 함수입니다.
function OZ()
{
var str;
str = "";
str = str + "viewer.namespace=뷰어이름\\ozviewer\n";
str = str + "connection.servlet=http://127.0.0.1:8080/oz/server\n";
str = str + "connection.reportname=보고서이름.ozr\n";
EXOZViewer30.CreateReport(str);
} |
* createReport의 네임스페이스 설정
참고로, 뷰어가 실행된 후 createReport로 뷰어에 보고서를 보여주는 경우에는
어떤 뷰어로 보여줄지 지정하는 viewer.namespace 패러미터 기능이 지원되지 않았습니다.
그러나 2009년 5월 부터 50버전에 대해 viewer.namespace가 되도록 기능이 추가되었습니다.
그러나, createReport로 보고서를 실행할 때 namespace 기능이 되는 뷰어로 먼저 실행이 되지 않으면
사이트 뷰어가 지원되는 뷰어일지라도 namespace가 인식되지 않습니다.
이런 경우 아래와 같이 ztransferx를 통해 레지스트리에 실행할 뷰어를 등록한 후 호출하시면 됩니다.
* ZTransferX로 레지스트리에 뷰어를 등록하는 방법
1. 마이플랫폼에서 뷰어를 띄우는 Form을 호출하기 전에 실행되는 화면에서 ZTransferX Control을 추가합니다.
a. 마이플랫폼 PID > Tools 메뉴 > Project Manager 선택 > Components 탭 > URL 옆의 + (Add New) 클릭 > ActiveXControls 탭 > ZTransferX Control 선택 > Insert > OK
b. 툴바의 ZTransferX 추가
2. ZTransferX Control의 속성창에서 아래 값을 설정합니다.
DownloadInstruction : ozrviewer.idf
DownloadPort : 8081
DownloadServer : http://localhost/ypk/ozrviewer
InstallBase : <PROGRAMS>/Forcs
InstallNamespace : ypk
InstallRegisteronly : -1
3. 뷰어를 띄우는 Form을 보여주기 전에 아래 스크립트를 호출하면 위의 속성에 설정한 뷰어를 레지스트리에 등록합니다.
ZTransferX0.StartInstall();
4. 또는 다음과 같이 스크립트로 속성을 모두 지정할 수도 있습니다.
ZTransferX0.InstallNamespace = "뷰어네임스페이스이름";
ZTransferX0.InstallBase = "<PROGRAMS>/Forcs";
ZTransferX0.InstallRegistOnly = "-1";
ZTransferX0.DownloadServer = "http://127.0.0.1/oz50/OZReportViewer5.0";
ZTransferX0.DownloadPort = "8080";
ZTransferX0.DownloadInstruction = "ozrviewer.idf";
ZTransferX0.StartInstall();
이와 같이 하면 뷰어가 실행될 때 마지막 레지스트리에 등록된 뷰어로 띄우기 때문에 namespace부분을 고려하지 않아도 됩니다.
만약 위의 InstallRegisteronly 값을 0 (default)으로 하면 로컬pc에 뷰어가 없거나 로컬 뷰어보다 서버 뷰어 버전이 높을 경우 뷰어설치까지 됩니다.
따라서 뷰어 설치용으로도 이 방법을 사용할 수 있으나 ZTransferX는 미리 설치되어 있어야 합니다.
---
위의 OZ Viewer 설치 object 태그를 웹에서 실행하지 않고, ZTransferX만 아래와 같이 먼저 설치한 후
"ZTransferX로 레지스트리에 뷰어를 등록하는 방법"에 있는 방법으로 InstallRegisteronly 값만 0으로 해서 뷰어를 설치할 수도 있습니다.
ZTransferX.cab을 Miplatform을 통해 설치한 후 오즈뷰어는 별도로 설치하려면
마이플랫폼 설치 파일 start~.xml에 다음과 같이 추가하여 ZTransferX를 먼저 배포, 설치합니다. (파일명과 버전은 수정 필요)
<record>
<TARGET>{C7C7225A-9476-47AC-B0B0-FF3B79D55E67}</TARGET>
<FILENAME>ZTransferX_2,2,3,7.cab</FILENAME>
<VERSION>system::2,2,3,7</VERSION>
<ACTION>DOWN</ACTION>
</record> |
---
오즈 뷰어의 CLSID는 0DEF32F8-170F-46F8-B1FF-4BF7443F5F25 입니다.
5.x 버전부터는 CLSID에 5DA6D279-ADDA-4F5B-821F-B211EB09EF1A 를 같이 사용할 수 있습니다.
하위 버전과의 namespace 충돌을 막으려면 모든 보고서 호출 폼 앞단에서 "ZTransferX로 레지스트리에 뷰어를 등록하는 방법"을
추가해 주셔야 합니다만, CLSID 5DA6D279-ADDA-4F5B-821F-B211EB09EF1A 인 뷰어를 사용하게 되면
따로 ZTransferX로 뷰어를 레지스트리에 매번 등록하지 않아도 됩니다.
[기존 클래스 아이디]
[5.x 부터 추가된 클래스 아이디]
|
NOSPAM_mklee@forcs.com
