EzReport

EzReport

Reporting 호출 컴포넌트

  • 넥사크로 - 리포팅툴 간 호환용 공용 어뎁터로 넥사크로 컴포넌트를 제공하지 않는 리포팅툴을 넥사크로에 호환시키기 위해 사용하는 컴포넌트입니다.
  • 실제 리포팅 툴에 사용 가능한 옵션은 리포팅 툴 별로 상이함으로 직접적으로 프로퍼티에 노출되지 않습니다.
  • 자체적으로 넥사크로 컴포넌트를 제공하는 리포팅 툴의 경우, 해당 컴포넌트를 사용하세요

Constructor

new EzReport()

Author:
  • 정민석(whitn86@gmail.com)

Members

beforeDraw :string

Description:
  • 호출한 리포트 전처리내용

    • JSON형식의 문자열로 key는 함수명 value는 파라미터로 보낼 값의 배열이어야 합니다.
      ex) '{"hideToolbarItem" :[["save"]]}';
    • 호출할 리포트 jsp 페이지의 객체의 함수를 리포트를 그리기 전에 실행합니다.
      ex) report["hideToolbarItem"].apply(report, [["save"]]);
    • 문자열 대신 object로 세팅하려면 setBeforeDraw함수를 사용하세요

호출한 리포트 전처리내용

  • JSON형식의 문자열로 key는 함수명 value는 파라미터로 보낼 값의 배열이어야 합니다.
    ex) '{"hideToolbarItem" :[["save"]]}';
  • 호출할 리포트 jsp 페이지의 객체의 함수를 리포트를 그리기 전에 실행합니다.
    ex) report["hideToolbarItem"].apply(report, [["save"]]);
  • 문자열 대신 object로 세팅하려면 setBeforeDraw함수를 사용하세요
Type:
  • string
Example
var row = this.ezReport.beforeDraw;
this.ezReport.beforeDraw = '{"hideToolbarItem" :[["save"]]}';

conditionDiv :string

Description:
  • 조회조건 Div 경로

    • 조회 조건 Div 설정시 해당 Div내의 value값을 가진 컴포넌트를 이용해 파라미터를 동적 생성합니다.
      경로는 넥사크로툴에서 Div 선택후 ctrl+shift+c 키로 복사 가능합니다.
    • 경로 대신 Div를 직접 바인딩 할 경우 setConditionDiv함수를 사용하세요

조회조건 Div 경로

  • 조회 조건 Div 설정시 해당 Div내의 value값을 가진 컴포넌트를 이용해 파라미터를 동적 생성합니다.
    경로는 넥사크로툴에서 Div 선택후 ctrl+shift+c 키로 복사 가능합니다.
  • 경로 대신 Div를 직접 바인딩 할 경우 setConditionDiv함수를 사용하세요
Type:
  • string
Example
var divPath = this.ezReport.conditionDiv;
	this.ezReport.conditionDiv = "div00";

filepath :string

Description:
  • 호출할 리포트 파일의 경로

호출할 리포트 파일의 경로

Type:
  • string
Example
var url = this.ezReport.filepath;
this.ezReport.filepath = "/test/test.report";

option :string

Description:
  • EzReport 호출 시 리포팅 툴에 적용할 옵션 값

    • JSON 형식의 문자열 설정
      ex) '{"enableNote": true, "scrollbarOnNote":{"width":"50px", "color":"rgba(255,17,245,0.7)"}}'
    • 호출할 리포트 jsp페이지안의 리포트 툴 객체의 값에 직접 값이 설정됨
      ex) report["enableNote"] = true;
    • 적용가능한 옵션의 종류 및 값은 리포트툴별로 상이합니다. 각 리포트툴의 가이드 참조 바랍니다.

EzReport 호출 시 리포팅 툴에 적용할 옵션 값

  • JSON 형식의 문자열 설정
    ex) '{"enableNote": true, "scrollbarOnNote":{"width":"50px", "color":"rgba(255,17,245,0.7)"}}'
  • 호출할 리포트 jsp페이지안의 리포트 툴 객체의 값에 직접 값이 설정됨
    ex) report["enableNote"] = true;
  • 적용가능한 옵션의 종류 및 값은 리포트툴별로 상이합니다. 각 리포트툴의 가이드 참조 바랍니다.
Type:
  • string
Example
var row = this.ezReport.option;
this.ezReport.option = '{"enableNote": true }';

param :string

Description:
  • 리포트 호출시 추가로 보낼 파라미터
    nexacro 파라미터 규칙을 따름

리포트 호출시 추가로 보낼 파라미터
nexacro 파라미터 규칙을 따름

Type:
  • string
