Ⅰ 시작하기 전에 Ⅱ 디자이너 설치 윈도우 › ozguide › OLD › manual › OZ2.5_Manual › UserGuide.pdfDrill-Down and Hyper Link Design 서로 연관된 보고서간의

A Leader of Enterprise e-Business Solution

FORCS Co., LTD 1

목 차

Ⅰ. 시작하기 전에 …………………………………….…..……………………………………… 5

본 매뉴얼의 목적 ……………………………………….……………………………………… 6

본 매뉴얼 구성 …………………………………………….……..……………………….……. 6

매뉴얼 로드맵 …………………………..…………………….…….…………………………… 8

Ⅱ. 디자이너 설치 ……………………………………………………………………………….. 9

시스템 요구사항 ………………….…………………………………..……….….……………. 10

설치 ………………………………………………………………………..…………………….. 11

디자이너 파일 구성 ……………………………………………………….…….……………. 13

디자이너 실행하기 …………………………………………………….……..………………... 16

오즈 디자이너 제거하기……………………………………………………………………..… 18

Ⅲ. 디자이너 윈도우 ……………..… …………………………..………....…………………. 19

오즈 디자이너 구성 ……………………..……………………..…..………………….……. 20

메뉴바…………………………………………………………………..…..….………………….22

툴바…………………………………………………………………………..…..……………….. 33

좌표창, 선 두께창 …………………………………………………………………………….. 36

Ⅳ. Setting Up a Connection …………………….………….………………………….…... 37

데이터 소스 …………….……….………………………….……..…………………………….. 38

데이터베이스 연결 …………………………………………………..…...………..………….. 39

SQL 데이터 셋 생성 ……………………………………………..……..….…….…………… 45

동적 데이터베이스 연결 …………………………………………………..…………………... 47

2 FORCS Co., LTD

Ⅴ. Designing Report …………………………………….….………………………………… 52

용지 설정 ………..…………………………………….……..…………………………………. 53

그리드 설정 ……………………………………….……..…………...………..……………….. 54

Refining the Report Layout ………………..………………………………………..…………. 55

Insert Object ……………………………………………………………………..………………. 60

Ⅵ. Advanced Band Design …………………………………………….…………………… 72

보고서 타이틀 만들기 ………………………………………………………..………………. 73

보고서 머리말/꼬리말 달기 ………………………………………………………..………… 75

데이터 리스트 출력하기 ……………………………………..………………………………. 77

마스터/디테일 데이터 출력하기 …………………………………………………..…..…….. 81

보고서 써머리 만들기 ………………….…………………..………..………………………. 85

데이터 건수에 관계없이 양식 채우기 ……………………………….…………….………. 87

수평으로 반복되는 보고서 만들기 ………………………………..………….……………… 88

Ⅶ. Advanced Component Design ………………………………..……………………… 89

노트 컴포넌트 ……………………….………………………..…………………………………. 91

테이블 컴포넌트 …………………………………………………...……………………………. 93

크로스탭 컴포넌트 …………………………………..………………………..………………… 97

차트 컴포넌트 ………………………………………………………….……………...………. 108

Ⅷ. Drill-Down and HyperLink Design …………………………….…………………… 125

Drill-Down 보고서 제작 ………..…………….…………………….………..………………. 126

Hyperlink 보고서 제작 …………………………………………………..……………………. 130

Ⅸ. 스크립트 ………………………….……………………………………………………….… 132

오즈 스크립트 ……………………...…………………………………………………………. 133

스크립트 수행순서 ………………………………..…..………………………………………. 133

에디터 사용법 …………………………………………….……………………………………. 134

스크립트 탐색기 ………………………………………………………………………………. 135


FORCS Co., LTD 3

Ⅹ. Previewing Report …………………………..…………………………………………… 138

개요 ……………………………………………………….…………………..………………. 139

파일관련 ……………………………………………..………..…………………………..……. 139

보기관련 ………………………………………………...………….…………………………. 143

XI. Dynamic Set …………………………………...…………………………………………… 147

Dynamic Set의 개요 ………………………………….……..………………..………………. 148

Dynamic 쿼리 리포트 제작 ………………………………………………..………………. 150

XII. Group Data Store ………………….……………..………………..…………………… 154

Group Data Store 개요 …………………….…………………………………..……………. 155

Group Data Store 생성 ……………………………….……………………………………. 159

XIII. File/Http Store ………………………………………….………………………………… 162

File Store의 이용 ………………………….…………..……………………………………. 165

Http Store의 이용 ……………………………..……………………………………………. 171

XIV. UDS ………………………………..………………..……………….…..………………… 179

UDS 개요 …………………………………………………………………………..………. 180

UDS 인터페이스 ……………………………….……………………………….…………. 181

UDS 구현 ……………………………………………..……….….………………..………. 182

UDS 활용 ………………………………….……………..………..…………….…………. 194

XV. OZ FTA …………………………..…………………………..…….………………………… 198

오즈 FTA 운영 흐름도 ………………………………….……..…….……………..………. 199

오즈 FTA 기능 …………….……………………….………………….……………..………. 199

오즈 FTA 실행 …………….…………………….…….……….………....……….…………. 201

4 FORCS Co., LTD

XVI. OZ Publishing Wizard …………………….…..…..………………………………… 205

Publishing Wizard 개요 …………………..………………………………….…..………. 206

메뉴 구성 ……………….…………………….…………….….……………..….…………. 207

Publishing Wizard 실행 ………….…………………………..…..…………….…………. 210

XVII. 널(Null) 데이터 처리 ……………………………….………….…………….……… 214

데이터 소스에서 Null 처리 ……………………………………………...……….………. 215

컴포넌트별 Null 처리 ………….…………….………………………….….….…………. 215


FORCS Co., LTD 5

Ⅰ. 시작하기 전에

본 매뉴얼의 목적

본 매뉴얼 구성

매뉴얼 로드맵

6 FORCS Co., LTD

본 매뉴얼은 보고서 개발자를 위한 지침서로 오즈 디자이너의 기능 및 활용방법 전반

에 대해 설명합니다. 내용 구성은 활용 예를 중심으로 기술되어 있으며, 오즈 디자이

너 구성 요소별 상세한 설명은 “User Reference”를 참조하시기 바랍니다.

본 매뉴얼 구성과 각 장에서 다루는 내용은 다음과 같습니다.

디자이너 설치 오즈 디자이너를 설치/제거하고 실행하는 방법에 대해 설명합니다.

디자이너 윈도우 오즈 디자이너의 윈도우 구성과 사용자 인터페이스에 대해 설명합니다.

Setting up a Connection 오즈가 연동할 수 있는 데이터 소스의 종류 및 다양한 상용 데이터베이스와 연

결하여 SQL 데이터 셋을 생성하는 방법에 대해 설명합니다.

Designing Report 보고서 컴포넌트에 대한 크기 및 위치, 정렬 등 보고서 디자인시 필요한 기본

지식에 대해 설명합니다.

Advanced Band Design 보고서 제작의 기초가 되는 밴드의 종류 및 사용방법에 대해 상세히 설명합니

다.

Advanced Component Design 오즈의 고급 컴포넌트들이 가지고 있는 고유한 특성과 사용방법에 대해 설명합

니다.

Drill-Down and Hyper Link Design 서로 연관된 보고서간의 연결 구성방법과 다른 웹 페이지와의 연결 방법에 대

해 설명합니다.

본 매뉴얼의 목적

본 매뉴얼 구성


FORCS Co., LTD 7

스크립트

오즈가 제공하는 자체 언어인 스크립트를 이용하여 각 컴포넌트와 밴드를 제어

하는 방법에 대해 설명합니다.

Previewing Report 보고서 미리보기 방법과 인쇄 그리고 저장에 대해 설명합니다.

Dynamic Set Dynamic 쿼리 리포트를 디자인하기 위한 Dynamic Set에 대해 설명합니다.

Group Data Store 하나의 데이터 셋을 분할하여 그룹 데이터 셋을 생성하는 방법을 설명합니다.

File/Http Store XML, CSV등의 파일 형식 데이터 소스를 네트워크 연결이나 HTTP 프로토콜을

통해 전달받아 이를 연동하는 방법에 대해 설명합니다.

UDS 다양한 사용자 데이터 소스 연동방법에 대해 설명합니다.

OZ FTA 제작 완료한 보고서 양식 파일을 오즈 서버에 업로드/다운로드 하는 기능을 담

당하는 오즈 전용 파일전송 에이전트의 사용방법에 대해 설명합니다.

OZ Publishing Wizard 사용자 웹 애플리케이션에서 오즈 보고서 호출을 위한 소스코드 자동생성 도구

인 Publishing Wizard 활용방법에 대해 설명합니다.

널(Null) 데이터 처리 오즈의 널(Null) 데이터 처리 방식을 데이터 소스 및 컴포넌트별로 설명합니다.

8 FORCS Co., LTD

보고서 개발자와 웹 애플리케이션 개발자, 시스템 관리자가 알아야 할 내용을 전달하

기 위해 다음과 같은 매뉴얼을 제공합니다.

구 분 구 성 내 용

Getting Started오즈 소개와 간단한 보고서 작성을 통해 오즈

의 개념을 설명합니다.

User Reference 오즈 디자이너의 각 컴포넌트를 자세히 설명합

니다. Report

Developer

User Guide

보고서 작성 방법과 디자이너 사용 방법, 작성

된 보고서를 웹에 배포하는 방법을 설명합니

다.

Web

Application

Developer

Viewer Guide 웹에 배포한 보고서가 사용자 애플리케이션과

연동할 수 있도록 다양한 옵션을 설명합니다.

Server

Administrator

Server

Administrator

Guide

서버 관리자가 오즈 서버 소프트웨어를 설치ᆞ

관리ᆞ운영할 수 있도록 오즈 서버의 특성을

설명합니다.

매뉴얼 로드맵


FORCS Co., LTD 9

Ⅱ. 디자이너 설치

시스템 요구사항

설치

디자이너 파일 구성

디자이너 실행하기

오즈 디자이너 제거하기

10 FORCS Co., LTD

본 장에서는 오즈 디자이너의 설치/제거 및 실행방법에 대해 설명합니다.

OS Windows 9x, Windows NT 4.0 이상, Windows 2000, Windows XP

<참고> 오즈 디자이너는 순수 자바 애플리케이션으로 JRE 1.3 이상이 설치 가

능한 모든 OS 플랫폼에서 운영 가능합니다. 제품 CD에는 Windows 플

랫폼을 위한 자동설치 프로그램이 제공되고 있으며, 이외의 플랫폼에 설

치가 필요한 경우 수동으로 설치할 수 있습니다.

CPU

Pentium 166MHz, MMX 233MHz 이상 권장

Main Memory 최소 64MB, 128MB 이상 권장

HDD 최소 50MB 이상의 빈 공간 필요

시스템 요구사항


FORCS Co., LTD 11

오즈 디자이너는 설치 마법사를 이용하여 손쉽게 설치할 수 있습니다.

설치 순서는 다음과 같습니다.

오즈 제품 CD의 [Designer] 폴더 안에 있는 Setup.exe 파일을 실행합니다.

오즈 설치 마법사에는 최신 버전의 윈도우 Installer가 포함되어 있습니다. 설치 대상

PC의 윈도우 Installer 버전이 낮은 경우 이를 자동 업그레이드하기 위해 시스템을 다

시 부팅하라는 메시지가 나타납니다.

설치

12 FORCS Co., LTD

오즈 설치 마법사가 실행됩니다. [다음]을 클릭합니다.

설치 대상 폴더를 지정하고 [다음]을 클릭합니다.

설치가 자동으로 수행됩니다.


FORCS Co., LTD 13

완료 메시지가 나타납니다. 여기서 [완료]를 클릭하면 설치 과정이 완료됩니다.

오즈 디자이너를 설치한 다음 생성되는 디렉토리와 파일의 종류 및 내용은 다음과 같

습니다.

디렉토리 파일 설명

designer.ico 디자이너 아이콘 파일

history.cfg 오즈 디자이너에서 최근 열어본 보고서 파

일 목록

launch.cfg 오즈 실행관련 세팅 파일

MouseWheel.dll 휠 마우스를 사용하기 위한 라이브러리

Ozdesigner.bat 오즈 실행에 관한 일괄 파일

OZDesigner.exe 오즈 실행 파일

%OZD_HOME%

Pdf_java.dll PDF 변환을 위한 윈도우용 자바 라이브러

리

ftpconf.properties FTA 이용에 관한 설정 파일

ftpserver.properties FTA 서버 정보를 담은 설정 파일 %OZD_HOME%

conf ftpuser.properties FTA 유저 정보를 담은 설정 파일

%OZD_HOME%

jre 오즈 디자이너를 실행하기 위한 java environment

ozcommon25.jar

ozserver25.jar 오즈에서 사용하는 공통 라이브러리 %OZD_HOME%

Lib OZFTP15.jar 오즈 FTP 클래스 라이브러리

디자이너 파일 구성

14 FORCS Co., LTD

PublishWizard.jar 퍼블리싱 위저드 클래스 라이브러리

SHEditor.jar 스크립트 에디터에서 사용하는 라이브러

리

log4j.jar 로그 생성에 필요한 클래스 라이브러리

classes.zip

classes12.zip

ifxjdbc.jar

jconn2.jar

jdbc.jar

jkjdbc.jar

jsdk.jar

mysql.jar

unisql.jar

unisqljdbc10.jat

JDBC 클래스 라이브러리

OZD25.jar 오즈 디자이너 클래스 파일

OZUDS.jar 오즈 디자이너 UDS 클래스 파일

crimson.jar

jaxp.jar

parser.jar

%OZD_HOME%

Lib(계속)

xalan.jar

XML 파서 관련 클래스 라이브러리

common.properties [도구] – [환경설정]의 환경 탭에서 설정한

정보에 관한 파일

db.properties [도구] – [환경설정]의 데이터베이스 탭에

서 설정된 JDBC 관련 정보

grid.properties [도구] – [그리드 설정]에서 설정한 그리드


label.properties 도구] – [환경설정]의 라벨 탭에서 설정한


%OZD_HOME%

properties

view.properties 툴바 및 좌표창 등의 화면 정보에 관한

파일

option.txt 퍼블리싱 위저드의 저장 옵션부 설정 파

일 %OZD_HOME%

properties pubinfo.txt

이전에 열었던 파일의 저장 경로를 담고

있는 파일


FORCS Co., LTD 15

chartres_empty.xml 사용자 정의 언어 파일

chartres_en_US.xml 영어(미국) 차트 언어 파일

chartres_ja_JP.xml 일본어 차트 언어 파일

chartres_ko_KR.xml 한국어 차트 언어 파일

images.zip 오즈, 뷰어에서 사용하는 아이콘 이미지

파일

ozapp.zip 오즈 디자이너에서 오즈 뷰어를 실행하

기 위한 클래스 라이브러리

ozlang.properties 오즈 뷰어 메뉴 및 메시지 등 다국어 지

원을 위한 기본 언어 파일

ozlang_empty.propert

ies 사용자 정의를 위한 언어 파일

ozlang_en.properties 뷰어 영어 언어 파일

ozlang_ja_JP.properti

es 뷰어 일본어 언어 파일

%OZD_HOME%

viewer

ozlang_ko_KR.proper

ties 뷰어 한국어 언어 파일

16 FORCS Co., LTD

윈도우 시작 프로그램의 [프로그램] – [OZ Designer] 메뉴에서 [OZ Designer]를 클릭하

거나 윈도우 바탕화면의 [OZ Designer] 아이콘을 클릭합니다.

오즈 디자이너가 실행되면 다음과 같이 오즈 디자이너 초기화면이 나타납니다.

오즈 디자이너의 실행은 오즈 디자이너 실행 디렉토리의 OZDesigner.exe를 통해 이

루어집니다.

디자이너 실행하기


FORCS Co., LTD 17

OZDesigner.exe를 실행시키면 각 설정 클래스 파일들이 로딩되면서 오즈 디자이너가

실행되게 됩니다. 클래스 패스 등의 설정은 launch.cfg에서 변경할 수 있습니다.

launch.cfg의 내용은 다음과 같습니다.

RUN_TARGET = oz.designer.OZDesigner

CLASSPATH

= .;.\Lib\OZD25.jar;.\Lib\ozcommon25.jar;.\Lib\ijava.jar;.\Lib\parser.jar;.\Lib\jaxp.jar;.\Lib\i

fxjdbc.jar;.\Lib\classes12_01.zip;.\Lib\javax;.\Lib\jdbc.jar;.\Lib\pdflib.jar;.\Lib\log4j.jar;.\Lib

\jconn2.jar;.\Lib\jkjdbc.jar;.\Lib\jsdk.jar;.\Lib\unisql.jar;.\Lib\unisqljdbc10.jar;.\Lib\OZUDS.j

ar;.\Lib\ozserver25.jar;.\Lib\OZFTP15.jar;.\Lib\SHEditor.jar;.\Lib\PublishWizard.jar;.\Lib\c

rimson.jar;.\Lib\pdf417.zip

JRE_PATH = .\jre

Version = 1.3

※ ozdesigner.bat 파일로 오즈 디자이너를 실행할 경우는 bat 파일안에 설정된

클래스 패스 등을 수정하여 실행합니다.

set JAVA_HOME=.\jre\bin\

set CLASSPATH=.;.\Lib\ozcommon25.jar;.\Lib\ijava.jar;.\Lib\parser.jar;

.\Lib\jaxp.jar;.\Lib\ifxjdbc.jar;.\Lib\classes12_01.zip;

.\Lib\javax;.\Lib\jdbc.jar;.\Lib\pdflib.jar;.\Lib\log4j.jar;

.\Lib\jconn2.jar;.\Lib\jkjdbc.jar;.\Lib\jsdk.jar;

.\Lib\unisql.jar;.\Lib\unisqljdbc10.jar;.\Lib\OZD25.jar;

.\Lib\OZUDS.jar;.\Lib\ozserver25.jar;.\Lib\OZFTP15.jar;

.\Lib\SHEditor.jar;.\Lib\PublishWizard.jar

%JAVA_HOME%java oz.designer.OZDesigner

18 FORCS Co., LTD

윈도우 제어판의 [프로그램 추가/제거] 창에서 [OZDesigner]를 선택한

다음 [추가/제거] 버튼을 클릭하면 제거됩니다.

윈도우 시작 프로그램의 [프로그램] – [OZDesigner] 메뉴에서 [Uninstall]

을 클릭하면 제거됩니다.

오즈 디자이너 제거하기


FORCS Co., LTD 19

Ⅲ. 디자이너 윈도우

오즈 디자이너 구성

메뉴바

툴바

좌표창, 선 두께창

20 FORCS Co., LTD

본 장에서는 오즈 디자이너의 사용자 인터페이스에 대해 설명합니다.

다음은 오즈 디자이너의 사용자 인터페이스 화면이며 각 구성요소의 이름과 기능은

다음과 같습니다.

오즈 디자이너 구성


FORCS Co., LTD 21

메뉴바 오즈 디자이너의 메인 메뉴이며 풀다운(full down) 형식으로 제

공합니다.

표준툴바

오즈 디자이너의 컴포넌트, 라벨, 폰트의 기능 및 속성을 쉽고

빠르게 사용할 수 있도록 메뉴바 아래에 아이콘 형태로 제공합

니다.

컴포넌트를 선택할 수 있는 컴포넌트 툴바와 라벨 컴포넌트 및

폰트의 속성을 편집할 수 있는 툴바로 구성됩니다.

핫키툴바 컴포넌트의 크기 및 위치, 정렬 등의 기능을 제공하는 툴바입니

다. 아이콘 대신 단축키로도 수행 가능합니다.

데이터 프레임 데이터베이스 및 사용자 데이터 소스와의 연결정보를 설정하고

그룹 데이터, 외부 패러미터, 시스템 패러미터를 생성합니다.

속성 프레임 컴포넌트의 속성을 설정할 수 있습니다.

리포트 프레임 보고서의 기본 프레임으로 보고서 디자인 공간을 제공합니다.

좌표창

컴포넌트의 위치 및 높이, 너비 등의 요소를 미세하게 조정할

수 있는 툴입니다. 실제 수치를 입력해 필요한 위치를 정밀하게

지정할 수 있습니다.

선 두께창 컴포넌트의 상, 하, 좌, 우 또는 전체 외곽선의 두께를 미세하게

조정하는 툴입니다.

각 항목별 상세 기능과 사용방법에 대해서는 다음에 기술되는 각 장에서 자세히 설

명합니다.

22 FORCS Co., LTD

파일(File)

메뉴바의 [파일]을 선택하면 아래와 같은 풀다운 메뉴가 나타납니다.

새로 만들기(Ctrl + N)

새로운 보고서를 생성합니다.

복합 보고서(Ctrl + R)

여러개의 보고서를 하나의 복합 보고서로 작성합니다. 복합 보고서는 하나

의 보고서 양식 파일에 여러개의 보고서가 포함된 형태라고 정의할 수 있

습니다.

메뉴바


FORCS Co., LTD 23

열기(Ctrl + O)

보고서 양식 파일을 읽어 옵니다.

닫기/모두 닫기

현재 작업중인 보고서를 닫습니다.

저장(Ctrl + S)

오즈 보고서 양식 파일을 저장합니다.

24 FORCS Co., LTD

다른 이름으로 저장(Shift + S)

보고서 양식 파일을 새로운 이름으로 저장합니다.

모두 저장(Ctrl + A)

현재 오픈된 보고서 양식을 모두 저장합니다.

데이터 모듈 저장

작업중인 보고서의 데이터 셋을 오즈 자체 데이터 저장 형식인 SDM 파일

