* 개요

OZ Application 에서 OZ Report를 실행 할 때 동일한 데이터를 두 번 조회하지 않기 위해 Application에 조회된 데이터를 Report로 넘길 수 있습니다. Application에서 SDM파일을 생성하여 리포트에서 해당 SDM 파일로 부터 데이터를 읽어와 보고서를 보여줍니다.

* 상세 설명

SDM 생성 COM API 기능

Server

SDM을 생성하는 COM API가 기능을 설명합니다.

SDM을 생성하는 객체는 Concurrent Mode와 Batch Mode로 아래와 같습니다.

n         Concurrent Mode (oz5.0 이상 지원됨)

OZFXDataModule.OZFXConcurrentDataModule

n         Batch Mode

OZFXDataModule.OZFXBatchDataModule

n         속성

-           fileName

Prototype	String fileName
Definition	SDM을 저장할 파일 명 ※ 참고사항 : 파일 명을 지정하지 않을 경우 시스템의 임시 폴더에 파일을 저장합니다.

n         함수

-           addDataSet

Prototype	void addDataSet(String dataSetName, String masterSetName)
Definition	디테일 데이터 셋을 추가합니다.
Argument	dataSetName	데이터 셋 이름
	masterSetName	마스터 셋 이름 ※ 참고사항 :  마스터 셋이 없을 경우 값을 공백으로 설정합니다.

-           addField

Prototype	void addField(String dataSetName, String fieldName, integer fieldType)
Definition	데이터 셋에 필드를 추가합니다.
Argument	dataSetName	데이터 셋 이름
	fieldName	필드 이름
	fieldType	필드 타입 (java.sql.Types 참조) ※ 참고사항 : 바이너리 타입의 데이터 타입은 지원하지 않습니다.

-           startBinding

Prototype	void startBinding()
Definition	메타 정보가 모두 등록되었을 때 데이터 모듈 바인딩을 시작하며 메타 정보의 무결성을 검증합니다.

-           startSet

Prototype	void startSet(String dataSetName)
Definition	데이터 셋 바인딩을 시작합니다. ※ 참고사항 :  startSet(String) 메서드가 호출된 적이 있는 경우 해당 데이터 셋의 디테일 셋 형태로 데이터가 기록됩니다.
Argument	dataSetName	데이터 셋 이름

-           addParameter

Prototype	void addParameter(String ParamName, integer type,  var value)
Definition	SDM 파일을 만들기 위해 폼에 지정되어 있는 폼 패러미터 값을 설정합니다. 폼 패러미터 값을 설정하지 않을 경우에는 폼 패러미터 기본값이 사용됩니다.
Argument	ParamName	패러미터 이름
	type	패러미터 타입 (java.sql.Types 참조) ※ 참고사항 : 지원 가능한 필드 타입의 상수 값은 아래 표를 참조하시기 바랍니다.
	value	패러미터 값

※ 참고사항 : 필드 타입 상수 값

필드 타입	상수 값	지원 여부
TINYINT	-6	지원함
SMALLINT	5	지원함
BIGINT	-5	지원함
INTEGER	4	지원함
REAL	7	지원함
FLOAT	6	지원함
DOUBLE	8	지원함
BIT	-7	지원함
CLOB	2005	지원 안함
CHAR	1	지원함
VARCHAR	12	지원함
LONGVARCHAR	-1	지원함
BINARY	-2	지원 안함
VARBINARY	-3	지원 안함
BLOB	2004	지원 안함
LONGVARBINARY	-4	지원 안함
NUMERIC	2	지원함
DECIMAL	3	지원함
DATE	91	지원함
TIME	92	지원함
TIMESTAMP	93	지원함

-           setValue

Prototype	void setValue(integer columnIndex, var value)
Definition	현재 바인딩 중인 데이터 셋에 값을 설정합니다.
Argument	columnIndex	열 인덱스 ※ 참고사항 : 해당 인덱스는 1 부터 시작되는 인덱스입니다.
	value	값

-           completeRow

Prototype	void completeRow()
Definition	하나의 Row에 대한 데이터 값 설정을 완료합니다.

-           endSet