Example
var param = this.ezReport.param;
this.ezReport.param = "CD='0001' CD_NM='TEST'";

paramdatasetrow :number

Description:
  • paramdataset으로 설정된 Dataset의 행 중 파라미터로 보낼 행

    • 미설정시 paramdataset의 현재 행이 파라미터로 보내짐
    • 여러 행을 기입할 경우 값이 배열로 넘어갑니다.
      ex) { CD:[0000,0001,0002] }

paramdataset으로 설정된 Dataset의 행 중 파라미터로 보낼 행

  • 미설정시 paramdataset의 현재 행이 파라미터로 보내짐
  • 여러 행을 기입할 경우 값이 배열로 넘어갑니다.
    ex) { CD:[0000,0001,0002] }
Type:
  • number
Example
var row = this.ezReport.paramdatasetrow;
this.ezReport.paramdatasetrow = 3;

serverurl :string

Description:
  • report 호출시 서버 경로
    미설정시 TypeDefinition에 설정된 경로 값을 따릅니다.

report 호출시 서버 경로
미설정시 TypeDefinition에 설정된 경로 값을 따릅니다.

Type:
  • string
Example
var url = this.ezReport.serverurl;
this.ezReport.serverurl = "http://localhost:8080/report/report.jsp";

(static, readonly) LOG_KEY :string

Description:
  • 로깅용 키

로깅용 키

Type:
  • string

(static, readonly) keySession :string

Description:
  • 클라이언트에서 기억하는 session id를 리포팅툴에 전달할 때 사용되는 키

클라이언트에서 기억하는 session id를 리포팅툴에 전달할 때 사용되는 키

Type:
  • string

(static, readonly) mapKeyProgInfo :string

Description:
  • 클라이언트에서 기억하는 화면 정보를 리포팅툴에 전달할 때 사용되는 키

클라이언트에서 기억하는 화면 정보를 리포팅툴에 전달할 때 사용되는 키

Type:
  • string

(static, readonly) mapKeyUserInfo :string

Description:
  • 클라이언트에서 기억하는 사용자 정보를 리포팅툴에 전달할 때 사용되는 키

클라이언트에서 기억하는 사용자 정보를 리포팅툴에 전달할 때 사용되는 키

Type:
  • string

Methods

initReport() → {Promise}

Description:
  • 리포트 내용 초기화

Example
this.ezReport.initReport();
Returns:

초기화 수행 결과 Promise

Type
Promise

open(formopt) → {Promise}

Description:
  • 리포트 내용 초기화

Example
this.ezReport.open(this);
Parameters:
Name Type Attributes Description
form nexacro.Form <optional>

리포트 호출시 부모폼, 미기입시 해당 EzReport객체의 최상위 폼

Returns:

리포트 호출 결과 Promise

Type
Promise

setAfterDraw(afterDraw)

Description:
  • 호출한 리포트 전처리내용을 설정
    호출할 리포트 jsp 페이지의 객체의 함수를 리포트가 그려진 뒤에 실행합니다.

Example
this.ezReport.setAfterDraw({"hideToolbarItem" :[["save"]]});
Parameters:
Name Type Description
afterDraw Object

key는 함수명 value는 파라미터로 보낼 값의 배열이어야 합니다.
ex) {"hideToolbarItem" :[["save"]]} 일 경우 report["hideToolbarItem"].apply(report, [["save"]]); 가 실행됨

setBeforeDraw(v)

Description:
  • 호출한 리포트 전처리내용을 설정
    호출할 리포트 jsp 페이지의 객체의 함수를 리포트를 그리기 전에 실행합니다.

Example
this.ezReport.setBeforeDraw({"hideToolbarItem" :[["save"]]});
Parameters:
Name Type Description
v Object

key는 함수명 value는 파라미터로 보낼 값의 배열이어야 합니다.
ex) {"hideToolbarItem" :[["save"]]} 일 경우 report["hideToolbarItem"].apply(report, [["save"]]); 가 실행됨

setConditionDiv(div)

Description:
  • 조회조건 Div 설정 조회 조건 Div 설정시 해당 Div내의 value값을 가진 컴포넌트를 이용해 파라미터를 동적 생성합니다.

Example
this.ezReport.setConditionDiv(this.div00);
Parameters:
Name Type Description
div nexacro.Div

조회 조건 컴포넌트들이 있는 Div

setParamDataset(ds)

Description:
  • report 호출시 파라미터로 전달할 값을 가진 Dataset을 설정
    해당 Dataset의 현재 선택된 행이 파라미터로 전달됨

Example
this.ezReport.setParamDataset(this.ds_report);
Parameters:
Name Type Description
ds nexacro.Dataset