로 저장합니다.

데이터 모듈 파일은 데이터베이스와 연결하지 않은 상태에서도 보고서 결

과를 확인할 수 있도록 해 줍니다.

[파일] – [미리보기 옵션]이나 [파일] – [Viewer보기 옵션]에서 SDM 파일을

지정하면 오프라인 상태에서도 미리보기 또는 Viewer보기를 실행할 수 있

습니다.

서버로 전송(Ctrl + F)

오즈 서버의 지정된 디렉토리 또는 폴더에 현재 작업중인 보고서 폼을 업

로드 합니다. 아래의 ‘FTP 서버 연결’이 먼저 이루어져야 합니다.

FTP 서버 연결

오즈 서버와 FTA간 연결을 생성합니다. 자세한 내용은 본 매뉴얼 “XV. OZ

FTA”에서 설명합니다.

배포

서버에 업로드된 보고서를 사용자 웹 애플리케이션에서 호출하기 위한 애

플릿 태그를 손쉽게 생성해 주는 Publishing Wizard를 실행합니다. 자세한

내용은 본 매뉴얼 “XVI. OZ Publishing Wizard”에서 설명합니다.

미리보기(Ctrl + P)

디자인 중인 보고서를 실행합니다. 오즈 디자이너에서 자체적으로 제공되

는 뷰어를 통해 미리보기를 수행합니다.


FORCS Co., LTD 25

미리보기 옵션

특정 SDM 파일을 사용하여 보고서의 미리보기를 수행합니다.

Viewer보기(Shift+P)

별도의 오즈 뷰어를 실행하여 보고서의 미리보기를 수행합니다.

Viewer보기 옵션

별도의 오즈 뷰어를 통해 특정 SDM 파일을 사용하여 보고서의 미리보기

를 수행합니다.

인쇄 보고서를 프린터로 출력합니다.

끝내기

오즈 디자이너를 종료합니다.

파일 메뉴 가장 하단부에는 최근 작업 문서가 5개까지 기록되어 있습니다.

26 FORCS Co., LTD

편집(Edit)

실행 취소(Ctrl + Z) 바로 전에 실행했던 작업을 취소하고 이전 상태로 되돌립니다. 디폴트로

15회까지 실행 취소가 가능합니다.

실행 취소 횟수는 [도구] – [환경설정]에서 사용자가 수정할 수 있습니다.

주의할 점은 컴포넌트 단위로 실행 취소가 이루어지기 때문에 여러 컴포넌

트를 가진 밴드내에서 실행 취소시에는 각별한 주의가 요구됩니다.

다시 실행(Ctrl + Y) 실행 취소했던 작업을 다시 복구합니다. 실행 취소한 횟수만큼 복구 가능

합니다.

잘라내기(Ctrl + X)

선택한 항목들을 클립보드에 복사하고 현재 문서에서는 삭제합니다. [붙이

기]를 이용하여 다른 문서에 동일한 내용을 삽입할 수 있습니다.

복사하기(Ctrl + C)

선택한 항목들을 클립보드에 복사합니다. 복사한 내용은 현재 문서에도 그

대로 남겨지며, [붙이기]를 통해 다른 문서에 삽입할 수 있습니다.


FORCS Co., LTD 27

붙이기(Ctrl + V)

클립보드의 내용을 선택한 밴드 위에 삽입합니다.

보기(View)

툴바 보기/숨기기

컴포넌트의 색상을 지정하고 각종 폰트를 설정하는 툴바를 숨기거나 볼 수

있게 합니다. 컴포넌트 버튼이 포함된 툴바는 숨길 수 없습니다.

툴팁 보기/숨기기

각 컴포넌트에 대한 풍선 도움말(툴팁)을 지원합니다.

좌표창 보기/숨기기

좌표창을 활성화 또는 비활성화 합니다.

선 두께창 보기/숨기기

선 두께창을 활성화 또는 비활성화 합니다.

28 FORCS Co., LTD

도구(Tool)

[도구] 메뉴는 오즈 디자이너의 환경을 설정하는 기능과 각종 마법사 기능을

포함하고 있습니다. 크로스탭, 차트, 테이블, 라벨 등 마법사 기능을 가지고 있

는 컴포넌트들을 자신이 속한 밴드 위에 위치시킨 후 오른쪽 버튼을 클릭하여

해당 마법사를 선택하거나 마우스로 컴포넌트 영역 전체를 선택한 후 메뉴바의

[도구]에서 선택할 수 있습니다.

환경 설정

오즈 디자이너를 사용함에 있어 기본적으로 정의되어야 할 환경들을 설정

할 수 있도록 해주는 대화상자가 나타납니다.

[환경] 탭에서는 언어나 도구별 형태, 디자인시 사용 단위계 등 디자이너의

전반적인 옵션을 제공합니다.


FORCS Co., LTD 29

[라벨] 탭에서는 라벨 속성들의 기본값을 설정할 수 있습니다. 해당 속성들

은 편집툴바 혹은 스크립트를 이용해서도 변경할 수 있습니다.

[데이터베이스] 탭에서는 데이터베이스 연결을 위한 기본 JDBC 드라이버

를 설정합니다.

오즈 디자이너를 설치하면 자동적으로 설치되지만 기본으로 제공되는 드라

이버를 다른 드라이버로 대체하거나 신규 드라이버를 등록할 수 있습니다.

따라서 사용자가 해당 데이터베이스에 기본적으로 제공되는 JDBC 드라이

버와 다른 드라이버를 사용하기 원한다면 JDBC 드라이버명과 URL을 새

로 지정하면 됩니다. 그러나 URL 스트링 뒤에 따라오는 Connection 스트

링이 달라질 경우는 사용할 수 없습니다.

그리드 설정

그리드는 마우스로 컴포넌트를 배치하거나 이동할때의 기준선으로 컴포넌

트의 배치를 용이하게 합니다.

그리드 설정은 그리드 적용 내부 및 그리드 크기 등을 설정합니다.

30 FORCS Co., LTD

용지 설정

용지의 여백 및 크기를 설정합니다. 여기서 설정한 사항들은 프린트할 문

서의 기본 프린트 설정으로 지정됩니다.

관계도

마스터-디테일 보고서와 같이 종속관계를 갖는 보고서를 만들 경우 데이터

셋 간의 상관관계를 도식화하여 표시합니다.


FORCS Co., LTD 31

스크립트 탐색기

보고서에 사용된 스크립트들을 쉽고 빠르게 관리할 수 있도록 도와줍니다.

크로스탭, 차트, 테이블, 간트차트 마법사, 라벨 마법사

오즈는 크로스탭, 차트, 간트차트, 라벨 컴포넌트를 쉽게 사용할 수 있도록

하는 마법사 기능을 제공합니다. 각 마법사에 대한 자세한 내용은 “User

Reference Ⅵ. 마법사”를 참조하시기 바랍니다.

도움말(Help)

오즈 디자이너 버전 정보 및 사용방법에 대한 정보를 제공합니다.

32 FORCS Co., LTD

오즈 정보

오즈 디자이너의 버전과 빌드 정보, 사용권 등의 정보를 보여줍니다.

도움말

보고서 작성시 손쉽게 참조할 수 있도록 온라인 매뉴얼을 제공합니다.

이 파일은 pdf 형식으로 제공되므로 Acrobat Reader를 통해 볼 수 있습니

다.


FORCS Co., LTD 33

툴바는 오즈 디자이너의 각종 기능을 보다 간편하고 빠르게 사용할 수 있도록 메뉴

아래 및 하단에 아이콘 형태로 제공됩니다.

툴바는 각종 컴포넌트 및 기본적인 속성 설정 기능을 포함하고 있는 표준툴바

(Component/Edit Tool Bar)와 자주 사용되는 기능을 모아 놓은 핫키툴바(Hot_Key Tool

Bar)가 있습니다.

표준툴바(Component/Edit Tool Bar)

컴포넌트 툴바는 오즈에서 제공하는 각종 컴포넌트들을 손쉽게 생성할 수 있도록

해줍니다.

아이콘 설명

새로 만들기, 열기, 저장

인쇄, 미리보기, Viewer 보기

잘라내기, 복사하기, 붙이기

타이틀 밴드, 페이지 헤더 밴드, 테일 밴드, 페이지 풋터 밴

드

데이터 밴드, 써머리 밴드, 더미 밴드

사이드 밴드, 데이터 익스팬더 밴드, 사이드 헤더 익스팬더

밴드, 사이드 풋터 익스팬더 밴드

크로스탭, 차트, 테이블, 간트, 리전 컴포넌트

컴포넌트 선택 취소

라벨, 수식 라벨, 데이터 라벨, 그룹 라벨, 패러미터 라벨,

시스템 라벨

노트, 바코드, 이미지 컴포넌트

사각형, 원, 선, 화살표 컴포넌트

툴바

34 FORCS Co., LTD

속성 편집 툴바는 각종 컴포넌트의 속성 중 공통적으로 적용되는 색상 및 폰트 등

을 보다 빠르게 설정할 수 있도록 해줍니다.

아이콘 설명

실행 취소, 다시 실행

바탕색, 전경색, 테두리색 선택

글자 폰트 선택

글자 크기 선택

글자 속성 변경(굵게, 기울임꼴)

글자 수평 정렬(좌측, 중앙, 우측정렬)

글자 수직 정렬(상단, 중앙, 하단)

화면에 표시되는 컴포넌트 종류 선택

리포트 영역을 확대 및 축소, 원상태로 복원

디자인/배경 밴드 선택

현재 작업중인 창닫기


FORCS Co., LTD 35

핫키툴바( Hot_Key Tool Bar)

[핫키툴바]는 컴포넌트 정렬 및 크기 조정에 가장 빈번히 사용되는 항목을 단축키

및 아이콘화 한 것입니다.

핫키툴바의 각 아이콘은 해당하는 단축키가 설정되어 있으며, 그 세부적인 기능은

다음과 같습니다.

아이콘 단축키 세부적인 기능

A , S 컴포넌트, 라벨 등의 객체를 앞으로 또는 뒤로

이동

Z , X , C 가로 라벨 묶기, 세로 라벨 묶기, 라벨 풀기

P 선행 라벨 선택

그룹 라벨에서 상위 그룹 라벨을 선택

R , B , V

밴드들간의 자동 위치 조절(우측, 좌측, 자동크기

조정보기)

하나의 밴드가 데이터로 인해 커질 경우 커지는

밴드의 크기에 맞추어 나머지 밴드들의 위치가

자동으로 변합니다.

CTRL +

←→↑↓

왼쪽, 오른쪽, 위로, 아래로 정렬

2개 이상의 컴포넌트를 모서리를 기준으로 한꺼

번에 정렬합니다. 가장 마지막에 선택한 컴포넌

트를 기준으로 정렬합니다.

CTRL +

H , W , J , U

높이 정렬, 너비 정렬, 수직 간격조정, 수평 간격

조정

2개 이상의 컴포넌트 크기 또는 간격을 한꺼번

에 조정합니다. 높이 정렬과 너비 정렬의 경우

가장 마지막에 선택한 컴포넌트의 높이/너비와

같은 크기로 만들어 줍니다. 수직/수평간격조정

의 경우에는 각 컴포넌트간의 평균 간격으로 조

정합니다.

SHIFT +

←→↑↓

왼쪽, 오른쪽, 위로, 아래로 컴포넌트의 크기를

조정합니다.

ALT +

←→↑↓

컴포넌트를 왼쪽, 오른쪽, 위로, 아래로 이동 시

킵니다.

36 FORCS Co., LTD

[좌표창]은 컴포넌트의 위치 및 높이, 너비 값을 직접 입력하여 미세하게 조정할 수

있는 툴이며, 현재 선택한 컴포넌트의 위치 및 크기 정보를 보여줍니다.

[선 두께창]은 선 두께를 지정할 수 있습니다. 콤보박스 안의 값들을 통해 선의 두께

를 지정합니다. 선 두께창 값이 0이 되면 선은 보이지 않게 됩니다.

좌표창, 선 두께창


FORCS Co., LTD 37

Ⅳ. Setting Up a Connection

데이터 소스

데이터베이스 연결

SQL 데이터 셋 생성

동적 데이터베이스 연결

38 FORCS Co., LTD

이 장에서는 오즈가 제공하는 데이터 소스의 종류를 설명하고 오즈 디자이너에서의 다양한

데이터베이스 연결 및 SQL 데이터 셋 생성 방법을 설명합니다.

오즈가 지원하는 데이터 소스의 종류는 다음과 같습니다.

Database 데이터베이스로부터 쿼리문을 이용, JDBC 또는 ODBC를 통

해 데이터 셋을 생성하여 활용합니다.

UDS

(User_Data_Source)

오즈가 제공하는 Non-DB 데이터 연동을 위한 Java

Interface로 일반 텍스트 파일, CSV, XML 등의 파일 데이터

는 물론 EJB, Servlet, ASP, JSP, Applet 등 사용자 프로그램

데이터 등 다양한 형태의 외부 데이터 소스로부터 데이터

셋을 생성하여 활용할 수 있도록 합니다.

* 자세한 설명은 본 매뉴얼 “XIV. UDS”를 참조하시기 바랍

니다.

Group_Data_Store

JDBC, ODBC 또는 UDS(User Data Source)를 통해 가져온

데이터 셋을 특정 필드들을 기준으로 재 그룹핑하여 새로운

데이터 셋을 만들어 활용할 수 있도록 합니다. 특히 하나의

데이터 셋을 마스터/디테일 데이터 셋으로 재구성하고자 할

때 많이 사용됩니다.

* 자세한 설명은 본 매뉴얼 “XII. Group Data Store”를 참조하

시기 바랍니다.

File Store/Http Store

로컬이나 원격 시스템에 있는 XML, CSV 형식 파일의 데이

터에 대한 표준화된 연동 방법입니다.

* 자세한 설명은 본 매뉴얼 “XIII. File/Http Store”를 참조하시

기 바랍니다.

데이터 소스


FORCS Co., LTD 39

다음에서는 오즈 디자이너에서 데이터베이스를 연결하는 방법을 설명합니다.

데이터 프레임에서 [Database]의 오른쪽 마우스를 클릭하여 [데이터베이

스 정보 추가]를 선택합니다.

데이터베이스와의 연동은 ODBC 또는 JDBC를 통해 이루어집니다.

ODBC를 이용한 연결 다음에서는 ODBC 드라이버를 이용한 데이터베이스 연결방법을 설명합니다.

MS Access, dBase, Foxpro 등 ODBC 드라이버를 지원하는 데이터베이스를 연

결할 때 사용합니다.

ODBC를 사용하기 위해서는 해당 드라이버가 사전에 윈도우의 시스템 데이터

원본으로 등록되어 있어야 합니다.

데이터베이스 연결

Step 1

Step 2

40 FORCS Co., LTD

[데이터 정보 이름]은 오즈가 내부적으로 사용할 데이터 연결정보 이

름으로 개발자가 임의로 부여합니다.

[데이터베이스 벤더 이름] 항목에 ODBC를 선택하고 [데이터베이스 드

라이버 종류] 항목에 윈도우에 등록된 시스템 데이터 원본 이름을 입

력합니다.


FORCS Co., LTD 41

JDBC를 이용한 연결

다음에서는 JDBC 드라이버를 이용한 데이터베이스 연결방법을 설명합니다.

MS-SQL, ORACLE, Sybase 등 JDBC를 지원하는 모든 데이터베이스 연결시 사

용합니다.

[데이터베이스 벤더 이름] 항목에 연결한 데이터베이스 종류를 선택합니다. 이

때 데이터베이스 벤더별로 입력할 항목이 활성화됩니다.

MS-SQL 연결 예

[데이터베이스 벤더 이름] 항목에서 ‘MS-SQL’을 선택합니다.

[데이터 정보 이름] 항목은 오즈가 내부적으로 사용할 데이터 연결정

보 이름으로 개발자가 임의로 부여합니다.

[데이터베이스 서버 IP 주소]와 [데이터베이스 서버 포트 번호] 항목에

는 DB 서버의 IP 주소와 포트 번호를 입력합니다.

[데이터베이스 이름]에는 연결할 데이터베이스명을 입력합니다.

[사용자 이름]과 [패스워드] 항목에는 연결할 데이터베이스의 사용자

명과 패스워드를 입력합니다.

42 FORCS Co., LTD

Oracle 연결 예

Oracle의 경우는 [데이터베이스 이름] 대신에 [데이터베이스 서버 이

름] 항목이 활성화 됩니다. 이 항목에는 연결할 오라클 서버의 SID명

을 입력해야 합니다. 이는 오라클 서버 설치시 정해지며 기본값은

‘ORCL’ 입니다.

MS-SQL과 달리 [데이터베이스 드라이버 종류]도 지정해야 합니다. 오

라클의 JDBC 드라이버는 thin(Type-4)과 ocl(Type-2)이 있습니다.


FORCS Co., LTD 43

Sybase 연결 예

Sybase 연결의 경우 MS-SQL과 거의 동일한 항목을 입력하나 [데이터

베이스 드라이버 종류]를 추가로 입력해야 합니다. Sybase의 JDBC 드

라이버는 jConnect이며 이를 사용하기 위해서는 ‘Tds’를 지정합니다.

Informix 연결 예

44 FORCS Co., LTD

Informix 연결의 경우에도 MS-SQL과 거의 동일한 항목을 입력해야 하

나 오라클에서와 같이 [데이터베이스 서버 이름]을 지정해야 합니다.

User-Defined 연결 예

[데이터베이스 벤더 이름]에는 없지만 연결할 데이터베이스가 JDBC를 지

원한다면 다음과 같은 절차를 거쳐 사용할 수 있습니다.

먼저 추가할 JDBC 드라이버 파일 경로를 launch.cfg 파일의 클래스

경로에 추가하고 디자이너를 실행합니다.

[데이터베이스 연결 정보]에서 [데이터베이스 벤더 이름]을 ‘User-

Defined’로 선택하면 [JDBC 정보] 탭이 추가로 나타납니다.

[JDBC 정보]에서 [JDBC 드라이버 이름]에 해당 드라이버 파일명을 입

력하고 [JDBC 연결 URL]에 해당 데이터베이스 서버의 URL을 입력하

면 다른 일반 데이터베이스와 같이 사용할 수 있습니다.

다음은 MY_SQL을 사용할 때의 예입니다.


FORCS Co., LTD 45

Step 2에서 [확인] 버튼을 클릭하면 아래와 같이 데이터베이스 항목 아래

에 연결된 데이터베이스 정보들이 나타납니다.

다음에서는 연결된 데이터베이스로부터 SQL 데이터 셋의 생성 과정을 설명합니다.

‘sales’라는 데이터베이스 소스에서 오른쪽 마우스를 클릭하여 [SQL 데

이터 추가]를 선택합니다.

Step 1

SQL 데이터 셋 생성

Step 3

46 FORCS Co., LTD

[SQL 이름]란에는 생성할 SQL 데이터 셋 이름을 입력하고 [쿼리문 마

법사]를 이용하거나 직접 입력하여 [SQL문]을 작성합니다.

SQL문 실행을 이용하여 쿼리 결과를 확인합니다.

Step 2

Step 3


FORCS Co., LTD 47

다음과 같이 SQL문을 통해 가져온 데이터 필드를 확인할 수 있습니다.

오즈 패러미터를 이용한 동적 데이터베이스 연결 데이터베이스에 대한 연결정보가 보고서 디자인시가 아닌 운영시점에 사용자

로그인 정보등에 의해 결정될 경우 오즈 패러미터를 이용하여 동적으로 데이터

베이스에 연결할 수 있습니다.

Step 4

동적 데이터베이스 연결

48 FORCS Co., LTD

우선 데이터베이스 서버 IP, PORT, 사용자 ID, 패스워드 등 동적으로 변

하는 정보를 위해 오즈 패러미터를 등록합니다.

패러미터 등록은 USR_OZParam에서 오른쪽 마우스를 클릭하여 [패러미

터 추가]를 선택합니다.

각 패러미터 등록 후 디자인 및 테스트를 위해 기본적으로 연결할 데이

터베이스 정보를 각 패러미터의 기본값으로 입력합니다.

패러미터값 입력은 해당 패러미터의 오른쪽 마우스를 클릭하여 [패러미

터값 입력]을 선택하여 입력합니다.

Step 1

Step 2

예) IP → 127.0.0.1

PORT → 1433

USER → sa

PASS → xxx


FORCS Co., LTD 49

데이터베이스에 연결하기 위해 [데이터베이스 정보 추가]를 선택합니다.

데이터베이스 연결정보에서 동적으로 변하는 항목에 대해서는 다음과 같

이 해당 패러미터를 설정합니다.

#OZParam.PASS#

Step 3

Step 4

50 FORCS Co., LTD

각 패러미터에 값이 제대로 설정되었다면 정상적으로 데이터베이스에 연결

됩니다.

각 패러미터 값은 운영시에 사용자 애플리케이션으로부터 전달되며, 전달

된 정보에 따라 동적으로 데이터베이스에 연결됩니다.

앨리어스(Alias)를 이용한 동적 데이터베이스 연결 패러미터를 이용한 동적 데이터베이스 연결의 경우 중요한 데이터베이스 연결

정보가 유출될 우려가 있으므로 오즈 서버의 db.properties 파일에 등록되어 있

는 데이터베이스만을 전달하여 데이터베이스에 동적으로 연결하는 방법을 제공

합니다.

오즈 서버의 [/conf] 디렉토리에 있는 db.properties 파일에는 다음과 같이 각

데이터베이스 연결에 대한 정보가 등록되어 있습니다.

(예) db.properties