Prototype	void endSet(String dataSetName)
Definition	데이터 셋 바인딩을 종료합니다.
Argument	dataSetName	데이터 셋 이름

-           endBinding

Prototype	void endBinding()
Definition	데이터 모듈 바인딩을 종료합니다.

-           finish

Prototype	void finish()
Definition	모든 작업을 종료하며, 데이터 전송 타입이 batch 타입일 경우 데이터 전송 작업이 시작됩니다.

-           sendError

Prototype	void sendError(String errorMessage)
Definition	에러 메시지를 전송합니다.
Argument	errorMessage	에러 메시지

Report Viewer

OZ Report Viewer 5.0에서는 SDM COM API를 사용하여 Concurrent Mode로 생성한 SDM 파일을 연동하는 기능이 추가되었습니다.

※ 참고사항 : 기존 4.0 이하 버전에서는 Batch Mode로 생성한 SDM 파일에 대해서만 연동 가능합니다.

적용 예

본 매뉴얼에서는 애플리케이션에서 COM API를 통하여 Concerrent Mode로 SDM 파일을 생성한 후 해당 SDM으로 보고서를 미리보기하는 방법에 대해 설명합니다.

Ø         SDM 생성 시 COM API에서 사용할 ActiveX 객체인 OZFXDataModule.dll 파일을 레지스트리에 등록합니다.

Ø         쿼리 디자이너를 실행하여 SDM을 생성할 ODI를 작성한 후 리포트 디자이너를 실행하여 보고서를 아래와 같이 디자인합니다.

Ø         애플리케이션 디자이너를 Board에 Button을 추가한 후 Button의 OnClick 이벤트에 SDM을 생성하는 스크립트를 아래와 같이 입력합니다.

-          Button1(SDM 파일 생성)

var dm = new ActiveXObject("OZFXDataModule.OZFXConcurrentDataModule");

//SDM 파일 생성 경로

dm.fileName = "C:\\MasterDetail.sdm";

dm.addDataSet("OZParam", "");

var masterDataSetName = "Master";

dm.addDataSet(masterDataSetName, "");

dm.addField(masterDataSetName, "Region", 12);

var detailDataSetName = "Detail";

dm.addDataSet(detailDataSetName, masterDataSetName);

dm.addField(detailDataSetName, "Region", 12);

dm.addField(detailDataSetName, "BranchOffice", 12);

dm.addField(detailDataSetName, "CarID", 12);

dm.addField(detailDataSetName, "Quantity", 4);

dm.startBinding();

//master

dm.startSet(masterDataSetName);

  dm.setValue(1, "서울");

  dm.completeRow();

  dm.setValue(1, "경기");

  dm.completeRow();

  //detail

  dm.startSet(detailDataSetName);

      dm.setValue(1, "서울");

      dm.setValue(2, "대방");

      dm.setValue(3, "H04");

      dm.setValue(4, 5);

      dm.completeRow();

      dm.setValue(1, "서울");

      dm.setValue(2, "종로");

      dm.setValue(3, "D04");

      dm.setValue(4, 12);

      dm.completeRow();

  dm.endSet(detailDataSetName);

  dm.startSet(detailDataSetName);

      dm.setValue(1, "경기");

      dm.setValue(2, "광주");

      dm.setValue(3, "H04");

      dm.setValue(4, 7);

      dm.completeRow();

      dm.setValue(1, "경기");

      dm.setValue(2, "부천");

      dm.setValue(3, "04");

      dm.setValue(4, 12);

      dm.completeRow();

  dm.endSet(detailDataSetName);

dm.endSet(masterDataSetName);

dm.endBinding();

dm.finish();

Ø         설정한 경로에 생성된 SDM 파일로 보고서를 미리보기합니다.

SDM 파일의 데이터로 보고서가 바인딩되는지 확인합니다.

데이터셋을 리포트로 전달하는 예제

* 첨부자료 설명

- OZFXDataModule.dll : OZFXDataModule ActiveXObject를 참조할 때 사용됨

- OZFXDataModule.zip : OZFXDataModule.dll 을 인증한 파일. 뷰어배포시 사용됨.