파라미터로 사용할 Dataset

set_afterDraw(afterDraw)

Description:
  • 호출한 리포트 후처리내용 설정

    • 문자열 대신 object로 세팅하려면 afterDraw함수를 사용하세요
Example
this.ezReport.set_afterDraw('{"hideToolbarItem" :[["save"]]}');
Parameters:
Name Type Description
afterDraw String

호출한 리포트 후처리내용

  • JSON형식의 문자열로 key는 함수명 value는 파라미터로 보낼 값의 배열이어야 합니다. ex) '{"hideToolbarItem" :[["save"]]}';
  • 호출할 리포트 jsp 페이지의 객체의 함수를 리포트를 그린 후에 실행합니다. ex) report["hideToolbarItem"].apply(report, [["save"]]);

set_conditionDiv(conditionDiv)

Description:
  • 조회조건 Div 경로 설정

    • 조회 조건 Div 설정시 해당 Div내의 value값을 가진 컴포넌트를 이용해 파라미터를 동적 생성합니다.
      경로는 넥사크로툴에서 Div 선택후 ctrl+shift+c 키로 복사 가능합니다.
    • 경로 대신 Div를 직접 바인딩 할 경우 setConditionDiv함수를 사용하세요
Example
this.ezReport.set_conditionDiv("div00");
Parameters:
Name Type Description
conditionDiv string

조회조건 Div 경로

set_filepath(filepath)

Description:
  • 호출할 리포트 파일의 경로 설정

Example
this.ezReport.set_filepath("/test/test.report");
Parameters:
Name Type Description
filepath string

호출할 리포트 파일의 경로

set_option(option)

Description:
  • EzReport 호출 시 리포팅 툴에 적용할 옵션 값 설정

Example
this.ezReport.set_option('{"enableNote": true }');
Parameters:
Name Type Description
option string

EzReport 호출 시 리포팅 툴에 적용할 옵션 값

  • JSON 형식의 문자열 설정
    ex) '{"enableNote": true, "scrollbarOnNote":{"width":"50px", "color":"rgba(255,17,245,0.7)"}}'
  • 호출할 리포트 jsp페이지안의 리포트 툴 객체의 값에 직접 값이 설정됨
    ex) report["enableNote"] = true;
  • 적용가능한 옵션의 종류 및 값은 리포트툴별로 상이합니다. 각 리포트툴의 가이드 참조 바랍니다.

set_param(param)

Description:
  • 리포트 호출시 추가로 보낼 파라미터 설정

Example
this.ezReport.set_param("CD='0001' CD_NM='TEST'");
Parameters:
Name Type Description
param string

리포트 호출시 추가로 보낼 파라미터
nexacro 파라미터 규칙을 따름

set_paramcolumnorder(paramcolumnorder)

Description:
  • 칼럼중 실제 파라미터로 보낼 칼럼명 순서 설정
    입력된 값이 없을 경우 dataset의 모든 값을 파라미터로 보냄

Example
this.ezReport.set_paramcolumnorder("CD,CD_NM");
Parameters:
Name Type Description
paramcolumnorder string

dataset의 칼럼중 실제 파라미터로 보낼 칼럼명 순서

set_paramdataset(paramdataset)

Description:
  • report 호출시 파라미터로 전달할 값을 가진 Dataset 명칭 설정 Dataset을 직접 세팅할 경우 setParamDataset함수를 사용하세요

Example
this.ezReport.set_paramdataset("ds_report");
Parameters:
Name Type Description
paramdataset string

report 호출시 파라미터로 전달할 값을 가진 Dataset 명칭

  • paramdatasetrow값이 설정되어있을경우 해당 값의 행이 파라미터로 전달됨
  • paramdatasetrow값이 설정되어있지 않을 경우 해당 Dataset의 현재 선택된 행(rowposition)이 파라미터로 전달됨

set_paramdatasetrow(paramdatasetrow)

Description:
  • paramdataset으로 설정된 Dataset의 행 중 파라미터로 보낼 행 설정

    • 미설정시 paramdataset의 현재 행이 파라미터로 보내짐
    • 여러 행을 기입할 경우 값이 배열로 넘어갑니다.
      ex) { CD:[0000,0001,0002] }
Example
this.ezReport.set_paramdatasetrow(3);
Parameters:
Name Type Description
paramdatasetrow number

파라미터로 보낼 행

set_serverurl(serverurl)

Description:
  • report 호출시 서버 경로 설정
    미설정시 TypeDefinition에 설정된 경로 값을 따릅니다.

Example
this.ezReport.set_serverurl("http://localhost:8080/report/report.jsp");
Parameters:
Name Type Description
serverurl string

report 호출시 서버 경로