데이터베이스 연결 정보에 다음과 같이 DB alias를 설정하면 운영시에 alias 이

름만으로 동적 데이터베이스 연결이 가능합니다.

Alias


FORCS Co., LTD 51

Alias

서버의 DB

Property File을

로컬로 복사하여

사용할 수 있습니

다.

52 FORCS Co., LTD

Ⅴ. Designing Report

용지 설정

그리드 설정

Refining the Report Layout

Insert Object


FORCS Co., LTD 53

본 장에서는 보고서의 크기 설정, 컴포넌트 위치별 크기조정 기능 그리고 각종 구성요소들

을 생성하는 기본 사용법에 대해 설명합니다.

[여백설정]에서 위쪽, 아래쪽, 왼쪽, 오른쪽은 프린트할 용지의 여백을 의미합니다. 이

곳에 입력하는 수치의 단위는 [사용 단위계]에서 지정할 수 있습니다.

[용지 크기]는 용지의 크기와 방향을 설정하기 위해 필요한 기능들을 제공합니다.

용지 설정

54 FORCS Co., LTD

[그리드 적용]은 컴포넌트를 배치할 때 그리드에 맞춰 배치되도록 설정해 줍니다.

[적용함]은 그리드를 적용하며, [적용하지 않음]은 그리드 적용을 해제하고 컴포넌트들

을 자유롭게 배치할 수 있도록 합니다.

[그리드 표시]는 그리드를 적용했을 때 그리드의 간격을 화면상에서 볼 수 있도록 해

줍니다.

[그리드 크기]는 그리드의 간격을 픽셀 단위로 조절하는 기능입니다. X, Y 크기를 크게

지정하면 컴포넌트들이 거의 지정된 위치에 배치되는 효과를 가져올 수 있습니다. 크

기를 작게 할수록 세밀한 배치가 가능하기 때문에 배치가 더욱 자유로워 집니다.

그리드 설정


FORCS Co., LTD 55

선택

단일, 차트, 리전 컴포넌트 선택

마우스로 해당 컴포넌트를 클릭합니다.

크로스탭, 테이블, 간트 차트 컴포넌트 선택

컴포넌트 전체를 드래그하여 클릭하거나 해당 컴포넌트가 포함하고 있는

라벨을 클릭한 후 Esc키를 누릅니다.

밴드 및 Report

밴드의 공백 부분을 마우스로 클릭합니다.

밴드 내 모든 컴포넌트 선택

밴드의 공백 부분에서 마우스를 더블 클릭합니다.

해당 컴포넌트를 담고 있는 상위 컴포넌트 선택

해당 컴포넌트를 담고 있는 상위 컴포넌트를 선택하려면 해당 컴포넌트를

선택한 상태에서 Esc키를 누릅니다. (Esc는 선택되는 영역을 한단계씩 높

여 나가는 기능을 합니다.)

테이블이나 크로스탭의 라벨 컴포넌트 Esc 테이블이나 크로스탭 Esc

해당 컴포넌트들을 담고 있는 밴드 Esc Report

다중 컴포넌트 선택

마우스로 원하는 컴포넌트를 드래그하여 선택하거나 Shift키를 누른 상태에

서 마우스로 여러개의 컴포넌트를 선택합니다.

위치 이동

마우스 이용

단일 컴포넌트 및 차트, 리전 컴포넌트의 경우 마우스로 해당 컴포넌트를

Refining the Report Layout

56 FORCS Co., LTD

선택한 상태에서 원하는 위치로 드래그 앤 드롭합니다. 만약 그리드가 설

정되어 있다면 그리드 단위로 이동합니다. 단, 크로스탭, 테이블, 간트차트

의 이동은 오른쪽 마우스를 누른 상태에서 이동합니다.

Alt+← → ↑↓

컴포넌트를 선택한 후 Alt키를 누른 상태에서 ← → ↑↓ 키를 누릅니다.

단축키 사용시 컴포넌트는 픽셀 단위로 이동합니다.

Hotkey 이용 컴포넌트를 선택한 후 Hotkey 툴바에서 이동방향 키를 누릅니다. 단축키와

동일하게 컴포넌트 이동은 1픽셀입니다.

크기조정

마우스 이용

컴포넌트를 선택한 후 테두리선으로 마우스를 이동하면 화살표가 나옵니다.

왼쪽 마우스를 누른 상태에서 크기를 조정합니다.

shift + ← → ↑↓

컴포넌트를 선택한 후 Shift키를 누른 상태에서 ← → ↑↓ 키를 누릅니다.

단축키 사용시 컴포넌트 이동은 1픽셀입니다.

Hotkey 이용 컴포넌트를 선택한 후 Hotkey 툴바에서 크기 지정키를 누릅니다. Hotkey

를 사용할 시 컴포넌트 이동은 1픽셀입니다.

※ 테이블, 크로스탭 컴포넌트에서는 개별 피봇 크기만 조정됩니다.

정렬 왼쪽, 오른쪽, 위로, 아래로 정렬

선택된 다수의 컴포넌트들을 기준이 되는 컴포넌트의 모서리를 기준으로

정렬합니다. 가장 마지막에 선택한 컴포넌트가 기준이 됩니다.


FORCS Co., LTD 57

Ctrl + ← → ↑↓ 이용

정렬하고자 하는 컴포넌트를 마지막에 선택한 후 Ctrl키를 누른 상태

에서 ← → ↑↓ 키를 누릅니다.

Hotkey 이용 정렬하고자 하는 컴포넌트를 마지막에 선택한 후 Hotkey 툴바에서 정

렬 아이콘을 누릅니다.

높이정렬, 너비정렬, 수직간격조정, 수평간격조정

선택된 다수의 컴포넌트들의 크기 또는 간격을 기준에 맞추어 조정합니다.

높이정렬, 너비정렬은 마지막에 선택한 컴포넌트가 기준이 되어 정렬되며,

수직간격조정과 수평간격조정은 컴포넌트 사이의 평균값이 적용됩니다.

Ctrl + H, W, J, U 이용

기준하고자 하는 컴포넌트를 마지막에 선택한 후 Ctrl키를 누른 상태

에서 H, W, J, U 키를 누릅니다.

Hotkey 이용 기준하고자 하는 컴포넌트를 마지막에 선택한 후 Hotkey 툴바에서

H,W,J,U 키를 누릅니다.

편집

복사(Ctrl + C)

동일한 컴포넌트를 사용할 경우 복사하여 사용할 수 있습니다.

사용할 컴포넌트를 선택한 후 단축키(Ctrl+C)를 사용하거나 오른쪽 마우스

를 클릭하여 [복사하기]를 누르면 됩니다.

잘라내기(Ctrl+X)

선택한 항목들을 클립보드에 복사합니다. 복사한 내용은 현재 문서에도 그

대로 남겨지며, [붙이기]를 통해 다른 문서에 삽입할 수 있습니다.

58 FORCS Co., LTD

붙이기(Ctrl +V)

복사한 컴포넌트를 단축키(Ctrl+V)를 사용하여 붙이기 하거나 오른쪽 마우

스를 클릭하여 [붙이기]를 누르면 됩니다.

삭제(Del)

필요없는 컴포넌트를 삭제할 시 사용합니다. 컴포넌트를 선택한 후 Del키

를 누르거나 오른쪽 마우스를 클릭하여 [삭제]를 누르면 됩니다.

실행취소((Ctrl+Z)

바로 전에 실행했던 작업을 취소하고 이전 상태로 되돌립니다.

Redo((Ctrl+Y)

실행 취소했던 작업을 다시 복구합니다.

기타

컴포넌트 앞/뒤 정렬

컴포넌트가 겹쳐서 배열되었을 경우 하위에 위치한 컴포넌트는 상위에 위

치한 컴포넌트에 의해 가려지게 됩니다. 뒤에 가려져 보이지 않는 컴포넌

트를 앞으로 보이고자 할 때 ‘앞으로’ 정렬을, 뒤로 보이고자 할 때는 ‘뒤

로’ 정렬을 이용합니다.

마우스 이용

서로 겹쳐진 컴포넌트들을 선택한 후 오른쪽 마우스를 클릭하여 앞으

로/뒤로를 선택합니다.

Hotkey 이용 서로 겹쳐진 컴포넌트들을 선택한 후 Hotkey 툴바에서 앞으로/뒤로 키

를 누릅니다.

라벨 묶기

가로 라벨 묶기(앞으로, 뒤로)

여러 라벨 컴포넌트들을 가로 방향으로 묶어 줍니다. 여러개의 라벨

컴포넌트들을 가로로 나란히 정렬하고자 할 때 사용하며 가로로 묶인


FORCS Co., LTD 59

라벨들은 함께 이동할 수 있습니다.

- 마우스 이용

가로로 묶을 컴포넌트들을 선택한 후 오른쪽 마우스를 클릭하여 가

로 라벨 묶기를 선택합니다.

- Hotkey 이용

가로로 묶을 컴포넌트들을 선택한 후 Hotkey 툴바에서 가로라벨 묶

기 키를 누릅니다.

세로라벨 묶기

여러 라벨 컴포넌트들을 세로 방향으로 묶어 줍니다.

- 마우스 이용

세로로 묶을 컴포넌트들을 선택한 후 오른쪽 마우스를 클릭하여 세

로라벨 묶기를 선택합니다.

- Hotkey 이용

세로로 묶을 컴포넌트들을 선택한 후 Hotkey 툴바에서 세로라벨 묶

기 키를 누릅니다.

60 FORCS Co., LTD

라벨 풀기

기존의 묶여진 라벨을 풀어 줍니다.

마우스 이용

묶여진 라벨의 집합을 선택한 후 오른쪽 마우스를 클릭하여 라벨풀기

를 선택합니다.

Hotkey 이용

묶여진 라벨의 집합을 선택한 후 Hotkey 툴바에서 라벨풀기 키를 누

릅니다.

Report 보고서 디자인을 위한 기본 프레임으로 디자인 공간을 제공합니다. 보고서 위

에 밴드(Band)를 배치하고 밴드위에 각종 컴포넌트를 배치하여 보고서를 디자

인합니다

Report 생성

[파일] – [새로 만들기]를 클릭하거나 아이콘을 클릭합니다.

Insert Object

Report


FORCS Co., LTD 61

Band 보고서의 Header, Footer, Body 부분 등 각 영역을 담당하는 상위 컴포넌트입

니다.

타이틀 밴드, 페이지 헤더밴드, 페이지 풋터 밴드, 테일 밴드, 데이터 밴드, 써

머리 밴드, 더미 밴드, 사이드 밴드, 데이터 익스팬더 밴드, 사이드 헤더 익스

팬더밴드, 사이드 풋터 익스팬더 밴드가 있으며 각 밴드에 대한 설명은 “User

Reference Ⅲ. 밴드”를 참조하시기 바랍니다.

Band 생성

과 같은 아이콘 중 필요한 밴드를 선택

한 후 왼쪽 마우스를 누른 상태로 보고서 폼 위에서 대각선 아래 방향으로

드래그 앤 드롭합니다.

DB Fields(Data Label) 데이터 셋의 컬럼 데이터를 출력하는 라벨 컴포넌트입니다. 데이터 밴드와 같

이 데이터 셋이 지정된 밴드에서 사용할 수 있습니다.

Band

62 FORCS Co., LTD

DB Fields 생성

SQL Wizard를 이용하거나 직접 [SQL문]란에

SQL문을 입력한 후 [확인] 버튼을 클릭합니

다.

DB Field 삽입

마우스 이용

생성된 데이터 필드를 선택한 후 데이터 밴드로 드래그 앤 드롭하여

필드를 위치시킵니다.

라벨 마법사 이용

생성된 데이터 필드를 데이터 밴드로 위치시키기 위해 밴드에서 오른

쪽 마우스를 클릭하여 라벨 마법사를 선택합니다.

DB Fields


FORCS Co., LTD 63

필요한 컬럼만 선택하여 오른쪽으로 이동시키면 가로 묶기가 되어 데

이터 밴드 위에 위치됩니다.

<라벨 마법사>

Calculated Fields 데이터베이스에서 가져온 기존의 필드외에 데이터 필드들에 대한 사칙 연산,

합계, 평균 등 수학적 데이터 조작을 통해 얻어지는 새로운 데이터 필드입니다.

Calculated Field 생성

[데이터 프레임]에서 [Database]를 선택한 후 오른쪽 마우스를

클릭하여 [수식 필드 추가]를 선택합니다.

Step 1

64 FORCS Co., LTD

[수식 필드 이름]을 입력합니다.

생성된 수식필드를 선택한 후 오른쪽 마우스를 클릭하여 [수

식 필드 구문 편집]을 선택합니다.

Calculated Field

Step 2

Step 3


FORCS Co., LTD 65

생성된 수식필드를 마우스로 선택한 후 데이터 밴드로 드래그

앤 드롭하여 필드를 위치 시킵니다.

Parameters

사용자 애플리케이션을 통해 받게 되는 패러미터를 출력하는 컴포넌트입니다.

Parameters 생성

[USR_OZParam]을 선택한 후 오른쪽 마우스를 클릭하여

[패러미터 추가]를 선택합니다.

[패러미터 필드 이름]을 입력합니다.

Step 1

Step 2

Step 4

66 FORCS Co., LTD

생성된 패러미터를 마우스로 선택한 후 밴드로 드래그 앤 드

롭하여 필드를 위치 시킵니다.

시스템 라벨 보고서가 작성되는 날짜, 시간, 현재 페이지, 총 페이지 등 시스템이 관리하는

정보를 출력하는 라벨 컴포넌트입니다.

시스템 라벨 생성

[SYS_OZSystem] 아래에 오즈에서 기본적으로 제공하는 필드를 마우스로

선택한 후 밴드위에 드래그 앤 드롭하여 필드를 위치 시킵니다.

Parameter

Step 3

OZSystem


FORCS Co., LTD 67

Expression Labels

표현식 속성을 이용하여 데이터 셋의 특정 데이터 필드에 대한 합계, 평균 등

의 함수를 적용하거나 단순한 사칙연산으로 데이터를 조작하기 위한 라벨입니

다.

Expression Label 생성

일반 라벨의 [데이터 형태]를 ‘수식’으로 선택하거나 아이콘을 클릭한

후 왼쪽 마우스를 누른 상태로 보고서 폼 위에서 대각선 아래 방향으로

드래그 앤 드롭합니다.

Expression Label 속성 중 표현식에 ‘데이터셋이름.컬럼이름.SUM(AVG)’을

넣고 표시형식에 ‘###,###,##’ 등을 표기하여 자릿수를 지정합니다.

아이콘을 클릭한 후 데이터 밴드위에 위치 시킵니다.

Step 1

68 FORCS Co., LTD

표현식과 표시형식에 필요한 설정을 합니다.

[표현식의 예]

구분 사용방법 및 예

일반 텍스트 “A”, “NAME”, “학생”, …

데이터 필드 DataSource.fieldName, OZParam.ParameterName

함수

합계 : DataSource.fieldName.sum

평균 : DataSource.fieldName.avg

최대값 : DataSource.fieldName.max

최소값 : DataSource.fieldName.min

사칙연산 +, -, *, /, ()

예) 1+2*4, test.A+test.B, (test.C*30)/100 …

Grouping Labels 그룹 라벨 컴포넌트는 데이터 라벨 컴포넌트와 같이 데이터 셋이 지정된 밴드

에서 사용되나, 데이터 라벨 컴포넌트와 다른점은 밴드내에서 같은 데이터 내

용이 반복될 경우 처음 데이터 내용만 표시된 후 다른 데이터 내용이 나올때

까지 데이터가 나타나지 않습니다.

Step 2


FORCS Co., LTD 69

Grouping Label 생성

아이콘을 클릭한 후 왼쪽 마우스를 누른 상태로 보고서 폼 위에서

대각선 아래 방향으로 드래그 앤 드롭합니다. 속성에서 필드 이름을 선택

합니다.

Draw Objects 사각형, 원, 선(사선 포함), 화살표를 그릴 때 사용하는 컴포넌트입니다.

Draw Object 생성

아이 아이콘 중 필요한 Draw Object를 선택한 후 왼쪽 마우스를

누른 상태로 보고서 폼 위에서 대각선 아래 방향으로 드래그 앤 드롭합니

다.

Image(DB/File)

이미지를 출력할 때 사용하는 컴포넌트입니다. 이미지의 URL을 지정함으로써

이미지를 가져오거나 데이터 셋의 데이터 필드의 데이터를 이미지로 출력하는

컴포넌트입니다.

70 FORCS Co., LTD

Image 생성

아이콘을 클릭한 후 왼쪽 마우스를 누른 상태로 보고서 폼 위에서

대각선 아래 방향으로 드래그 앤 드롭합니다.

URL에서 가져올 경우

이미지 속성 중 [데이터 형태]를 ‘일반’으로 선택하고 [텍스트]

에 URL경로나 로컬 경로를 입력합니다.

예) - http://211.116.251.10/demo_kr/img/Image1.gif

- file://c:\image\Image1.gif

DB에서 가져올 경우

이미지 속성 중 [데이터 형태]를 ‘데이터’로 선택한 후 [필드이

름] 속성에서 필드를 선택합니다.

Case 1

Case 2


FORCS Co., LTD 71

Barcode(DB/일반)

보고서내에 바코드를 삽입하여 출력하기 위한 컴포넌트로써 1차원 바코드, 2차

원 바코드를 지원합니다. 데이터 셋이 지정된 밴드에서 사용 가능합니다.

Barcode 생성

데이터베이스에서 데이터를 가져올 경우

아이콘을 클릭한 후 왼쪽 마우스를 누른 상태로 보고서

폼 위에서 대각선 아래 방향으로 드래그 앤 드롭합니다.

바코드 속성 중 [데이터 형태]를 ‘데이터’로 선택하고 [그리기

형태]를 ‘바코드’로 선택한 후 [필드이름]에 해당 DB Field를

[타입]란에 원하는 바코드 타입을 선택합니다.

데이터를 고정된 값으로 입력하는 경우

아이콘을 클릭한 후 왼쪽 마우스를 누른 상태로 보고서

폼 위에서 대각선 아래 방향으로 드래그 앤 드롭합니다.

바코드 속성 중 [데이터 형태]를 ‘일반’으로 선택하고 텍스트란

에 해당 바코드 값을 입력합니다. 마지막으로 [그리기 형태]를

‘바코드’로 선택한 후 [타입] 항목에서 원하는 바코드 타입을

선택합니다.

Case 1

Case 2

72 FORCS Co., LTD

Ⅵ. Advanced Band Design

보고서 타이틀 만들기

보고서 머리말/꼬리말 달기

데이터 리스트 출력하기

마스터/디테일 데이터 출력하기

보고서 써머리 만들기

데이터 건수에 관계없이 양식 채우기

수평으로 반복되는 보고서 만들기


FORCS Co., LTD 73

본 장에서는 보고서 양식 디자인의 기본 요소인 밴드들의 기능과 특징 및 활용방법을 설명

합니다.

보고서 헤드 부분의 타이틀 형식

보고서 첫 페이지의 상단 부분에 일회에 한하여 나오는 형식입니다.

타이틀 밴드 위에 라벨을 이용하여 제목을 입력하면 됩니다.

보고서 타이틀 만들기

구현

보고서 타이틀

74 FORCS Co., LTD

보고서 표지 형식 보고서 표지의 개념으로 보고서의 첫 페이지에 보고서 제목을 출력합니다.

타이틀 밴드 위에 라벨을 이용하여 보고서의 제목을 입력한 후 타이

틀 밴드의 속성 창에서 [페이지 넘기기]를 ‘예’로 설정합니다.

구현


FORCS Co., LTD 75

보고서의 머리말/꼬리말은 [페이지 헤더밴드]와 [페이지 풋터밴드]를 이용합니다.

첫 페이지 생략하기 보고서 표지 부분에 머리말을 생략하기 위한 경우 또는 보고서의 타이틀과의

중복을 피하기 위해 첫 페이지에서는 머리말을 생략할 수 있습니다.

페이지 헤더 밴드 생성 후 속성 창에서 [첫페이지 출력생략]을 ‘예’로

설정합니다.

보고서 머리말/꼬리말 달기

구현

머리말

꼬리말

76 FORCS Co., LTD

끝 페이지 생략하기 보고서에서 이용하는 써머리 밴드 부분과 내용이 중복되지 않게 하기 위해 보

고서 마지막 페이지에는 꼬리말을 생략합니다.

페이지 풋터 밴드 생성 후 속성 창에서 [끝페이지 출력생략]을 ‘예’로

설정합니다.

구현


FORCS Co., LTD 77

리스트 형태로 데이터를 반복 출력하기 위해서는 데이터 밴드를 이용합니다. 데이터

밴드는 기본적으로 속성에서 데이터 셋을 설정하며 해당 데이터 셋을 데이터 건수만

큼 반복 출력합니다. 데이터 밴드는 부가적으로 데이터 헤더 밴드, 데이터 풋터 밴드,

더미 데이터 헤더 밴드, 더미 데이터 풋터 밴드를 가질 수 있습니다.

데이터 타이틀 만들기 데이터 헤더 밴드를 이용하여 데이터 밴드에 있는 데이터 라벨들에 대한 타이

틀을 생성하여 데이터 리스트가 출력되기 전에 타이틀이 먼저 출력되도록 합니

다.

해당 데이터 밴드의 속성 창에서 [헤더밴드 소유]를 ‘예’로 설정하면

데이터 밴드위에 헤더 밴드가 생성됩니다. 헤더 밴드위에 일반 라벨

을 이용하여 데이터에 대한 타이틀을 만듭니다.

데이터 리스트 출력하기

데이터 헤더 밴드

데이터 밴드

구현

78 FORCS Co., LTD

데이터 타이틀을 매 페이지마다 출력하기

데이터 리스트가 한 페이지를 초과할 경우 데이터에 대한 타이틀을 매 페이지

마다 출력할 수 있습니다.

해당 데이터 밴드 속성 창에서 [헤더고정]을 ‘예’로 설정합니다.

구현

데이터 밴드

데이터 헤더 밴드


FORCS Co., LTD 79

데이터 합계 만들기 데이터 풋터 밴드를 이용하여 데이터 리스트를 출력한 다음 데이터에 대한 합

계를 출력합니다.

해당 데이터 밴드의 속성 창에서 [풋터밴드 소유]를 ‘예’로 설정하면

데이터 밴드 아래 부분에 풋터 밴드가 나타납니다. 수식라벨이나 스

크립트 등을 이용하여 데이터에 대한 합계 처리를 합니다.

구현

데이터 풋터 밴드

데이터 밴드

80 FORCS Co., LTD

데이터 밴드 동적으로 크기 조정하기 고정되어 있는 데이터 밴드의 크기를 밴드에 속해 있는 컴포넌트의 크기에 맞

추어 동적으로 조정하는 기능입니다. 컴포넌트의 크기가 확장됨에 따라 밴드의

크기도 동시에 확장되어야 할 경우 이용합니다.

다음과 같이 데이터 밴드 위의 특정 데이터 라벨의 데이터 양이 일정하지 않은

경우 활용할 수 있습니다.

해당 데이터 밴드를 선택한 후 그 밴드의 속성 창에서 [자동크기조

정]을 ‘예’로 설정합니다. 밴드위의 데이터 라벨 컴포넌트에도 [자동

크기조정] 속성을 설정해야 합니다.

구현

동적으로 크기 조절하기를 하여 제작된 보고서

밴드

밴드

데이터 내용에

따라 밴드의

크기가 자동으

로 변함


FORCS Co., LTD 81

마스터/디테일 보고서란 복수개의 데이터 밴드를 이용하여 마스터 데이터가 한 건 출

력될 때마다 그에 해당하는 다수개의 디테일 데이터가 출력되는 형식입니다. 각 밴드

사이에 마스터/디테일 관계를 설정할 수 있으며 디테일 밴드 위치는 마스터 밴드보다

항상 아래에 위치하게 됩니다. 밴드간 관계를 설정하면 각 밴드가 사용할 데이터 셋

간에도 자동으로 관계가 설정됩니다.

마스터/디테일 데이터 출력하기

82 FORCS Co., LTD

데이터 밴드 두개를 연속으로 나란히 생성한 다음 첫번째 데이터 밴

드의 [데이터 셋] 속성에 마스터 셋을 설정하고, 두번째 데이터 밴

드의 [데이터 셋] 속성에 디테일 셋을 설정합니다.

두번째 데이터 밴드의 [마스터 밴드 이름] 속성에 첫번째 데이터 밴

드 이름을 설정하면 각 밴드간 및 데이터 셋간에 마스터-디테일 관

계가 설정됩니다.

디테일 데이터에 대한 소계 출력하기

마스터-디테일 관계의 보고서에서 각 디테일 데이터에 대한 소계를 출력할 수

있습니다.

- 마스터 밴드와 디테일 밴드를 생성한 다음 디테일 데이터 밴드의 [풋

터 밴드 소유] 속성을 ‘예’로 설정합니다. 해당 풋터 밴드에 수식라벨

등을 이용하여 소계 처리를 합니다.

구현

구현


FORCS Co., LTD 83

하나의 마스터 데이터 단위로 페이지 넘기기 하나의 마스터 관련 데이터가 한 페이지에 출력되도록 설정할 수 있습니다.

마스터-디테일 관계에서 보고서의 디테일 밴드의 데이터 풋터를 선

택하고 속성 창에서 [페이지 넘기기]를 ‘예’로 설정합니다.

구현

84 FORCS Co., LTD

마스터 데이터 내용을 매 페이지마다 출력하기 디테일 데이터가 한 페이지를 초과하는 경우 새로운 페이지 첫 부분에 마스터

데이터를 다시 찍어 주는 기능입니다.

디테일 부분 밴드의 속성 창에서 [마스터 고정]을 ‘예’로 설정합니다.

디테일

디테일

디테일

디테일

디테일

마스터 부분

디테일

디테일

디테일

디테일

일반적인 마스터/디테일 구성

마스터 부분

디테일

디테일

디테일

디테일

마스터 부분

디테일

디테일

디테일

디테일

마스터 내용을 매 페이지마다

출력한 구성

구현


FORCS Co., LTD 85

써머리 밴드를 이용하여 보고서의 마지막에 데이터 출력이 끝난 다음 보고서 전체

에 대한 결론, 요약 등의 정보를 출력합니다.

써머리 밴드 정렬 옵션 써머리 밴드 정렬 옵션에 따라 다음과 같이 다른 형태로 보고서를 출력할 수

있습니다.

써머리 밴드를 선택한 후 속성 창에서 [위에서 아래로 정렬]을

‘예’로 설정하면 상위 밴드에 이어 바로 써머리 밴드가 출력되며,

‘아니오’로 설정하면 페이지의 하단부에 출력됩니다.

써머리 밴드

[위에서 아래로 정렬]을

‘예’로 설정한 모습

써머리 밴드

[위에서 아래로 정렬]을

‘아니오’로 설정한 모습

보고서 써머리 만들기

구현

86 FORCS Co., LTD

보고서 써머리에 페이지 넘기기 무시 속성

마스터-디테일 관계의 보고서 구현 중 마스터 데이터 단위로 페이지 넘기기를

구현한 보고서의 경우 보고서의 마지막 페이지에 써머리 밴드만 출력되는데 써

머리 밴드에서 이전 밴드에서의 [페이지 넘기기] 속성을 무시할 수 있습니다.

써머리 밴드의 속성 창에서 [새 페이지 무시]를 ‘예’로 설정하면 새

페이지에 써머리 밴드가 위치하지 않고 마지막 밴드의 데이터 출력

이 끝나는 부분에 써머리 밴드가 출력됩니다.

구현

마스터 1

디테일 1-1

디테일 1-2

마스터 2

디테일 2-1

디테일 2-2

디테일 2-3

디테일 2-4

디테일 2-5

디테일 2-6

1 2 3

써머리 밴드

4

마스터 1

디테일 1-1

디테일 1-2

마스터 2

디테일 2-1

디테일 2-2

디테일 2-3

디테일 2-4

디테일 2-5

디테일 2-6

1 2 3

써머리 밴드


FORCS Co., LTD 87

데이터 건수에 관계없이 고정된 양식을 표현해야 하는 경우 이용합니다. 더미 밴드를

이용하여 데이터가 용지의 반 정도만을 채우고 끝날 경우 나머지 공간을 빈 양식으로

채울 수 있습니다. 더미 밴드는 기본적으로 반복횟수에 설정된 값만큼 반복해서 출력

하며, [페이지 끝에서 멈춤] 속성이 ‘예’인 경우 해당 페이지 끝까지만 반복 출력됩니

다.

데이터 밴드 아래에 더미 밴드를 위치시키고 속성 창에서 [페이지

끝에서 멈춤]을 ‘예’로 설정합니다.

데이터 건수에 관계없이 양식 채우기

구현

88 FORCS Co., LTD

데이터 밴드는 기본적으로 데이터 건수만큼 아래로 반복되는데 반해 사이드 밴드는

데이터 개수만큼 수평으로 반복하여 데이터가 출력됩니다.

사이드 밴드를 선택하여 영역을 지정합니다. 사이드 밴드 위에는 익

스팬더라는 밴드만이 위치할 수 있는데 익스팬더는 데이터를 가로

방향으로 흐르게 하는 특성을 가지고 있습니다. 또한 일반 밴드에서

헤더와 풋터에 해당하는 사이드 헤더 익스팬더와 사이드 풋터 익스

팬터가 존재합니다.

수평으로 반복되는 보고서 만들기

데 이 터

데 이 터

일반적인 데이터 밴드에서의 데이터 흐름

사이드 밴드에서의 데이터 흐름

구현

사이드 밴드위에 올라가는 여러 밴드들


FORCS Co., LTD 89

Ⅶ. Advanced Component Design

노트 컴포넌트

테이블 컴포넌트

크로스탭 컴포넌트

차트 컴포넌트

90 FORCS Co., LTD

본 장에서는 다음과 같은 오즈 컴포넌트들의 기능 및 사용방법에 대해 설명합니다.

아이콘 이름 설명

노트 컴포넌트

데이터베이스의 binary, BLOB, Log Varchar, CLOB

등과 같은 타입으로 저장된 대용량 텍스트 데이터

를 보고서에 삽입하고자 할 때 사용하는 컴포넌트

입니다.


데이터 셋의 내용을 순차적으로 출력하는 리스트

형태의 표를 보고서에 삽입할 때 사용하는 컴포넌

트입니다.


데이터 분석 및 통계보고서 작성시 유용한 컴포넌

트로 기준이 되는 필드 단위로 그룹핑하여 다차원

형식의 보고서를 보여줍니다.

차트 컴포넌트 2차원 또는 3차원의 차트를 보고서에 삽입할 때

사용합니다.


FORCS Co., LTD 91

노트 컴포넌트는 한 페이지를 초과하는 대용량 텍스트 데이터를 보고서에 삽입

할 때 유용하게 사용할 수 있습니다. (일반 라벨 컴포넌트의 경우는 한 페이지내에서

텍스트 데이터를 출력할때만 활용 가능합니다.) 노트 컴포넌트는 기본적으로 자동크기조정 기능을 수행하며 각 페이지 단위로 데이터

를 잘라서 출력해 줍니다.

텍스트 파일에서 데이터 가져오기 노트 컴포넌트의 [데이터 형태] 속성을 ‘일반’으로 설정한 후 [텍스트] 속성에

텍스트 파일의 URL경로를 입력하면 해당 파일의 데이터를 출력할 수 있습니다.

스크립트를 통해 동적으로 설정할 경우는 setattr 함수를 이용하여 다음과 같이

설정합니다.

setattr(“caption”, “file_url_경로”);

데이터 셋에서 텍스트 데이터 읽어오기 노트 컴포넌트의 [데이터 형태] 속성을 ‘데이터’로 설정하면 속성창의 [텍스트]

부분이 [필드 이름]으로 바뀝니다. [필드 이름]에서 원하는 필드를 선택하면 해

당 필드의 데이터를 출력할 수 있습니다. 노트 컴포넌트는 거의 모든 데이터

타입을 지원하며 일반적으로 다음과 같은 타입에서 주로 사용됩니다.

CHAR, VARCHAR, BLOB, Binary, CLOB, VARBINARY, LONGVARCHAR

노트 컴포넌트

92 FORCS Co., LTD

노트의 자동크기조절과 자동 줄바꾸기 속성과의 관계

자동 줄바꾸기가 ‘예’인 경우

디자인시 설정한 너비에서 자동 줄바꾸기가 실행되어 데이터 양에 따라 아

래부터 높이가 자동 조절됩니다.

자동 줄바꾸기가 ‘아니오’ 인 경우

해당 컴포넌트의 너비가 용지 너비만큼 확장되고 그 위치에서 자동 줄바꾸

기가 실행되며 데이터 양에 따라 아래로 높이가 자동 확장됩니다.


FORCS Co., LTD 93

테이블 컴포넌트는 2차원 표 형태의 보고서를 작성하기 위해 사용합니다. 2차원

표 형태의 보고서는 데이터 라벨을 열거하여 만든 일반 리스트표 형태와 유사하나

[테이블] 컴포넌트를 사용할 경우 자동크기조정, 행개수 고정, 라벨고정 등의 유용한

옵션을 사용할 수 있습니다.

테이블 컴포넌트는 자체 속성에서 [데이터 셋]을 설정할 수 있습니다. 테이블 마법사

를 사용하기 전에 사용할 데이터 셋을 먼저 설정해야 합니다.

테이블 자동 크기 조정 리스트 형태의 보고서에서 특정 데이터 라벨들이 데이터 양에 따라 동적으로

변해야 할 경우 데이터 라벨들의 크기가 각각 조정되므로 표 형태의 보고서 제

작이 어렵습니다. 그러나 테이블 컴포넌트의 자동크기조정을 이용하면 테이블

라벨들의 크기를 동일하게 적용할 수 있습니다.

테이블의 원하는 라벨들에 대해서만 [자동크기조정] 속성을 ‘예’로 설정하면

해당 라벨들의 크기 변화에 맞추어 같은 행의 다른 라벨들의 크기도 같이 바뀝

니다.

테이블 컴포넌트의 [자동크기조정] 속성을 ‘예‘로 한 경우 테이블 전체 라벨들

의 [자동크기조정] 속성이 ‘예’로 설정된 것과 같습니다.

<자동크기조정을 ‘예’로 설정>


94 FORCS Co., LTD

<자동크기조정을 ‘아니오’로 설정>

테이블 행수 고정

테이블 컴포넌트가 출력하는 행 개수를 고정시킬 수 있습니다. 실제 데이

터 건수에 관계없이 표의 행 개수가 고정되어 있는 고정양식의 보고서 제

작시 유용한 옵션입니다.


FORCS Co., LTD 95

<행 개수 ‘5’로 지정> <행 개수 ‘15’로 지정>

테이블 아웃라인 고정(라벨 고정)

행 개수 고정 옵션과 같이 사용할 경우 의미있는 옵션으로 실제 데이터 건

수가 행 개수에서 설정한 값보다 적더라도 표를 행 개수 만큼 라벨로 채워

야 할 경우에 사용합니다.

실제 데이터 건수 : 8

행 개수 : 10으로 설정

96 FORCS Co., LTD

<라벨 고정을 ‘true’로 한 경우> < 라벨 고정을 ‘false’로 한 경우 >

행 개수 보기

표에 일련번호를 추가하기 원할 때 사용합니다. 테이블 마법사에서 행 개수

보기를 ‘true’로 하면 표의 첫번째 열에 데이터 개수만큼 자동으로 일련번호가

생깁니다.

<행 개수 보기 ‘false’인 경우> < 행 개수 보기 ‘true’인 경우 >

25


FORCS Co., LTD 97

분석 및 통계보고서 작성시 활용 가능한 컴포넌트로 기준이 되는 필드 단위로

그룹핑하여 데이터들의 합계, 평균 등 다차원 표를 보여줍니다.

크로스탭 컴포넌트는 자체적으로 속성에서 [데이터 셋]을 설정할 수 있습니다. 마법사

를 사용하기 전에 사용할 데이터 셋을 먼저 설정해야 합니다.

기준 필드에 집합 함수 선택 크로스탭은 마법사에서 행과 열에 설정되는 필드를 기준으로 그룹핑하여 값 필

드의 합계, 평균들을 보여줍니다. 또한 각 기준 필드별로 중간 합계들을 처리

할 수 있도록 하기 위해 기준 필드에 다음과 같은 다양한 집합 함수를 선택할

수 있습니다.

sum, avg, max,

min

해당 기준 필드에 대해 합계, 평균, 최대, 최소값을 출

력합니다.

non 해당 기준 필드에 대해 중간계를 출력하지 않습니다.

Invisible 해당 기준 필드는 표에 출력하지 않지만 내부적으로

해당 필드 기준으로 그룹핑 처리를 수행합니다.

하나의 기준 필드에 여러 개의 집합 함수 선택

마법사에서 집합 함수로 행이나 열의 기준 필드를 선택하고 [선택] 옵션의

sum, avg… 등의 함수를 선택함으로써 설정합니다. Shift키 또는 Ctrl키를

누른 상태에서 여러개의 함수를 선택할 수 있습니다.


98 FORCS Co., LTD

값 필드에 집합 함수 선택 일반적으로 크로스탭 값에는 숫자타입의 필드만 허용되는데 반해 오즈는 텍스

트, 이미지 등의 타입을 지원합니다.

값 필드에 대해서도 집합 함수를 설정할 수 있는데 상위 기준 필드들에 대한

값 필드의 건수가 여러건일 경우 집합 함수가 적용됩니다.

sum, avg, max, min숫자타입의 필드에만 적용됩니다.(합계, 평균, 최대,

최소)

cnt 숫자, 텍스트 등의 모든 타입에 적용되며 값 필드의

데이터 건수를 출력합니다.

non

숫자, 텍스트 등의 모든 타입에 적용됩니다. 값 필드

의 데이터를 스트링으로 변환하여 다중 라인으로 출

력합니다. 일반적으로 필드가 텍스트 타입의 경우에

사용합니다.


FORCS Co., LTD 99

<이미지 크로스탭>

100 FORCS Co., LTD

기준 필드 단위로 페이지 넘기기

마법사에서 행과 열에 설정한 기준 필드들을 기준으로 페이지 넘기기 옵션

을 설정할 수 있습니다. 일반적으로 행과 열에 여러개의 기준 필드들을 설

정할 수 있으며 최하단 기준 필드에 대한 페이지 넘기기는 의미가 없습니

다.

위와 같이 행과 열에 기준 필드가 설정되어 있을 경우 행의 ‘Maker’ 필드

에 대해 [페이지 넘기기]를 체크할 경우 하나의 Maker에 대한 데이터가 출

력되고 그 다음 페이지에 새로운 Maker에 대한 내용을 출력하게 됩니다.

※ CarName에 대한 페이지 넘기기 설정은 보고서에 아무런 변화를 주지

않습니다.


FORCS Co., LTD 101

크로스탭 타이틀 형태 조정

행/열 타이틀

행/열 타이틀은 크로스탭 왼쪽 상단의 행과 열이 만나는 부분을 말하며

‘CTMainTitleShape’ 라벨이라고 합니다.

행/열 타이틀의 형태는 마법사에서 선택할 수 있는데 다음과 같은 세가지

타입이 있습니다.

Maker

102 FORCS Co., LTD

1 타이틀

행과 열에 대한 타이틀을 하나의 라벨로 표시합니다. 크로스탭 컴포넌

트 속성에서 [분리선 보이기]를 ‘예’로 설정하면 다음과 같이 출력됩니

다.


FORCS Co., LTD 103

수평으로

타이틀이 수평으로 생성됩니다.

수직으로

타이틀이 수직으로 생성됩니다.

제목 보기

값에 필드를 여러개 설정한 경우 값을 구분하기 위한 제목 보기를 선택할

수 있으며 형태에 따라 다음과 같이 두 가지로 구분됩니다.

104 FORCS Co., LTD

수직

수평


FORCS Co., LTD 105

헤더고정/위치고정 크로스탭 표에서 기준 필드들이 출력되는 부분을 크로스탭의 헤더라고 합니다.

표가 커져서 용지 한 장을 초과할 경우 다음장부터는 헤더 부분이 나타나지 않

게 되는데 크로스탭 속성의 [헤더고정]을 ‘예’로 설정하면 표가 계속되는 각 장

마다 헤더 부분을 출력할 수 있습니다.

<헤더 고정이 ‘예’ 경우>

또한 표가 옆으로 커져서 다음장으로 넘어갈 경우 다음장의 표 시작 위치는 용

지설정에서 설정한 용지의 왼쪽 여백만큼 띄우고 바로 시작하게 되는데 크로스

탭 속성의 [위치고정]을 ‘예’로 설정하면 첫번째장의 표 시작위치와 동일하게 출

력할 수 있습니다.

106 FORCS Co., LTD

2cm 2cm

2cm : 용지여백1cm+디자인여백1cm 용지여백1cm

디자인여백1cm

< 위치 고정이 ‘아니오’인 경우 >

< 위치 고정이 ‘예’인 경우 >


FORCS Co., LTD 107

그룹 리스트 형태 표 만들기

크로스탭에서 행이나 열 한쪽에서 기준 필드를 설정할 경우 옵션에 따라 그룹

리스트 형태 혹은 크로스탭 형태로 표를 출력할 수 있습니다.

<리스트 형태가 ‘예’인 경우> <리스트 형태가 ‘아니오’인 경우>

108 FORCS Co., LTD

차트 컴포넌트는 분석 및 통계보고서 작성시 크로스탭과 함께 가장 많이 사용되

는 컴포넌트로 데이터 셋을 이용하여 2차원, 3차원의 다양한 차트를 생성할 수 있습

니다.

차트 컴포넌트는 자체적으로 속성에서 [데이터 셋]을 설정할 수 있습니다. 마법사를

사용하기 전에 사용할 데이터 셋을 먼저 설정해야 합니다.

차트 분리 및 출력방향 조정 차트 컴포넌트는 설정값에 따라 여러개로 분리되어 출력되는데 차트 분리 및

분리된 차트의 출력방향에 대한 기본적인 룰은 다음과 같습니다.

분리조건 출력방향

X축에 두개 이상

의 필드를 선택했

을 경우

수평방향으로 출력됨

예) X축 항목에 년도와 월 두개의 필드가 선택되었을 경우

X축 필드의

데이터 항목

수가 [X축 최대

눈금수]를

초과했을 경우


예) X축 항목에 월 필드를 선택하고 [X축 최대 눈금수]를

6으로 설정한 경우

차트 컴포넌트

4월 2월 3월

2001년

1월 4월 2월 3월

2002년

1월

4월1월 2월 3월 5월 6월 10월 7월 8월 9월 11월 12월


FORCS Co., LTD 109

계열에 두개 이상

의 필드를 선택했

을 경우

수직방향으로 출력됨

예) 계열에 날짜와 노드 두개의 필드가 선택되었을 경우

계열에 필드의

데이터 항목수가

[최대계열수]를

초과했을 경우


예) 계열에 노드 필드를 선택하고 [최대계열수]를 2로 설

정한 경우

Y축에 두개 이상

의 필드가 선택되

고 계열에 한 개

이상의 필드가

선택된 경우

수직방향으로 출력됨

예) Y축에 평균, 최대값 두개의 필드가 선택되고 계열에

노드한 필드가 선택되었을 경우

노드1

노드2

노드3

2002-10-01

노드1

노드2

노드3

2002-10-02

노드1

노드2

노드3

노드4

평균

최대

노드 1

평균

최대

노드 2

110 FORCS Co., LTD

위에 설명된 차트 분리에 따른 출력방향은 [출력방향]에 속성값이 ‘양방향’인 경

우에 적용되는 기본 룰이며 [출력방향] 값은 사용자가 임의로 조정할 수 있습

니다.

출력방향 속성창 출력방향

양방향 위에서 정의한 기본 룰에 따라 출력

수직 룰에 관계없이 수직 방향으로만 출력

수평 룰에 관계없이 수평 방향으로만 출력

하나만 룰에 관계없이 하나만 출력

제한된 수평

룰에 관계없이 수평방향으로 용지 끝까지 반복하고 다시

왼쪽 하단으로 내려와 수평방향으로 반복해서 출력

제한된 수직

룰에 관계없이 수직방향으로 용지 끝까지 반복하고 다시

오른쪽 상단으로 올라가서 수직방향으로 반복해서 출력

① ②

③ ④

① ③

④②


FORCS Co., LTD 111

2중 Y축 차트

하나의 차트에서 2개의 Y축을 가지고 서로 다른 값을 표현할 수 있습니다.

112 FORCS Co., LTD

Y축 타이틀이나 주눈금 단위/수, 원점, 최소값, 최대값 등의 옵션을 각 축마다

따로 설정할 수 있습니다.


FORCS Co., LTD 113

Y축 최소/최대값 동적으로 바꾸기 Y축의 최소/최대값은 마법사에서 고정된 값으로 설정할 수 있습니다. 값을 설

정하지 않을 경우 데이터 값 중 가장 큰 값을 최대값으로, 가장 작은 값을 최

소값으로 자동 설정하여 차트를 출력합니다.

최소값 내림처리/최대값 올림처리

동적으로 최소/최대값을 설정할 경우 활용될 수 있습니다. 실제 데이터의

최소값과 최대값을 가져와 최소값에서 특정 자리수를 버림처리하고, 최대

값에서 특정 자리수를 올림처리하여 차트를 표현할 수 있습니다.

실제 데이터의 최소값 버림자리수 Y축 최소값

126 2 100

-126 2 -200

실제 데이터의 최대값 올림자리수 Y축 최대값

126 2 200

-126 2 -100

※ 데이터의 최소/최대값이 음수일 경우 버림과 올림은 반대로 적용됩니다.

버림자리수 (Y1, Y2)

올림자리수 (Y1, Y2)

114 FORCS Co., LTD

복합 X축 적용하기

X축에 두 개 이상의 필드를 설정한 경우 마지막 하위 두개의 필드 중 상위 필

드를 주눈금으로, 하위 필드를 보조눈금으로 하여 하나의 차트로 표현할 수 있

습니다. 복합 X축을 적용할 경우 주 눈금선과 보조 눈금선의 스타일을 다르게

설정하여 차트를 효과적으로 표현할 수 있습니다.


FORCS Co., LTD 115

< 복합 X축을 적용하지 않은 경우 >

< 복합 X축을 적용한 경우 >

sys 1

sys 2

sys 3

10월1일 10월2일 10월3일 10월4일

10월1일

1 2 3 4 5 6 7

10월2일

1 2 3 4 5 6

116 FORCS Co., LTD

라벨주기와 보조 눈금선

X축과 Y축 각각의 라벨이 출력되는 주기는 조정할 수 있습니다.

라벨주기를 1보다 큰 값으로 설정할 경우 라벨이 표시되는 지점의 눈금선이

주 눈금선이 되며, 표시되지 않는 지점의 눈금선이 보조 눈금선이 됩니다.

X축의 라벨주기를 5로 한 경우 다음과 같이 표시됩니다.

Y축의 라벨주기는 눈금단위와 눈금수의 설정값을 함께 고려해 주어야 합니다.

예를 들어 보조눈금 단위를 1로, 주눈금 단위를 10으로 하고자 할 경우는 Y축

라벨 주기를 10으로, 눈금단위를 1로 설정합니다.

10월1일 10월11일 10월6일


FORCS Co., LTD 117

X축 항목에 날짜나 숫자 타입 적용하기 X축 필드의 타입에 따라 다음과 같은 룰이 적용됩니다.

X축필드타입

구분 항목 숫자/날짜

X축 눈금

사이 간격

각 항목별로 동일하게 적용

항목

눈금 단위에 설정된 값의 간격과

비례하여 적용

날짜

X축 항목값

X축 필드의 데이터 값에

있는 항목만 출력됨

예) 실제 데이터에 1월, 2

월, 5월에 대한 데이터만

있을 경우

데이터 값에 관계가 없이 눈금단

위에 설정된 값에 따라 출력됨

예) 눈금단위가 월인 경우 데이

터에 1월, 5월, 7월에 대한 데이

터만 있을 경우

예)

라인 차트의 경우

1월 2월 5월

1월 2월 5월 3월 4월

1월 2월 5월 3월 4월

1 2 3 41 2 3

월4

118 FORCS Co., LTD

차트에 데이터 라벨 출력하기

차트의 데이터 값을 표현하기 위해 라벨을 출력할 수 있습니다.

[데이터 라벨 보기]에서 [보기]를 체크하면 기본적으로 Y축 데이터 값을 차트에

출력합니다. [라벨위치]는 여러가지 형태로 조정할 수 있습니다.

데이터 라벨을 출력할 계열 선택

[데이터 라벨 보기]를 선택하면 기본적으로 모든 계열에 데이터 값을 출력

하지만 특정 계열의 데이터 값만을 출력하고자 할 경우 계열 선택 버튼을

클릭하여 원하는 계열을 선택할 수 있습니다.

실제 계열의 데이터 값이나 개수를 디자

인시에는 알 수 없으므로 계열값을 순서

대로 ‘보기’ 또는 ‘감추기’ 하도록 설정합니

다. 예를 들어 ‘보기’, ‘감추기’, ’감추기’ 순

으로 설정할 경우 첫번째 계열은 데이터

라벨을 출력하고, 두번째/세번째 계열은

데이터 라벨을 출력하지 않습니다. 만약

설정하지 않은 네번째,/다섯번째 계열값이

존재한다면 기본적으로 데이터 라벨을 출

력합니다.


FORCS Co., LTD 119

데이터 라벨 값 바꾸기

데이터 라벨 값은 기본적으로 Y축 데이터 값을 표시하게 되는데 이 값을

다른 값으로 바꾸어 표시할 수 있습니다.

위의 마법사에서 라벨에 데이터 라벨로 표현하고자 하는 필드 값을 설정하

면 Y축 값 대신 해당 필드의 값을 데이터 라벨로 표시합니다. 또한 수식필

드를 이용하여 원하는 값을 조합하여 출력할 수 있습니다.

무늬 색상 변경 차트에 사용되는 막대와 점, 선 등의 색상, 면의 무늬, 점이나 선의 형태 등을

사용자가 원하는 형태로 바꿀 수 있습니다. 차트를 선택하고 오른쪽 마우스 버

튼을 클릭하여 차트 옵션창을 선택합니다.

120 FORCS Co., LTD

각 탭별로 왼쪽에 선택할 수 있는 색상이나

무늬가 나타납니다.

오른쪽으로 원하는 타입을 순서대로 옮깁니다.

설정된 타입은 계열값 순서대로 적용됩니다.

색을 제외하고 면이나 점, 선을 설정할 경우

차트의 [무늬] 속성을 ‘예’로 설정해야만 실제

차트에 적용됩니다.

색의 경우 [무늬] 속성과 관계없이 항상 적용

되며, 계열이 없을 경우 X축 항목값에 따라

설정한 색상이 순서대로 적용됩니다.

위와 같이 빨강, 노랑, 파랑순으로 색상을 설정할 경우 다음과 같이 차트가 표

시됩니다.

값1

값2

값3

계열

계열이 있는 경우

서울 부산

빨

노 파

빨 노

파

계열이 없는 경우

서울 부산

빨 노 파

대구


FORCS Co., LTD 121

※ 점 형태 중 ↓과 선들은 다음과 같이 사용됩니다.

↓ : 해당 점이 표시된 위치에서 X축과 만나는 수직선을 표시합니다.

선 : X축에 해당점이 표시되는 구간에 수평선을 표시합니다.

122 FORCS Co., LTD

툴팁 보여주기

차트에서 데이터 값을 표현하는 막대나 점 등에 마우스를 가져갈 때 데이터 값

에 대한 툴팁을 표시할 수 있습니다.

[툴팁]에서 [보기]를 체크하면 기본적으로 ’계열 /n X축 항목 /n Y축값’을 툴팁으

로 보여줍니다. [툴팁 경계선]은 막대나 점 등에 얼마나 가까이 마우스를 가져

가면 툴팁을 보여줄 것인지를 설정하게 됩니다. 해당 막대나 점에서의 [반경]을

픽셀 단위로 설정합니다.

툴팁에 나타나는 텍스트를 바꾸기 위해서는 스크립트를 이용하여 구현할 수 있

습니다. 툴팁을 스크립트로 변경하는 방법에 대해서는 “User Reference의 Ⅴ.

스크립트”를 참조하시기 바랍니다.


FORCS Co., LTD 123

사용자 정의 차트 사용자 정의 차트는 계열별로 막대나 라인, 점 등을 각각 선택하여 표현하는

차트를 말합니다.

마법사에서 사용자 정의 차트를 선택하고 원하는 차트 타입을 선택하면 계열

순서대로 Line, Scatter, Bar, Area, Step을 설정할 수 있는 창이 나타납니다.

124 FORCS Co., LTD

이 윈도우에서 설정한 순서대로 계열에 적용되며 만약 설정한 것보다 계열값이

더 많은 경우는 다시 한번 순서대로 반복해서 사용합니다.

사용자 정의 차트에서 Bar가 2개 이상인 경우 막대의 형태를 선택할 수 있습

니다.

<묶은 막대 형태로 구현된 차트> <누적 막대 형태로 구현된 차트>


FORCS Co., LTD 125

Ⅷ. Drill-Down and HyperLink

Drill-Down 보고서 제작

HyperLink 보고서 제작

126 FORCS Co., LTD

본 장에서는 오즈 디자이너로 제작한 보고서간의 연결방법과 다른 웹 페이지와의 연결방법

을 설명합니다.

Drill-Down

상위 보고서 내용에 대한 상세 정보를 검토하기 위해 하위 상세 보고서를 호출

하는 기능으로 보고서의 논리적인 연결 관계를 설정해 주는 보고서 링크 역할

을 합니다.

HyperLink

보고서에서 웹 페이지를 링크할 수 있는 기능입니다.

상위 보고서의 라벨이나 이미지, 차트 등을 클릭하여 연결된 하위 보고서를 볼 수 있

도록 제작할 수 있습니다. 하위 보고서에 대한 호출 정보는 스크립트를 통해 서버로

전달됩니다.

보고서 링크 기능을 수행하기 위한 스크립트 함수는 다음과 같습니다.

하위 보고서를 요청하기

위한 오즈 서버 주소 설정

setLinkServer(‘오즈서버명/IP’, ‘Port명’, ‘보고서명’)

setLinkServlet(‘Servlet URL’, ‘보고서명’)

하위 보고서에 전달할

패러미터값 설정 setLinkParam(‘패러미터명’, ‘값’)

하위 보고서 출력 옵션 설정 setLinkOption(‘옵션이름’, ‘값’)

다음은 차트나 데이터 라벨을 통해 링크되는 보고서 생성 과정입니다.

상위 보고서 세계 국가별 영업현황, 파이 차트로 국가별 영업현황을 보여주고 데이터 라벨

로 국가별 판매 합계를 표시합니다.

하위 보고서 특정 국가의 도시별 영업현황을 보여줍니다.

보고서 패러미터 : 국가명

Drill-Down 보고서 제작


FORCS Co., LTD 127

링크 로직

세계 영업현황 파이 차트의 특정 국가를 선택하면 해당 국가의 도시별

영업현황을 보여줍니다.

데이터 라벨로 표시된 특정 국가를 선택하면 해당 국가의 도시별 영업

현황을 보여줍니다.

상위 보고서 작성시 차트 그래프 및 데이터 라벨에 링크 스크립트를

적용합니다.

해당 차트와 데이터 라벨의 스크립트 속성에 다음과 같이 코드를

추가합니다.

Step 1

string Nation;

Nation = #country.country#;

string ip;

ip="http://oz.forcs.com:8080/oz25/serv

er";

setLinkServlet(ip,"kr/Drill_down_detail.

xml");

setLinkParam("courntry",Nation);

setLinkOption("displayname",Nation);

setLinkServlet("http://oz.forcs.com:8080/oz25/server","kr

/Drill_down_detail.xml");

setLinkParam("courntry",(string)getattr("Chart_tooltip_ro

wpivot"));

setLinkOption("displayname",(string)getattr("Chart_toolti

p_rowpivot"));

128 FORCS Co., LTD

하위 보고서를 작성합니다.

국가명을 보고서의 패러미터로 전달받아 해당 국가에 대한 데이터를

가져오도록 쿼리를 작성합니다.

Step 2


FORCS Co., LTD 129

Viewer 보기를 합니다.

Step 3

더블 클릭

했을 경우

130 FORCS Co., LTD

보고서의 특정 컴포넌트를 클릭하여 웹 페이지를 표시합니다. 웹 페이지 주소는 스크

립트를 통해 설정합니다.

웹 페이지 링크를 위한 스크립트는 다음과 같습니다.

웹 페이지 주소 설정 setLinkURL(‘웹페이지주소’, ‘Target옵션’)

보고서 작성시 일반 라벨에 링크 스크립트를 적용합니다.

HyperLink 보고서 제작

Step 1

setLinkURL("http://www.forcs.com","_blank");


FORCS Co., LTD 131

Viewer 보기를 합니다.

Step 2

클릭했을 경우

132 FORCS Co., LTD

Ⅸ. 스크립트

오즈 스크립트

스크립트 수행순서

에디터 사용법



FORCS Co., LTD 133

오즈는 다이나믹한 구조를 가진 양식을 구현하기 위해 자체 스크립트 언어인 오즈 스

크립트를 지원합니다. 오즈 스크립트의 문법 및 함수에 대한 자세한 사항은 “User

Reference Ⅴ. 스크립트”를 참조하시기 바랍니다.

오즈 스크립트는 데이터 셋, 밴드, 컴포넌트 단위로 스크립트 코드를 추가할 수 있습

니다.

데이터 셋에 적용된 오즈 스크립트는 오즈 서버에서 실행되며, 밴드와 컴포넌트에 적

용된 오즈 스크립트는 오즈 뷰어에서 실행됩니다. 실행순서는 밴드 스크립트 실행 후

밴드의 컴포넌트 스크립트를 실행합니다.

같은 밴드에서 컴포넌트의 스크립트 실행은 먼저 생성한 컴포넌트의 스크립트로부터

실행합니다.

밴드 실행순서 ①PageHeaderBnad → ②TitleBand → ③DataHeaderBand → ④dataBand

→ ⑤DataFooterBand → ⑥SummaryBand → ⑦TailBand

→ ⑧PageFooterBand

같은 밴드내에서 컴포넌트 실행순서 디자인시 생성한 순서대로 스크립트가 실행됩니다.

크로스탭의 스크립트 실행순서

크로스탭은 데이터 셋의 전체 데이터에 대해 행과

열에 설정된 필드 단위로 그룹핑 로직이 수행되기

때문에 크로스탭내 각 라벨 스크립트에서 해당 데

이터 셋의 필드값을 참조할 수 없습니다. 크로스탭내 라벨들의 스크립트 실행순서는 다음과

같습니다.

오즈 스크립트

스크립트 수행순서

134 FORCS Co., LTD

스크립트 작성은 밴드 또는 컴포넌트 단위별로 작성할 수 있습니다.

적용하고자 하는 밴드나 컴포넌트를 선택한 후 속성 창에서 [스크립트]를 더블 클릭

하면 다음과 같은 스크립트 에디터가 활성화 됩니다.

에디터 사용법


FORCS Co., LTD 135

스크립트 탐색기는 한 보고서내에 있는 스크립트들을 효과적으로 관리/제작하는 툴로

써 여러 스크립트를 보기 쉽게 관리할 뿐만 아니라 제작등에도 여러 편리한 기능을

제공합니다.

스크립트 탐색기 실행

메뉴의 [도구] – [스크립트 탐색기]를 클릭합니다.

스크립트 탐색기 구조


136 FORCS Co., LTD

스크립트 트리 각 라벨과 밴드들이 트리 형태로 나타납니다. 스크립트를 포함하고 있는 라벨

은 진하게 표시되며 해당 라벨을 클릭하면 스크립트 창에 해당 스크립트가 나

타납니다.

Search 창

Search Text in all components

검색어로 입력된 텍스트를 모든 스크립트 내에서 검색합니다. 변수명 등을

검색할 때 편리하게 이용할 수 있습니다.

Search Component by Name

컴포넌트의 이름으로 검색합니다. 스크립트를 포함한 라벨중에서 검색하게

되며, 컴포넌트의 수가 많은 복잡한 보고서에서도 이름만으로 쉽게 컴포넌

트를 찾을 수 있습니다.

스크립트 창

스크립트가 나타나는 창입니다. 직접 스크립트를 입력/수정할 수 있습니다.

마우스 오른쪽 버튼을 클릭하면 스크립트 작성에 도움이 되는 함수/명령어

등이 나타납니다. 원하는 정보나 함수 등을 선택하면 해당 함수가 표현되

며 디버그 창에 그 이용에 대한 설명이 나타납니다.


FORCS Co., LTD 137

DataBase : 데이터 셋 리스트와 데이터 셋별 필드정보를 보여줍니다.

Parameter : 보고서에서 사용자 정의된 패러미터 변수들을 보여줍니다.

System : 시스템 패러미터를 보여줍니다.

Functions : 수학, 문자, 그룹, 데이터베이스 I/O, comp.control. Date opr,

등에 사용되는 함수들을 보여줍니다.

LinkWizard : 링크 위저드로 연결됩니다.

디버그 창 문법 검사를 수행하면 작성한 스크립트에 대한 문법 체크 결과를 보여줍니다.

스크립트 창에서 마우스 오른쪽 버튼을 이용하여 함수를 가져올 경우 해당 함

수에 대한 설명이 나타납니다.

작업 리스트

다중 컴포넌트에 대한 스크립트를 각각 별도의 탭으로 보여줍니다.

138 FORCS Co., LTD

Ⅹ. Previewing Report

개요

파일관련

보기관련


FORCS Co., LTD 139

오즈 디자이너에서 작성된 보고서 양식은 오즈 뷰어를 통해 실행 결과를 확인할 수

있습니다.

또한 확인한 보고서를 인쇄하고 다양한 외부 데이터 형식 파일로 저장할 수 있습니다.

열기

*.ozz라는 오즈 자체 형식으로 저장된 파일을 열어 오즈 뷰어를 통해 보고서를

확인할 수 있습니다.

개요

파일관련

140 FORCS Co., LTD

인쇄

오즈 뷰어를 통해 나온 결과물을 실제 양식과 동일하게 출력합니다.

프린터, 용지크기, 인쇄영역을 지정할 수 있습니다.


FORCS Co., LTD 141

다중문서 보고서 트리를 이용하여 여러개의 보고서가 뷰어에 열려있는 경우

모든 보고서를 한꺼번에 인쇄할 수 있습니다.

일반 일반적인 인쇄 방식으로 용지 한장에 한 페이지씩

인쇄합니다. 인쇄형태

모아찍기 고급 인쇄 기능으로 용지 한장에 최대 4 페이지까지

인쇄합니다.

용지설정

보고서를 인쇄할 때 디자인시에 설정한 용지크기를 변경할 수 있

습니다. 인쇄할 용지를 선택하고 [고급]에서 [비율을 조절하여 인

쇄]를 체크하면 인쇄할 용지 크기에 맞추어 적절한 크기로 축소

또는 확대하여 출력합니다.

데이터 저장

오즈 뷰어로 미리보기 중인 보고서를 외부 문서 형식으로 사용자 PC에 저장합

니다. 오즈 뷰어의 [파일] – [리포트 저장] 메뉴를 선택하여 저장할 파일 형식 및

폴더를 지정합니다.

오즈는 txt, xls, pdf, csv, svg, jpg, html 등 다양한 외부 문서 형식 파일을 지원합

니다.

텍스트(txt) 파일이나 CSV 파일 또는 엑셀(xls) 파일로 저장하는 경우에는 [옵

션] 설정을 통해 저장형태를 지정합니다.

142 FORCS Co., LTD

<텍스트, CSV 저장시 옵션 화면>

<엑셀 저장시 옵션 화면>


FORCS Co., LTD 143

트리

리포트 양식을 트리 형태로 나타냅니다.

리포트 다시 받아오기

갱신주기를 주어 새로 데이터를 받아 옵니다. 갱신주기는 시:분:초 단위로 설정

합니다. 실시간으로 변경되고 있는 데이터에 대한 보고서를 보여줄 때 유용하

게 활용할 수 있습니다.

보기관련

144 FORCS Co., LTD

메모

출력된 결과물에 간단한 메모 등을 추가합니다.

패러미터 입력

패러미터를 새로 입력받아 데이터를 다시 받아와서 보고서를 보여줍니다.


FORCS Co., LTD 145

페이지 선택창

원하는 페이지로 이동하며 전체적인 리포트 구조를 확인할 수 있습니다.

축소, 확대, 복원

출력된 결과물을 축소, 확대, 복원 합니다.

<70% 축소>

146 FORCS Co., LTD

<160% 확대>

<100% 복원>


FORCS Co., LTD 147

XI. Dynamic Set

Dynamic Set의 개요

Dynamic 쿼리 리포트 제작

148 FORCS Co., LTD

Dynamic 쿼리 리포트 데이터에 대한 필드정보 등이 운영시에 동적으로 결정되는 보고서를 말합니다.

필드정보가 동적으로 변할 경우 디자인시에 필드의 개수나 필드명 등이 결정되

어 있지 않기 때문에 보고서에 들어갈 필드를 설정할 수 없게 됩니다. 이런 경

우 Dynamic Set을 이용하여 보고서를 제작할 수 있도록 합니다.

Dynamic Set이란? Dynamic 쿼리 리포트를 디자인하기 위해 고안된 기능입니다. DB 또는 UDS/

FILESTORE/HTTOSTORE를 통해 가져온 데이터를 Dynamic 쿼리 리포트를 구

성하기 위한 형태로 변경해 주는 것입니다.

Dynamic Set을 이용하면 어떤 Data Set이든 ROWIDX, COLUMN, VALUE의 세

가지 항목을 가진 형태로 만들어 집니다. 즉, 동적인 쿼리 등을 통해서 만들어

지는 필드정보 대신 Dynamic Set을 이용하여 설정된 ROWIDX, COLUMN,

VALUE 세 가지의 고정된 필드로 보고서를 디자인 할 수 있습니다.

예)

테이블 1 – 원본

Region Sales2000 Sales2001

캐나다 157000 890235

동부 5234991 5432123

중서부 1234789 1123454

남부 4563300 4992100

서부 3551090 3901234

위의 테이블 1을 Dynamic Set을 이용하여 변형시키면 테이블 2와 같은 구

성으로 바뀌게 됩니다.

ROWIDX는 실제 데이터 셋의 레코드 번호를 표시하고, COLUMN은 실제

데이터 셋의 컬럼명, VALUE는 해당 컬럼의 데이터 값을 표시합니다.

Dynamic Set의 개요


FORCS Co., LTD 149

테이블 2 – Dynamic Set을 이용하여 만든 테이블

ROWIDX COLUMN VALUE

0 Region 캐나다

0 Sales2000 257000

0 Sales2001 890235

1 Region 동부

1 Sales2000 5234991

1 Sales2001 5432123

2 Region 중서부

2 Sales2000 1234789

2 Sales2001 1123454

3 Region 남부

3 Sales2000 4563300

3 Sales2001 4992100

4 Region 서부

4 Sales2000 3551090

4 Sales2002 3901234

즉, 데이터를 가져와서 컬럼과 해당 정보를 나열해 주는 방식이 아니라

Row Index별, 컬럼명, 컬럼값 순으로 새로운 테이블 구조를 생성해 주는

것입니다.

150 FORCS Co., LTD

Dynamic 쿼리 리포트는 데이터베이스 뿐만 아니라 UDS/FILESTORE/HTTPSTORE

등의 모든 데이터 소스로부터 생성할 수 있습니다.

다음은 데이터베이스 소스를 이용하여 Dynamic 쿼리 리포트를 제작하는 과정으로 운

영시에 사용자가 원하는 테이블이나 컬럼을 선택하면 선택한 테이블의 데이터만 리스

트 형태로 출력하는 보고서를 작성합니다.

쿼리에 대한 패러미터 처리

동적인 쿼리 생성을 위해 쿼리 문장을 패러미터로 처리합니다.

패러미터 값 생성

다음과 같이 보고서 제목이나 쿼리를 동적으로 전달받기 위한 사용자 패러

미터를 생성합니다.

- adtitle : 보고서 제목

- adselect : 컬럼명 리스트

- adfrom : 테이블 이름

Dynamic Set 생성

데이터베이스로부터 다이나믹 셋을 설정합니다.

Dynamic 쿼리 리포트 제작

Step 1

Step 2


FORCS Co., LTD 151

[Dynamic Set 추가]를 선택하여 Dynamic Set을 생성합니다.

[Dynamic Set 이름]은 사용자가 임의로 지정합니다.

[ROWIDX 시작번호]는 Dynamic Set 생성시 ROW INDEX에 처음 시작되는

번호를 지정해 줍니다. 기본값으로 ‘0’이 설정되어 있으며, 각 ROW INDEX

는 0부터 차례로 번호가 부여됩니다.

[원본 Set 선택]을 클릭합니다.

원본 Set은 실제 데이터를 가져오기 위한 SQL 데이터를 데이터 셋에 연결

합니다.

FILESTORE나 HTTPSTORE를 이용할 경우는 XML/CSV Set을 연결합니다.

[SQL 데이터 정보]를 입력합니다.

152 FORCS Co., LTD

다음은 Select 문장으로 오즈 패러미터에서 받아온 테이블명과 컬럼명을

조합하여 작성한 쿼리 문장입니다.

select #OZParam.adselect# from #OZParam.adfrom#

[확인]을 클릭하여 디자이너로 돌아오면 다음과 같이 Dynamic Set이 생성

됩니다. 원본 Set은 트리에 나타나지 않습니다. 원본 Set의 수정은 해당

Dynamic Set 설정창을 통해서만 가능합니다.

보고서 디자인

타이틀 밴드에 패러미터 라벨 ‘adtitle’을 위치시켜 보고서 제목을 동적으

로 생성합니다. 데이터 밴드에 데이터 셋을 Dynamic Set으로 설정하고

크로스탭 컴포넌트를 생성합니다.

패러미터로 가져온 타이틀

크로스텝을 이용하여 작성

Step 3


FORCS Co., LTD 153

위와 같이 Dynamic Set을 통해 가져온 데이터를 크로스탭을 이용하여 리

스트 형태의 보고서로 제작할 수 있습니다.

154 FORCS Co., LTD

XII. Group Data Store

Group Data Store 개요

Group Data Store 생성


FORCS Co., LTD 155

Group Data Store는 하나의 데이터 셋을 다수의 데이터 셋으로 분할하기 위해 사용됩

니다. 다중 데이터 셋을 이용해야 하는 보고서에서 데이터를 한번에 하나의 데이터

셋으로 가져오는 것이 더 효율적인 경우 Group Data Store를 이용할 수 있습니다.

원본 데이터 셋 다중 데이터 셋으로 분할하기 위해 사용되는 데이터 셋을 원본 데이터 셋이라

합니다. 원본 데이터 셋은 Database, User Data Source, FILE/HTTP STORE의

다른 데이터 소스에서 생성된 데이터 셋을 사용할 수 있습니다.

단, 마스터 셋으로 사용되고 있는 데이터 셋만 원본으로 사용할 수 있으며 다

른 데이터 셋을 마스터로 하고 있는 셋은 원본으로 사용할 수 없습니다.

<원본으로 사용 가능한 셋> <원본으로 사용할 수 없는 셋>

쉐도우 데이터 셋 원본 데이터 셋을 분할해서 만든 데이터 셋들을 쉐도우 데이터 셋이라 합니다.

원본 데이터 셋으로부터 생성된 쉐도우 셋들은 일반 데이터 셋과 동일하게 사

용할 수 있습니다.

Group Data Store 개요

156 FORCS Co., LTD

데이터 셋 분할 원본 데이터 셋은 분할 조건문에 의해서 여러개의 쉐도우 셋으로 나눠지는데

다음과 같은 형태의 분할을 지원합니다.

수직분할

일반적으로 가장 많이 사용되는 형태로 하나의 데이터 셋으로 마스터-디테

일 관계의 보고서를 작성하기 위해 원본 셋을 마스터 쉐도우와 디테일 쉐

도우 셋으로 분할합니다.

부서별 사원 정보를 리스트 하는 다음과 같은 보고서가 있습니다.

위와 같은 보고서를 제작하기 위해 부서정보와 사원정보를 하나의 데이터

셋으로 생성합니다.

코드 부서명 부서위치 사원명 직급 급여

10 ACCOUNTING NEW YORK CLARK MANAGER 2572.2

10 ACCOUNTING NEW YORK KING PRESIDENT 5500

10 ACCOUNTING NEW YORK MILLER CLERK 920

20 RESEARCH DALLAS JONES MANAGER 3123.75

20 RESEARCH DALLAS CHAN ANALYST 3450


FORCS Co., LTD 157

30 SALES CHICAGO ALLEN SALESMAN 1600

30 SALES CHICAGO MARTIN SALESMAN 1312.5

위의 원본 데이터 셋을 수직분할하여 두개의 데이터 쉐도우 셋 즉, 부서

셋과 사원 셋으로 나눌 수 있으며 각 셋의 데이터와 분할 조건은 다음과

같습니다.

조건이 true인 경우 원본 셋에서 해당 셋으로 무조건 데이터를 가져옵니다.

조건식이 있을 경우 해당 조건식이 true가 될 경우만 해당 데이터 셋으로

데이터를 가져옵니다.

수평분할

하나의 데이터 셋이 서로 독립된 여러개의 셋으로 분할됩니다.

상품코드 상품명 단가 …

A FLAT TV 19” 500,000

A FLAT TV 21” 800,000

A FLAT TV 25” 1,500,000

B 광폭 타이어 100,000

B 광폭 타이어 V 180,000

C 사과맛 음료수 500

C 포도맛 음료수 500

…

CLARK, KING, MILLER

JOHNS, CHAN

ALLEN, MARTIN

ACCOUNT

RESEARCH

SALES

조건 : true 조건 : #부서 셋.부서코드#==#원본 셋.

부서코드#

<부서 셋> <사원 셋>

158 FORCS Co., LTD

원본 데이터 셋이 위와 같을 때 각 코드별로 보고서 양식에서 표현하는 형

태가 다를 경우 코드별로 데이터 셋을 분할해서 보고서를 작성합니다.

< A 셋 > (조건) #원본셋.코드# == “A”


A FLAT TV 19” 500,000

A FLAT TV 21” 800,000

A FLAT TV 25” 1,500,000

…

< B 셋 > (조건) #원본셋.코드# == “B”


B 광폭 타이어 100,000

B 광폭 타이어 V 180,000 …

< C 셋 > (조건) #원본셋.코드# == “C”


C 사과맛 음료수 500

C 포도맛 음료수 500 …

※수직분할과 수평분할을 혼합하여 사용할 수도 있습니다.


FORCS Co., LTD 159

원본 데이터 셋 생성 실제 데이터베이스나 UDS 등에서 실제 데이터를 가져오기 위한 원본 데이터

셋을 생성합니다.

그룹 데이터 정보 설정 Group Data Store에서 오른쪽 마우스를 클릭하여 [그룹 데이터 정보 추가]를 선

택하면 다음과 같이 원본 데이터 셋을 선택하기 위한 그룹 데이터 선택 창이

뜹니다. 원하는 원본 데이터 셋을 선택합니다.

Group Data Store 생성

160 FORCS Co., LTD

쉐도우 데이터 셋 생성 그룹 데이터 설정이 완료되면 해당 Group Data Store에서[그룹 데이터 추가]를

선택하여 쉐도우 셋을 설정합니다.

< 마스터 쉐도우 셋 – dept > < 디테일 쉐도우 셋 – emp >

<’사용할 필드’를 이용하여 필드를 설정하는 모습>

실행문에 원본 셋 분할을 위한 조건문을 입력하고 해당 쉐도우 셋에서 사용할

필드를 선택합니다. #dept.DEPTNO#==#DEPTNO#에서 #DEPTNO#는 원본 데

이터 셋의 이름이 생략된 형태입니다.


FORCS Co., LTD 161

< Group Data Store를 통해 만들어진 데이터 셋의 모습 >

162 FORCS Co., LTD

XIII. File/Http Store

File Store의 이용

Http Store의 이용


FORCS Co., LTD 163

FILE/HTTP Store는 일반 텍스트 파일이나 HTTP 표준 출력으로부터 데이터를 받아 처리하

기 위한 표준 방안입니다. 데이터는 특정 구분자로 각 필드가 구분된 CSV나 XML 형태를

지원합니다.

CSV 파일 규격 • 필드 정보 및 데이터를 포함합니다.

• 필드 정보는 필드명과 필드 타입으로 구성되며, 필드 타입 정보는 생략할

수 있습니다.

• 필드명, 필드 타입, 데이터 순으로 각각 새로운 라인으로 구분되어야 합니

다.

• 필드명과 필드명, 필드 타입과 필드 타입, 데이터와 데이터 사이는 동일

구분자를 이용하여 구분되어야 합니다.

다음은 ‘,’로 구분된 CSV 파일 샘플입니다．첫번째 라인이 필드명, 두번째 라

인이 필드 타입, 그 다음 라인부터가 데이터입니다. Region,Sales2000,Sales2001 Char,Int,Long 캐나다,157000,890235 동부,5234991,5432123 중서부,1234789,1123454 남부,4563300,4992100 서부,3551090,3901234

XML 파일 규격 • DTD가 없는 표준 XML 파일 규격을 따릅니다.

• 데이터 셋을 나타내는 노드를 포함하여야 합니다.

• 필드 정보를 나타내는 노드는 다음과 같은 형태로 기술되어야 하며 생략할

수 있습니다. <FIELDINFO> <FIELD NAME>=”field_name1” TYPE=”CHAR”/> <FIELD NAME>=”field_name1” TYPE=”CHAR”/> <FIELD NAME>=”field_name1” TYPE=”CHAR”/> <FIELD NAME>=”field_name2” TYPE=”INT”/> …. </FIELDINFO>

• 레코드 셋을 나타내는 노드를 포함하여야 합니다.

164 FORCS Co., LTD

다음은 데이터 셋 노드명이 ‘DATASET’, 레코드 셋 노드명이 ‘RECORD’이

고 필드 정보에 대한 노드도 포함되어 있는 XML 파일 샘플입니다. <?xml version="1.0" encoding="KSC5601"?> <XMLSET> <DATASET> <FIELDINFO> <FIELD NAME="Region" TYPE="CHAR"/> <FIELD NAME="Sales2000" TYPE="Int"/> <FIELD NAME="Sales2001" TYPE="Long"/> </FIELDINFO> <RECORD> <Region>캐나다</Region> <Sales2000>157000</Sales2000> <Sales2001>890235</Sales2001> </RECORD> <RECORD> <Region>동부</Region> <Sales2000>5234991</Sales2000> <Sales2001>5432123</Sales2001> </RECORD> <RECORD> <Region>중서부</Region> <Sales2000>1234789</Sales2000> <Sales2001>1123454</Sales2001> </RECORD> <RECORD> <Region>남부</Region> <Sales2000>4563300</Sales2000> <Sales2001>4992100</Sales2001> </RECORD> <RECORD> <Region>서부</Region> <Sales2000>3551090</Sales2000> <Sales2001>3901234</Sales2001> </RECORD> </DATASET> </XMLSET>

XML이나 CSV 파일에서 타입을 지정하기 위한 문자열들은 다음과 같습니

다. (※ 대소문자는 구별하지 않습니다.) BIT, TINYINT, SMALLINT, INT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, CHAR, VARCHAR, LONGVARCHAR, STRING, DECIMAL, NUMERIC, DATE, TIME, TIMESTAMP


FORCS Co., LTD 165

위의 CSV, XML 파일 샘플을 사용하여 FILESTORE나 HTTPSTORE를 설명하도록 하겠습니

다.

로컬 경로나 네트워크상에 연결된 파일로부터 데이터를 가져옵니다.

XML Set 오즈 디자이너의 데이터 소스 창에서 [FILESTORE] 항목을 오른쪽 마우스로

클릭한 후 [XML Set 추가]를 선택합니다.

File Store의 이용

166 FORCS Co., LTD

[XML Set 설정] 창이 아래와 같이 나타납니다.

XML Set 설정 윈도우 설명

항목 설명

FILE Store XML

DataSet 이름

해당 데이터 셋에 대한 이름으로 사용자가 임의로

부여합니다.

XML 파일 이름

(경로)

실제 서버에서 이용할 XML 파일의 경로와 이름입

니다.

디자인시 사용할

임시 XML 파일명

(경로)

오즈 서버와 디자이너에서 해당 XML 파일 경로가

다른 경우 디자인시에만 사용할 XML 파일의 임시

경로와 이름입니다.

DataSet 노드 이름해당 XML 파일에서 데이터 셋을 나타내는 노드

이름입니다. 기본값은 ‘DATASET’ 입니다.

RecordSet 노드

이름

해당 XML 파일에서 레코드 셋을 나타내는 노드

이름입니다. 기본값은 ‘RECORD’입니다.

해당 필드의 값을 입력하고 [데이터보기]를 이용하여 데이터를 확인합니다.


FORCS Co., LTD 167

[확인] 버튼을 눌러 디자이너로 돌아오면 [OZ DATA Tree]에 다음과 같이 필

드 정보가 생깁니다.

168 FORCS Co., LTD

CSV Set

오즈 디자이너의 데이터 소스 창에서 [FILESTORE] 항목을 오른쪽 마우스로

클릭한 후 [CSV Set 추가]를 선택합니다.

[CSV Set 설정] 창이 다음과 같이 나타납니다.


FORCS Co., LTD 169

CSV Set 설정 윈도우 설명

항목 설명

FILE Store CSV

DataSet 이름

해당 데이터 셋에 대한 이름으로 사용자가 임

의로 설정합니다.

CSV 파일이름 (경로) 실제 서버에서 사용할 CSV 파일의 경로와 이

름입니다.

디자인시 사용할 임시

CSV 파일명(경로)

오즈 서버와 디자이너에서 해당 CSV 파일의

경로가 다른 경우 디자인시에만 사용할 CSV

파일의 임시 경로와 이름입니다.

필드 구분자

필드 구분자를 선택합니다. TAB, SPACE,

SEMICOLON, COLON, COMMA는 미리 정의된

구분자로 선택 가능하며 기타 문자에 대해서는

사용자가 직접 입력해서 설정할 수 있습니다.

필드 정보 유무

해당 CSV 파일에 필드에 대한 타입 정보가

포함되어 있는지 유무를 선택합니다. ‘FALSE’

인 경우 모든 필드의 타입은 ‘VARCHAR’로 간

주됩니다. (TRUE/FALSE)

널 마크 NULL 데이터를 구분하기 위한 문자열을 정의

합니다.

Character Set

해당 파일의 문자셋을 정의합니다. 로컬 시스

템의 문자셋과 동일할 경우 설정하지 않아도

됩니다.

에러표시 코드

데이터 에러를 표시하기 위한 코드를 설정합니

다. 설정한 코드값이 파일의 첫 줄에 있을 경

우 보고서 미리보기를 수행하지 않고 ERROR

메시지 창을 뛰웁니다.

해당 필드의 값을 입력하고 [데이터보기]를 이용하여 데이터를 확인합니다..

170 FORCS Co., LTD

[확인] 버튼을 눌러 오즈 디자이너로 돌아오면 다음과 같이 [OZ DATA Tree]에

필드정보가 나타납니다.

Dynamic Set 추가 본 매뉴얼 “XI. Dynamic Set”을 참조하시기 바랍니다.


FORCS Co., LTD 171

HTTP 표준 출력으로부터 데이터를 가져옵니다. URL 경로에 있는 CSV, XML 파일 또

은 JSP나 ASP등의 사용자 애플리케이션 실행을 통해 브라우저에 출력되는 텍스트를

데이터 소스로 사용합니다. XML Set

다음과 같이 URL 경로를 통해 가져온 XML 파일을 HTTP STORE를 통해 연동

하는 방법을 설명합니다.

오즈 디자이너의 데이터 소스 창에서 [HTTPSTORE 소스] 항목을 오른쪽 마우

스로 클릭한 후 [XML Set 추가]를 선택합니다.

Http Store의 이용

172 FORCS Co., LTD

[XML Set 설정] 창이 아래와 같이 나타납니다.


FORCS Co., LTD 173

XML Set 설정 윈도우 설명

항목 설정

HTTP Store XML

DataSet 이름

해당 데이터 셋에 대한 이름으로 사용자가 임의

로 설정합니다.

Server URL 데이터를 가져올 파일 또는 사용자 애플리케이

션의 HTTP 주소입니다.

디자인시 사용할 임

시 XML 파일명(경로)

디자인시에만 사용할 수 있는 로컬 시스템의 파

일 경로와 이름입니다.

LOG 파일 이름

전달받은 데이터에 대한 로그를 남기기 원할 경

우 로그 파일명을 설정합니다. 설정하지 않을 경

우 로그를 남기지 않습니다.

URL 인코드 설정

Server URL 인코딩 유무를 설정합니다.

데이터 요청시 URL의 패러미터 부분에 한국어

나 기타 다국어 등이 포함되어 있을 경우 인코

딩을 ‘TRUE’로 설정합니다.

DataSet 노드 이름 해당 XML 파일에서 데이터 셋을 나타내는 노드

이름입니다. 기본값은 ‘DATASET’ 입니다.

RecordSet 노드

이름

해당 XML 파일에서 레코드 셋을 나타내는 노드

이름입니다. 기본값은 ‘RECORD’입니다.

POST 타입 전송 URL의 패러미터 전송시 GET 방식을 이용할 것

인지 POST 방식을 이용할 것인지 선택합니다.


174 FORCS Co., LTD

[확인] 버튼을 눌러 오즈 디자이너로 돌아오면 [OZ DATA Tree]에 새로운 필드

정보가 나타납니다.


FORCS Co., LTD 175

CSV Set 다음은 사용자 애플리케이션에서 CSV 형태로 HTTP를 통해 데이터를 보낼 때

연동하는 방법입니다.

<http를 이용하여 정보를 전달 받는 경우>

위의 브라우저에서 소스 보기를 이용하여 html 소스를 보면 파일은 다음과 같

이 “,”로 구분된 CSV 형태의 파일입니다.

오즈 디자이너의 데이터 소스 창에서 [HTTPSTORE] 항목을 오른쪽 마우스로

클릭한 후 [CSV Set 추가]를 선택합니다.

176 FORCS Co., LTD

[CVS Set 설정] 창이 아래와 같이 나타납니다.


FORCS Co., LTD 177

CSV Set 설정 윈도우 설명

항목 설정

HTTP Store CSV

DataSet 이름

해당 데이터 셋에 대한 이름으로 사용자가 임의

로 설정합니다.

Server URL 데이터를 가져올 파일 또는 사용자 애플리케이션

의 HTTP 주소입니다.

디자인시 사용할 임

시 CSV파일명 (경로)

디자인시에만 사용할 수 있는 로컬 시스템의 파

일 경로와 이름입니다.

Log 파일 이름

전달받은 데이터에 대한 로그를 남기기 원할 경

우 로그 파일을 설정합니다. 설정하지 않을 경우

로그를 남기지 않습니다.

URL 인코드

설정

Server URL 인코딩 유무를 설정합니다.

데이터 요청시 URL의 패러미터 부분에 한국어나

기타 다국어 등이 포함되어 있을 경우 인코딩을

‘TRUE’로 설정합니다.

필드 구분자

필드 구분자를 선택합니다. TAB, SPACE,

SEMICOLON, COLON, COMMA는 미리 정의된

구분자로 선택 가능하며 기타 문자에 대해서는

사용자가 직접 입력해서 설정할 수 있습니다.

필드 정보 유무

해당 CSV 파일에 필드에 대한 타입 정보가 포

함되어 있는지 유무를 선택합니다. ‘FALSE’인 경

우 모든 필드의 타입은 ‘VARCHAR’로 간주됩니

다. (TRUE/FALSE)

널 마크 NULL 데이터를 구분하기 위한 문자열을 정의

합니다.

Character Set

해당 파일의 문자 셋을 정의합니다. 로컬 시스템

의 문자 셋과 동일할 경우 설정하지 않아도 됩

니다.

에러표시 코드

데이터 에러를 표시하기 위한 코드를 설정합니

다. 설정한 코드값이 파일의 첫 줄에 있을 경우

보고서 미리보기를 수행하지 않고 ERROR 메시

지를 창에 뛰웁니다.

POST 타입 전송 URL의 패러미터 전송시 GET 방식을 이용할 것

인지 POST 방식을 이용할 것인지 선택합니다.

178 FORCS Co., LTD


<SQL 쿼리 결과>

[확인]을 눌러 디자이너로 돌아오면 [HTTPSTORE] 항목 아래에 다음과 같이

필드정보가 나타납니다.

Dynamic Set 추가

본 매뉴얼 “XI. Dynamic Set”을 참조하시기 바랍니다.


FORCS Co., LTD 179

XIV. UDS

UDS 개요

UDS 인터페이스

UDS 구현

UDS 활용

180 FORCS Co., LTD

UDS(User Data Source)는 오즈가 제공하는 Non-DB 데이터 연동을 위한 Java

Interface로 데이터베이스에 저장되어 있지 않은 일반 텍스트 파일, CSV, XML 등의

파일 데이터는 물론 EJB, Servlet, ASP, JSP, Applet 등 사용자 프로그램의 데이터 등

다양한 형태의 외부 데이터 소스로부터 데이터 셋을 생성하여 보고서를 생성할 수

있도록 합니다.

UDS 개발자는 자바를 이용하여 다양한 형태의 사용자 데이터를 받아 들이는 방법

과 이 데이터를 오즈가 인식할 수 있는 ResultSet 객체로 만들어서 오즈로 넘겨주는

방법을 구현해야 합니다. 이렇게 구현된 자바 프로그램은 클래스 파일로 만들어 보

고서와 연동하게 됩니다. UDS 데이터 셋은 일반 SQL 데이터 셋과 동일하게 사용할

수 있습니다.

오즈는 사용자 클래스로 패러미터 스트링을 전달할 수 있으며 패러미터 값에 따라

다이나믹하게 변화하는 데이터를 전달받을 수도 있습니다.

UDS 개요


FORCS Co., LTD 181

다음은 JDBC와 UDS 인터페이스를 비교 설명합니다.

OZ Server는 JDBC Driver를 통해 DBMS에 접속한 후 쿼리문을 전달하고 JDBC

Driver는 DBMS로부터 전달받은 쿼리 결과 데이터를 ResultSet 자바 객체에 담아 OZ

Server로 전달합니다.

이 ResultSet은 Java JDBC 사양에 따르면 java.sql.ResultSet Interface를 구현

(implement)한 것이어야 합니다. 즉, DBMS의 각 벤더들은 자신의 DBMS를 지원하는

JDBC Driver를 제공할 때 java.sql.ResultSet Interface를 구현한 Concrete ResultSet 클

래스를 같이 제공하는 것입니다. 이때 JDBC Driver를 제공하는 벤더가 반드시 지켜야

하는 것은 java.sql.ResultSet Interface를 따라 구현해야 하는 것입니다.

UDS(User Data Source)는 JDBC Driver의 역할을 하는 Custom Driver로 사용자가

java.sql.ResultSet interface를 따르면서 사용자 데이터 소스에 있는 데이터를 읽을 수

있는 ResultSet 클래스를 제공해 주는 것입니다.

JDBC Driver는 기능도 많고 복잡하여 구현하기가 힘듭니다. 그러나 오즈는 oz.uds.

UserDataStore라는 Interface를 제공하여 사용자가 UserDataStore Interface를 따르는

클래스와 ResultSet Interface를 따르는 클래스만 작성하면 어떠한 데이터 저장소와도

연동할 수 있도록 합니다. oz.uds.UserDataStore interface는 다음과 같이 단 4개의 메

소드만을 선언하고 있습니다.

package oz.uds;

import java.sql.*;

public interface OZUserDataStore {

public void init() throws OZUserDataStoreException;

public ResultSet getResultSet(String argument) throws

OZUserDataStoreException;

UDS 인터페이스

OZ Server

OZ Designer DBMS

JDBC DriverResultSet 객체

Query String

OZ Server

OZ Designer

사용자

데이터소스

Custom

JDBC

Driver Custom ResultSet 객체

실행문(패러미터)

182 FORCS Co., LTD

public void freeResultSet(ResultSet rst);

public void close();

}

이 중 init(), close()는 대부분의 경우 구현할 필요가 없습니다.

init() UDS가 처음 생성된 후 한번 호출되며, 사용자 데

이터 셋에 대한 초기화 작업을 수행합니다.

ResultSet getResultSet

(String argument)

오즈 서버나 디자이너로부터 Argument(실행문)을

넘겨받아 해당 실행문에 맞는 사용자 데이터를

ResultSet 객체로 변환하여 리턴합니다.

freeResultSet(ResultSet rst)

ResultSet의 종료 작업을 수행하며, 오즈 서버나

디자이너에 getResultSet에서 받은 ResultSet을 모

두 사용한 후 호출합니다.

close() UDS를 모두 사용한 후 마지막으로 호출되며, 사

용자 데이터 셋에 대한 종료 작업을 수행합니다.

UDS 구현에서 가장 중요한 부분은 실제 데이터를 받아오는데 필요한 getResultSet

메소드를 구현하는 것입니다.

UDS Source 구성 UDS Main 구현

오즈 서버나 디자이너에서 넘겨준 Argument에 따라 사용자 데이터를 받아

오는 부분을 구현합니다. import oz.uds.*; import java.sql.ResultSet; public class Extdata implements OZUserDataStore{ public void init() throws OZUserDataStoreException { // UDS 가 처음 생성된 후 한번 호출됩니다. DB 연결 등의 초기화 작업을 수행합니다. } public ResultSet getResultSet(String argument) throws OZUserDataStoreException { // Argument 에 따라서 사용자 데이터를 받고 Resultset 으로 변환 후 리턴합니다.

UDS 구현


FORCS Co., LTD 183

// Argument 는 OZ 디자이너에서 보고서 디자인 시에 넘기도록 설정합니다. } public void freeResultSet(ResultSet rst){ // getResultSet 에서 받아온 ResultSet 을 모두 사용한 후 호출합니다. // 일반적으로 ResultSet 을 Close 하는 작업을 수행합니다. } public void close() { // UserDataSet 을 모두 사용한 후 호출합니다. // 일반적으로 DB Disconnection 이나 등의 종료작업을 수행합니다. } }

사용자 ResultSet 구현

사용자 프로그램에서 ResultSet 객체를 바로 넘겨 받을 수 있다면 별도의

ResultSet을 구현할 필요가 없습니다. 그러나 일반적으로 사용자 애플리케

이션은 백터나 스트림 형태로 데이터를 넘겨주기 때문에 다음과 같이

ResultSet을 구현해야 합니다. (다음에 명시된 메소드들은 오즈에 의해 호

출되는 함수를 중심으로 작성되었습니다.)

JDBC의 javasql.ResultSet Interface는 30여개가 넘는 메소드를 정의하고

있지만 오즈 UDS는 그 중 실제로 필요한 몇 개의 메소드만을 구현하고

나머지 메소드는 그대로 추가하면 됩니다. import java.sql.*; import java.math.BigDecimal; import java.util.Calendar; import java.util.Enumeration; public class ResultSet_User implements ResultSet{ public ResultSet_User( ) { } public boolean next() throws SQLException{ // 다음 레코드의 인덱스 값을 리턴한다. } public String getString(String columnName) throws SQLException{ // 컬럼명으로 해당 데이터를 리턴한다. } // getString 외에 사용자의 데이터 타입에 따라 다음과 같은 Method 를 추가 구현할 수 있다. // getBoolean(String columnName) // getByte(String columnName)

184 FORCS Co., LTD

// getShort(String columnName) // getInt(String columnName // getLong(String columnName // getFloat(String columnName) // getDouble(String columnName // getBigDecimal(String columnName) // getDate(String columnName) // getTime(String columnName) // getTimestamp(String columnName) // getBlob(String columnName) // getClob(String columnName) // getBinaryStream(String columnName) public ResultSetMetaData getMetaData() throws SQLException{ // ResultSetMetaData 를 리턴하고 ResultSetMetaData 의 특정 Method 도 역시 필요 시 // 구현해야 합니다. } }

ResultSetMetaData 구현

ResultSetMetaData에는 데이터에 대한 컬럼명과 타입 정보를 반환하기 위

해 다음 세가지 메소드가 구현되어야 합니다. import java.sql.SQLException; import java.sql.Types; import java.util.*; public class ResultSetMetaData_User implements ResultSetMetaData{ public ResultSetMetaData_LGeds(String[] meta) { } public int getColumnCount() throws SQLException{ // 컬럼 개수를 리턴한다. } public String getColumnName(int column) throws SQLException{ // 해당 정수값(column)번째 컬럼명을 리턴한다. } public int getColumnType(int column) throws SQLException{ // 해당 정수값(column)번째 컬럼의 타입을 리턴한다 } }


FORCS Co., LTD 185

UDS 예제 소스

텍스트 파일 데이터 소스

첫 라인에 탭으로 구분된 컬럼명이 있고, 다음 라인부터는 탭으로 구분된

데이터를 포함하고 있는 파일을 읽어 처리하는 UDS 구현 예제입니다. <UdsFile.java> import oz.uds.*; import java.sql.ResultSet; import java.io.FileReader; import java.io.IOException; import java.util.StringTokenizer; import java.util.Vector; public class UdsFile implements OZUserDataStore{ private StringBuffer Sbuffer; private Vector mainV; //subV 를 저장한다. private Vector subV; private String[][] data; private String[] meta; private static final String rootFileName = ""; private static final String mainDiv = "\n"; private static final String subDiv = "\,"; public void init() throws OZUserDataStoreException { mainV = new Vector(); } public ResultSet getResultSet(String command) throws OZUserDataStoreException { FileReader in = null; Sbuffer = new StringBuffer(); try{ in = new FileReader(rootFileName + command); char[] buffer = new char[256]; int n; while((n = in.read(buffer)) > -1){ Sbuffer.append(new String(buffer, 0, n)); } } catch(IOException e){ e.printStackTrace(); throw new OZUserDataStoreException(e.getMessage()); } finally {

186 FORCS Co., LTD

try{ if(in != null)in.close(); } catch(IOException e){ } finally{ in = null; } } String s = Sbuffer.toString();

////////////////////////////////////////////////////////////////////////////// StringTokenizer st1 = new StringTokenizer(s,mainDiv); StringTokenizer st2; String tmpString; /////////////////////meta 정보////////////////////// if(st1.hasMoreTokens()){ tmpString = st1.nextToken().trim(); st2 = new StringTokenizer(tmpString,subDiv); subV = new Vector(); while (st2.hasMoreTokens()){ subV.addElement(st2.nextToken().trim()); } meta = new String[subV.size()]; subV.copyInto(meta); } //////////////////////////////////////////////// while (st1.hasMoreTokens()) { tmpString = st1.nextToken().trim(); st2 = new StringTokenizer(tmpString,subDiv); subV = new Vector(); while (st2.hasMoreTokens()){ subV.addElement(st2.nextToken().trim()); } mainV.addElement(subV); } data = new String[mainV.size()][]; for(int i = 0; i < mainV.size(); i++){ subV = (Vector)mainV.elementAt(i); data[i] = new String[subV.size()]; subV.copyInto(data[i]); } Sbuffer = null; mainV.clear(); /////////////////////////확인/////////////////////////////// if(meta == null || data == null){ throw new OZUserDataStoreException("Data is Invalide"); }


FORCS Co., LTD 187

return new ResultSet_File(meta, data); } public void freeResultSet(ResultSet rst){ Sbuffer = null; data = null; meta = null; mainV.clear(); } public void close() { Sbuffer = null; data = null; meta = null; mainV = null; } } <ResultSet_File.java> import java.sql.*; import java.math.BigDecimal; import java.util.Calendar; import java.util.Enumeration; public class ResultSet_File implements ResultSet{ private String[][] data; private String[] meta; private int index; private int size; public ResultSet_File(String[] meta, String[][] data) { this.meta = meta; this.data = data; size = data.length; index = -1; } public boolean next() throws SQLException{ index++; if(index == size) return false; return true; } public String getString(String columnName) throws SQLException{ int i = findIndex(columnName); if(i > -1){ try{

188 FORCS Co., LTD

return data[index][i]; }catch(Exception e){ throw new SQLException("Internal Error"); } }else{ return null; } } private final int findIndex(String columnName){ for(int i = 0; i < meta.length; i++){ if(columnName.equals(meta[i])){ return i; } } return -1; } public String getString(int columnIndex) throws SQLException{ return null; } public ResultSetMetaData getMetaData() throws SQLException{ return new ResultSetMetaData_File(meta); } ////////////////////////////////////////////////////////////////////////////// 아래의 메소드들은 구현할 필요없이 그대로 추가합니다. public boolean getBoolean(String columnName) throws SQLException{ return false; } public byte getByte(String columnName) throws SQLException{ return -1; } public short getShort(String columnName) throws SQLException{ return -1; } public int getInt(String columnName) throws SQLException{ return -1; } public long getLong(String columnName) throws SQLException{ return -1; } public float getFloat(String columnName) throws SQLException{ return -1; } public double getDouble(String columnName) throws SQLException{ return -1; }


FORCS Co., LTD 189

public BigDecimal getBigDecimal(String columnName) throws SQLException{ return null; } public java.sql.Date getDate(String columnName) throws SQLException{ return null; } public java.sql.Time getTime(String columnName) throws SQLException{ return null; } public java.sql.Timestamp getTimestamp(String columnName)

throws SQLException{ return null; } public Blob getBlob(String columnName) throws SQLException{ return null; } public Clob getClob(String columnName) throws SQLException{ return null; } public java.io.InputStream getBinaryStream(String columnName) throws SQLException{ return null; }

///////////////////////////////////////////////////////////////////////////////////////// public boolean getBoolean(int columnIndex) throws SQLException{return false;} public byte getByte(int columnIndex) throws SQLException{return -1;} public short getShort(int columnIndex) throws SQLException{return -1;} public int getInt(int columnIndex) throws SQLException{return -1;} public long getLong(int columnIndex) throws SQLException{return -1;} public float getFloat(int columnIndex) throws SQLException{return -1;} public double getDouble(int columnIndex) throws SQLException{return -1;} public BigDecimal getBigDecimal(int columnIndex) throws

SQLException{return null;} public java.sql.Date getDate(int columnIndex) throws SQLException{return null;} public java.sql.Time getTime(int columnIndex) throws SQLException{return null;} public java.sql.Timestamp getTimestamp(int columnIndex)

throws SQLException{return null;} public Blob getBlob(int columnIndex) throws SQLException{return null;} public Clob getClob(int columnIndex) throws SQLException{return null;} public java.io.InputStream getBinaryStream(int columnIndex) throws SQLException{return null;}

/////////////////////////////////////////////////////////////////////////////////////////// public void close() throws SQLException{} public boolean wasNull() throws SQLException{return false;} public byte[] getBytes(int columnIndex) throws SQLException{return null;}

190 FORCS Co., LTD

public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException{ return null;} public java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException{return null;}

public byte[] getBytes(String columnName) throws SQLException{return null;} public java.io.InputStream getAsciiStream(String columnName) throws

SQLException{return null;} public java.io.InputStream getUnicodeStream(String columnName) throws

SQLException{return null;} public SQLWarning getWarnings() throws SQLException{return null;} public void clearWarnings() throws SQLException{} public String getCursorName() throws SQLException{return null;} public Object getObject(int columnIndex) throws SQLException{return null;} public Object getObject(String columnName) throws SQLException{return null;} public int findColumn(String columnName) throws SQLException{return -1;} public java.io.Reader getCharacterStream(int columnIndex) throws

SQLException{return null;} public java.io.Reader getCharacterStream(String columnName) throws

SQLException{return null;} public BigDecimal getBigDecimal(int columnIndex, int scale) throws

SQLException{return null;} public BigDecimal getBigDecimal(String columnName, int scale) throws

SQLException{return null;} public boolean isBeforeFirst() throws SQLException{return false;} public boolean isAfterLast() throws SQLException{return false;} public boolean isFirst() throws SQLException{return false;} public boolean isLast() throws SQLException{return false;} public void beforeFirst() throws SQLException{} public void afterLast() throws SQLException{} public boolean first() throws SQLException{return false;} public boolean last() throws SQLException{return false;} public int getRow() throws SQLException{return -1;} public boolean absolute( int row ) throws SQLException{return false;} public boolean relative( int rows ) throws SQLException{return false;} public boolean previous() throws SQLException{return false;} public void setFetchDirection(int direction) throws SQLException{} public int getFetchDirection() throws SQLException{return -1;} public void setFetchSize(int rows) throws SQLException{} public int getFetchSize() throws SQLException{return -1;} public int getType() throws SQLException{return -1;} public int getConcurrency() throws SQLException{return -1;} public boolean rowUpdated() throws SQLException{return false;} public boolean rowInserted() throws SQLException{return false;} public boolean rowDeleted() throws SQLException{return false;}

public Statement getStatement() throws SQLException{return null;}


FORCS Co., LTD 191

public Object getObject(int i, java.util.Map map) throws SQLException{return null;} public Ref getRef(int i) throws SQLException{return null;} public Array getArray(int i) throws SQLException{return null;} public Object getObject(String colName, java.util.Map map) throws

SQLException{return null;} public Ref getRef(String colName) throws SQLException{return null;}

public Array getArray(String colName) throws SQLException{return null;} public java.sql.Date getDate(int columnIndex, Calendar cal) throws

SQLException{return null;} public java.sql.Date getDate(String columnName, Calendar cal) throws

SQLException{return null;} public java.sql.Time getTime(int columnIndex, Calendar cal) throws

SQLException{return null;} public java.sql.Time getTime(String columnName, Calendar cal) throws

SQLException{return null;} public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException{return null;} public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException{return null;}

///////////////////////////////////////////////////////////////////////////////////// public void updateNull(int columnIndex) throws SQLException{} public void updateBoolean(int columnIndex, boolean x) throws SQLException{} public void updateByte(int columnIndex, byte x) throws SQLException{} public void updateShort(int columnIndex, short x) throws SQLException{} public void updateInt(int columnIndex, int x) throws SQLException{} public void updateLong(int columnIndex, long x) throws SQLException{} public void updateFloat(int columnIndex, float x) throws SQLException{} public void updateDouble(int columnIndex, double x) throws SQLException{} public void updateBigDecimal(int columnIndex, BigDecimal x) throws

SQLException{} public void updateString(int columnIndex, String x) throws SQLException{} public void updateBytes(int columnIndex, byte x[]) throws SQLException{} public void updateDate(int columnIndex, java.sql.Date x) throws SQLException{} public void updateTime(int columnIndex, java.sql.Time x) throws SQLException{} public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException{} public void updateAsciiStream(int columnIndex, java.io.InputStream x, int length)

throws SQLException{} public void updateBinaryStream(int columnIndex, java.io.InputStream x, int length)

throws SQLException{} public void updateCharacterStream(int columnIndex, java.io.Reader x, int length)

throws SQLException{} public void updateObject(int columnIndex, Object x, int scale) throws

SQLException{} public void updateObject(int columnIndex, Object x) throws SQLException{}

192 FORCS Co., LTD

public void updateNull(String columnName) throws SQLException{} public void updateBoolean(String columnName, boolean x) throws

SQLException{} public void updateByte(String columnName, byte x) throws SQLException{} public void updateShort(String columnName, short x) throws SQLException{} public void updateInt(String columnName, int x) throws SQLException{} public void updateLong(String columnName, long x) throws SQLException{}

public void updateFloat(String columnName, float x) throws SQLException{} public void updateDouble(String columnName, double x) throws SQLException{} public void updateBigDecimal(String columnName, BigDecimal x) throws

SQLException{} public void updateString(String columnName, String x) throws SQLException{} public void updateBytes(String columnName, byte x[]) throws SQLException{} public void updateDate(String columnName, java.sql.Date x) throws

SQLException{} public void updateTime(String columnName, java.sql.Time x) throws

SQLException{} public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException{} public void updateAsciiStream(String columnName, java.io.InputStream x, int length) throws SQLException{} public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException{} public void updateCharacterStream(String columnName, java.io.Reader reader, int length) throws SQLException{} public void updateObject(String columnName, Object x, int scale) throws SQLException{} public void updateObject(String columnName, Object x) throws SQLException{} public void insertRow() throws SQLException{} public void updateRow() throws SQLException{} public void deleteRow() throws SQLException{} public void refreshRow() throws SQLException{} public void cancelRowUpdates() throws SQLException{} public void moveToInsertRow() throws SQLException{} public void moveToCurrentRow() throws SQLException{} /////////////////////////////////////////////////////////////////////////////////////////// } <ResultMetaData_File.java> import java.sql.ResultSetMetaData; import java.sql.SQLException; import java.sql.Types; import java.util.*;


FORCS Co., LTD 193

public class ResultSetMetaData_File implements ResultSetMetaData{ String[] meta; public ResultSetMetaData_File(String[] meta) { this.meta = meta; } public int getColumnCount() throws SQLException{ return meta.length; } public String getColumnName(int column) throws SQLException{ if(0 < column && column < getColumnCount()+1){ return meta[column-1]; }else{ throw new SQLException(); } } public int getColumnType(int column) throws SQLException{ return Types.VARCHAR; } public int isNullable(int column) throws SQLException{return -1;} public int getColumnDisplaySize(int column) throws SQLException{return -1;} public int getPrecision(int column) throws SQLException{return -1;} public int getScale(int column) throws SQLException{return -1;} public boolean isAutoIncrement(int column) throws SQLException{return false;} public boolean isCaseSensitive(int column) throws SQLException{return false;} public boolean isSearchable(int column) throws SQLException{return false;} public boolean isCurrency(int column) throws SQLException{return false;} public boolean isSigned(int column) throws SQLException{return false;} public boolean isReadOnly(int column) throws SQLException{return false;} public boolean isWritable(int column) throws SQLException{return false;} public boolean isDefinitelyWritable(int column) throws SQLException{return false;} public String getColumnLabel(int column) throws SQLException{return null;} public String getSchemaName(int column) throws SQLException{return null;} public String getTableName(int column) throws SQLException{return null;} public String getCatalogName(int column) throws SQLException{return null;} public String getColumnTypeName(int column) throws SQLException{return null;} public String getColumnClassName(int column) throws SQLException{return null;} }

194 FORCS Co., LTD

사용자 클래스는 보고서를 제작하는 중에는 오즈 디자이너에 의해 호출되고, 실제 웹

상에서 보고서 서비스를 제공하는 중에는 오즈 서버에 의해 호출됩니다. 따라서 각

모듈이 설치된 로컬 시스템에 위치해야 하며 실행 환경이 정확하게 설정되어 있어야

합니다.

또한 오즈 디자이너와 오즈 서버는 실행 환경에 차이가 있기 때문에 사용하는 사용자

클래스 역시 구현에 일부 차이가 있을 수 있습니다.

오즈 디자이너 및 오즈 서버 실행 파일에서 CLASSPATH에 사용자 클래스 파일 위치

를 설정합니다.

보통 클래스로 만들어지는 경우는 CLASSPATH만 추가하면 되고, UDS에서 사용되는

일련의 클래스들을 jar 파일로 만들었다면 CLASSPATH에 묶여진 jar파일을 등록하면

됩니다.

다음은 윈도우 환경에서 오즈 디자이너가 설치된 디렉토리의 ozuds\uds라는 디렉토

리 아래에 사용자 클래스 파일이 존재할 경우 오즈 디자이너 실행 배치 파일을 작성

하는 예입니다. (jar파일은 마찬가지로 jar파일 이름까지 등록하면 됩니다.)

Set CLASSPATH=.\;.\ozuds;.\OZD25.jar;.\OZUDS.jar;.\Lib\jaxp.jar; .\Lib\parser.jar;.\log4j.jar java –cp CLASSPATH oz.designer.OZDesigner 서버에서도 마찬가지로 위와 같이 CLASSPATH에 추가하면 됩니다.

단, 데몬(Daemon)방식인 경우 ozcntrl.bat(.sh)안에서 CLASSPATH를 등록하고, 서블릿

(Servlet)방식인 경우 서블릿을 구동하는 WAS에서 CLASSPATH를 잡아주거나, 오즈

서블릿 디렉토리/WEB-INF/classes 디렉토리 아래에 UDS class 파일을 위치 시킵니다.

UDS 활용


FORCS Co., LTD 195

보고서 작성

[User_Data_Store] 항목을 오른쪽 마우스로 클릭한 후 [사용자 데이터

정보 추가]를 선택합니다.

사용자 데이터베이스 연결 정보를 설정합니다.

Step 1

Step 2

196 FORCS Co., LTD

[SET 데이터 추가]를 선택합니다.

[사용자 정의 셋 설정]에서 정보창에 불러올 사용자 정의 데이터 정보

를 설정합니다. (UDS에 따라 실행문에 입력되는 내용이 적절하게 변경

되어져야 합니다.)

파일 UDS의 경우 실행문에는 일반적으로 파일 경로를 설정합니다. [실

행] 버튼을 누르면 다음과 같은 결과를 볼 수 있습니다.

Step 3

Step 4


FORCS Co., LTD 197

< UDS를 이용하여 가져온 값의 예 >

보고서 형태 디자인

사용자 데이터 셋이 설정되면 사용자 데이터에 대한 필드 이름이 트리

형태로 리스트 됩니다. 보고서 형태에 따라 여러개의 사용자 데이터

셋을 설정할 수 있으며 데이터베이스 연동시와 동일하게 다양한 형태

의 보고서를 제작할 수 있습니다.

Step 5

198 FORCS Co., LTD

XV. OZ FTA

오즈 FTA 운영 흐름도

오즈 FTA 기능

오즈 FTA 실행


FORCS Co., LTD 199

본 장에서는 오즈 전용 파일전송 프로그램인 OZ FTA(File Transfer Agent)에 대해 설명합니

다. OZ FTA(File Transfer Agent)는 오즈 디자이너에서 오즈 서버로 보고서 양식을 전송하는

기능을 담당하며 오즈 디자이너에 통합된 형태로 제공됩니다.

오즈 서버에 연결하면 서버의 보고서 루트 디렉토리에 바로 접근할 수 있으며, 오즈 보고서

폼 파일만 업로드/다운로드 할 수 있습니다.

오즈 FTA는 일반적인 FTP Client의 기능을 가지고 있습니다. 단, 오즈 보고서 양식

파일을 위해 제작되었기 때문에 XML 파일만을 전송합니다. 또한 오즈 FTA는 ‘서버

파일 삭제’ / ‘remove’라는 기능을 제공하여 서버에서 단순히 보고서 폼을 삭제하는 것

이외에도 캐시와 스케줄러에 저장되어 있는 파일까지도 삭제할 수 있습니다.

• 서버의 파일 업로드/다운로드 기본 폴더는 ozserver_home/conf/rptmngr.properties

에 등록된 경로명이 됩니다.

• 로컬 파일 업로드/다운로드 기본 폴더는 오즈 FTA가 설치되어 있는 폴더입니다.

• 서버/로컬 양쪽 모두 XML 파일만을 업로드/다운로드 할 수 있습니다.

• 서버로 업로드시 해당 폼 파일에 대한 압축된 폼 파일을 자동으로 생성합니다.

오즈 FTA 운영 흐름도

오즈 FTA 기능

OZ Server

FTP API OZ Designer OZ

FTA

File System

File System

File IO

Access

Login & Connection

File IO Access

File Transfer

200 FORCS Co., LTD

전체화면 구성

Login Panel 사용자 ID와 패스워드를 입력할 수 있으며 서버와 접속

및 연결해제를 수행합니다.

설정 언어, 테이블 라인보기, 기본 디렉토리, 마우스 클릭횟수

등의 설정을 할 수 있습니다.

Server List Panel 등록된 서버 목록을 보여줍니다.

Local Panel Client 파일 정보를 관리합니다.

Server Panel Server 파일 정보를 관리합니다.

Up/Down Panel 파일 업로드/다운로드 처리를 합니다.

>,< 선택된 파일을 전송합니다. (Ctrl키를 이용하여 복수개의

파일 선택 가능)

>>,<< 해당 디렉토리 내의 모든 XML 파일을 전송합니다.

서버파일 삭제 서버내의 모든 캐시/스케줄러 보고서를 삭제합니다.


FORCS Co., LTD 201

Remove 체크박스 표시한 XML 보고서 폼에 대해서만 서버로 전송하면서 동

시에 캐시/스케줄된 해당 보고서 정보를 지웁니다.

새폴더 새로운 폴더를 생성합니다.

* 자세한 속성 설명은 “User Reference”를 참조하시기 바랍니다.

OZFTP.bat 파일을 실행하거나 오즈 디자이너 [파일] – [FTP 서버연결] 메뉴

를 실행하면 다음과 같은 화면이 나타납니다.

오즈 FTA 실행

Step 1

202 FORCS Co., LTD

사용자 이름과 패스워드 및 오즈 서버의 IP, PORT 정보를 입력한 후 [접

속]을 클릭합니다.

등록

서버등록

OZ FTA를 사용하기 위해서는 기본적으로 서버 등록이 이루어져야 합

니다. 따라서 OZ FTA에는 서버타입, 서버이름, 서버 IP 또는 URL, 서

버포트, 사용자 이름, 패스워드 등의 정보가 필요합니다.

사용자 등록

기본 사용자 이름과 패스워드는 admin, admin입니다. 사용자 등록을

추가하거나 수정할 경우에는 엔터프라이즈 매니저를 이용하여 변경해

야 합니다. 사용자 등록에 관한 자세한 설명은 “Server Administrator

Guide”를 참조하시기 바랍니다.

Step 2


FORCS Co., LTD 203

사용할 파일을 선택하여 업로드/다운로드 합니다.

기본적으로 선택된 파일은 [>] 버튼을 통해 전송됩니다. 2개 이상의 파일을

선택할때는 Ctrl키를 누른 상태에서 다수의 파일을 선택하면 됩니다.

[>>] 버튼은 해당 디렉토리의 모든 폼 파일을 전송합니다.

[새로고침] 버튼은 로컬 컴퓨터와 서버쪽 컴퓨터 두 곳의 정보를 새로 가

져와 보여줍니다.

[Remove]란에 체크한 후 전송하면 스케줄러와 캐시에 보관되어 있는 파일

들이 전부 삭제됩니다.

[서버파일 삭제]란은 일괄적으로 모든 스케줄러와 캐시에 보관되어 있는

파일을 삭제합니다.

새폴더를 만들때는 [새폴더] 항목에 이름을 입력한 후 [새폴더] 버튼을 누

르면 새로운 폴더가 생성됩니다.

Step 3

204 FORCS Co., LTD

한번 FTA에서 서버 연결이 된 상태에서 오즈 디자이너에서 현재 편집 완

료된 보고서를 서버로 전송할 경우 [파일] – [서버로 전송]을 실행하면 바로

전송할 수 있습니다.

Step 4


FORCS Co., LTD 205

XVI. OZ Publishing Wizard

Publishing Wizard 개요

메뉴 구성

Publishing Wizard 실행

206 FORCS Co., LTD

오즈 Publidhing Wizard는 사용자 웹 애플리케이션에서 오즈 보고서를 호출하는

HTML, ASP, JSP 소스 코드를 자동 생성해 줍니다.

Publishing Wizard는 오즈 뷰어 호출과 관련된 160여가지의 다양한 옵션 설정 기능을

제공합니다. 오즈 뷰어 옵션에 대한 상세한 정보는 “Viewer Guide Ⅳ. 애플릿 태그”를

참조하시기 바랍니다.

<오즈 Publishing Wizard>

리포트 파일 이름 퍼블리싱 위저드에서 생성할 보고서 폼 파일의 xml

이름입니다.

실행 파일로부터 로드설정 내용을 담고 있는 항목 파일을 불러와 그 설정

값을 로드할 수 있게 합니다.

OZ Server Type 오즈 엔터프라이즈 서버의 타입을 정합니다.

(Daemon형과 Servlet형)

Publishing Wizard 개요


FORCS Co., LTD 207

Server IP 데몬형의 경우 이용할 IP 주소를 입력합니다.

Server Port 데몬형의 경우 이용할 포트 번호를 입력합니다. 기

본값은 8002번 입니다.

Servlet URL 서블릿형의 경우 오즈 엔터프라이즈 서버의 URL을

입력합니다.

리포트 그룹 오즈 뷰어 라이브러리의 버전 이름입니다.

(인증 애플릿 이용시만 해당 됩니다.)

리포트 패러미터 리포트 패러미터 정보를 나타냅니다. 해당 패러미터

의 값을 임의로 입력할 수 있습니다.

파일메뉴

HTML 파일

새 HTML 파일

새로운 HTML/ASP/JSP 소스 파일을 만듭니다.

HTML 파일 수정

기존에 생성된 HTML/ASP/JSP 소스 파일을 열어 내용을 변경합니다.

항목 파일

항목 파일은 보고서에 자주 이용되는 서버 이름, 포트 번호 그리고 각종

패러미터 값들을 저장한 텍스트 파일(.txt)입니다. 이 파일을 이용하면 매번

동일한 내용을 지정해야 하는 번거로움을 줄일 수 있습니다.

새항목 파일

새항목 파일을 만듭니다.

항목 파일 수정

생성된 항목 파일(.txt)을 수정합니다.

메뉴 구성

208 FORCS Co., LTD

저장 (Ctrl + S)

HTML 파일의 생성/변경, 항목 파일의 생성/변경 후 변경된 내용을 저장합

니다.

[파일] 메뉴에서 [저장] 메뉴를 선택하면 실제 생성되는 웹 애플리케이션

문서를 보여 주는 다음과 같은 화면이 나타납니다.

<생성된 소스 코드 화면>

[옵션] 버튼을 클릭하면 [옵션] – [저장 옵션]한 화면이 나타나고 문서를 수

정할 수 있습니다.

[저장] 버튼을 클릭하면 파일로 저장합니다.

[취소] 버튼을 클릭하면 추가 편집 내용을 취소합니다.

닫기

Publishing Wizard를 종료합니다.


FORCS Co., LTD 209

옵션 메뉴

저장 옵션

저장 옵션 기능 설명

OZ Server IP 오즈 서버의 IP 주소를 입력합니다. (데몬형)

OZ Server Port 오즈 서버의 Port 번호를 입력합니다.

(데몬 타입)

OZ Server URL 오즈 서버의 URL을 입력합니다. (서블릿 타입)

Object Tag UseObject 태그를 이용하여 소스 코드를 생성합니

다.

Singed applet 인증 애플릿으로 호출합니다.

Name Space 오즈 버전 정보입니다.


Uses Library

Version

오즈 뷰어 라이브러리의 버전 이름입니다.


Code Base 오즈 뷰어 cab 파일(ozapplet4IE.cab)의 웹 경로

입니다.

210 FORCS Co., LTD

저장 형식 HTML/JSP/ASP 등의 지정한 언어로 소스 코드

를 생성합니다.

FORM

하단부 FORM은 JSP/ASP로 소스 생성시 패러

미터 값을 넘겨받을 때 이용되는 부분입니다.

JSP/ASP 프로그램에 맞게 임의로 수정할 수 있

습니다.

[자세히>>] 오즈 뷰어 호출과 관련된 160여가지 애플릿 패러미터를 설정합니다. 각 패러미

터에 대한 자세한 설명은 “Viewer Guide”를 참고하시기 바랍니다.

오즈 디자이너 메뉴 중 [파일] – [배포]를 클릭하여 오즈 서버의 타입을 지

정한 후 정보를 입력합니다.

Publishing Wizard 실행

Step 1


FORCS Co., LTD 211

[자세히>>]를 클릭하여 오즈 뷰어를 제어하기 위한 애플릿 태그들을 생성

합니다.

[확인] 버튼을 클릭한 후 [파일] – [저장]을 선택합니다.

Step 2

Step 3

212 FORCS Co., LTD

[저장 옵션]에서 서버 IP, 포트 또는 URL과 각 정보들을 입력한 후 [확인]

버튼을 클릭합니다.

웹 애플리케이션 문서로 저장합니다.

Step 4

Step 5


FORCS Co., LTD 213

<Publishing Wizard로 생성된 소스로 보여지는 오즈 리포트>

214 FORCS Co., LTD

XVII. 널(Null) 데이터 처리

데이터 소스에서 Null 처리

컴포넌트별 Null 처리


FORCS Co., LTD 215

널(Null) 데이터란 지정되지 않은 값 즉, 정의되지 않은 상태를 표시할 목적으로 특수하게

사용하는 데이터입니다. 이러한 Null 데이터는 처리 방법에 따라 아주 상이한 결과를 산출

할 수 있기 때문에 시스템마다 Null 데이터 처리에 대한 규칙을 준비해 놓고 있습니다.

이 장에서는 오즈의 Null 데이터 처리 규칙에 대해 상세히 설명합니다.

다음은 데이터 소스의 Null 데이터 처리 규칙입니다.

디자이너 OZ DATA Tree의 속성 창에서 [Null 데이터 무시] 부분을 ‘아니

오’로 설정한 경우에만 Null 데이터 검사가 가능합니다.

• 데이터베이스의 Null 데이터는 Null로 인식합니다.

• XML Set의 원본 XML 파일에 데이터가 없으면 Null 데이터로 인식합니

다.

• CSV Set의 원본 CSV 파일에 데이터가 없으면 문자형일 경우 공백 문

자열로 인식하고, 숫자형일 경우는 Null 데이터로 인식합니다.

• CSV Set 설정시 널 마크에 지정한 NULL STRING 값을 가지는 데이터

는 무조건 Null 데이터로 인식합니다.

[Null 데이터 무시] 속성이 ‘예’인 경우는 문자형 필드는 공백 문자열을,

숫자형 필드인 경우에는 0값이 지정됩니다.

데이터 라벨 (Data Label) 데이터 값이 Nulll일 경우 미리보기시에 데이터 라벨의 Caption에 'null data' 라

고 출력됩니다. 이는 디버깅 편의성을 위해 제공하는 것으로 스크립트로 Null

값을 검사하여 원하는 값으로 재설정 할 수 있습니다.

데이터 소스에서 Null 처리

컴포넌트별 Null 데이터 처리

216 FORCS Co., LTD

다음은 Null 데이터를 검사하여 처리하는 스크립트의 예입니다.

널 값이 나올 경우 ‘데이터없음’이 인쇄되는 스크립트

if(getData("dset.feild") == null)

{

setattr("caption", "데이터 없음")

}

※ 스크립트 작성시 Null 값을 특정 변수에 대입할 수 없습니다.

int i; i = null; // Error

수식 라벨 (Expression Label) SUM, AVG, MAX, MIN 등의 함수를 사용할 때 Null 데이터가 있으면 에러로 처

리됩니다. 따라서 Null 데이터에 대한 사전처리가 요구됩니다.

크로스탭 (CrossTab) 데이터 값이 Null일 경우 크로스탭의 각 셀에는 공백을 출력합니다. SUM, AVG,

MAX, MIN 함수를 사용하면 Null 값을 제외하고 합계, 평균, 최대, 최소값을 출

력합니다. 한편, 데이터가 모두 null일 때는 SUM, AVG, MAX, MIN 함수는 공백

을 출력합니다.

차트 (Chart) 라인 타입의 그래프 경우 데이터가 Null인 구간에 대해서는 그래프가 끊어져서

그려지고 막대 등의 나머지 타입의 경우는 나타나지 않습니다.

널 값이 X축 항목인 경우

레코드가 없거나 데이터 값이 없는(Null인 경우) 구간에 대해 라인/영역 그

래프가 끊어지면서 그려집니다.

X축이 숫자나 날짜인 경우

레코드가 없는 구간에 대해서는 연결해서 그립니다.

데이터 값이 없는(Null인) 구간에 대해서는 끊어서 그립니다.

예) 같은 값의 데이터도 데이터 전달 형태에 따라 다음과 같이 다른 형

태로 그려집니다.


FORCS Co., LTD 217

3

4

NULL

7

2

5

6

NULL

1

2

3

4

B_Value A_ValueX

1 2 3 4 5

109876543211 2 3 4 5

10987654321

A

B A

B

2

3

5

4

6

7

Value

A

B

A

B

A

B

1

1

2

2

3

4

TypeX

Ⅰ 시작하기 전에 Ⅱ 디자이너 설치 윈도우 › ozguide › OLD › manual › OZ2.5_Manual › UserGuide.pdfDrill-Down and Hyper Link Design 서로 연관된 보고서간의

Documents