Description

화면에 표시되는 그리드를 엑셀 등의 외부 문서로 내보기할 때 지정하는 설정 모델.

Properties

type
Type: string
Default: “excel”
내보내기 문서 타입.

target
Type: string
Default: “remote”
문서를 로컬에 직접 저장할 지 혹은, 서버를 경유해서 저장할 지를 지정한다. “remote”와 “local”을 지정할 수 있다.

url
Type: string
Default: null
그리드가 내보내는 문서 스트림을 전송 받은 후 다시 사용자 컴퓨터에 내려 주는 서버의 url.

fileName
Type: string
Default: null
export 시 저장될 파일 이름.

linear
Type: boolean
Default: false
컬럼 그룹을 해제하고 export 할 것인지의 여부.
JS Ver.만 지원

allItems
Type: Boolean
감춰진 모든 행을 출력할것인지의 여부

indicator
Type: string
Default: “default”
그리드 Indicator 영역을 문서에 포함할 것인 지를 지정한다. “default”이면 현재 그리드에 표시된 상태를 따르고, “visible”이면 무조건 포함하고, “hidden”이면 무조건 포함시키지 않는다.

header
Type: string
Default: “default” 그리드 Header 영역을 문서에 포함할 것인 지를 지정한다. “default”이면 현재 그리드에 표시된 상태를 따르고, “visible”이면 무조건 포함하고, “hidden”이면 무조건 포함시키지 않는다.

footer
Type: string
Default: “default”
그리드 Footer 영역을 문서에 포함할 것인 지를 지정한다. “default”이면 현재 그리드에 표시된 상태를 따르고, “visible”이면 무조건 포함하고, “hidden”이면 무조건 포함시키지 않는다.

indenting
Type: boolean
Default: true
행 그룹핑 및 트리 그리드 자료를 export 시 들여쓰기 여부를 지정한다.
JS Ver.만 지원

showConfirm
Type:Boolean
Default: true
메세지 상자를 표시한다.

confirmMessage
Type: string
Default: “Excel 문서로 저장하시겠습니까?”
메세지 상자에 표시될 문자열을 입력한다.
RealGridPlus(flash) 버전에서만 지원한다.

confirmTitle
Type: string
Default: “Excel 저장”
메세지 상자에 표시될 Title을 입력한다.
RealGridPlus(flash) 버전에서만 지원한다.

lookupDisplay
Type: boolean
column의 lookupDisplay 값을 표시된 값으로의 저장 여부

datetimeFormat
Type: string
Default: undefined
이 값이 지정되면 datetime 필드의 값을 출력할 때 변환 형식으로 사용된다. 지정되지 않은 경우 데이터필드에 설정된 값을 사용한다.
JS Ver.만 지원

booleanFormat
Type: string
Default: undefined
이 값이 지정되면 datetime 필드의 값을 출력할 때 변환 형식으로 사용된다. 지정되지 않은 경우 데이터필드에 설정된 값을 사용한다.
JS Ver.만 지원

datetimeCallback
Type: function (index, column, value)
Default: undefined
datetime 필드 출력시 수행될 콜백함수를 지정한다. 원하는 형태로 지정 가능하다.
JS Ver.만 지원

booleanCallback
Type: function (index, column, value)
Default: undefined
boolean 필드 출력시 수행될 콜백함수를 지정한다. 원하는 형태로 지정 가능하다.
JS Ver.만 지원

numberCallback
Type: function (index, column, value)
Default: undefined
number 필드 출력시 수행될 콜백함수를 지정한다. 원하는 형태로 지정 가능하다.
JS Ver.만 지원

nullDateText
Type: string
Default: “”
DateTime 필드의 값이 null 일때 표현되는 값을 지정한다. JS Ver.만 지원

numberFormat
Type: string
Default: undefined
이 값이 지정되면 number 필드의 값을 출력할 때 변환 형식으로 사용된다. 지정되지 않은 경우 column.styles에 설정된 값을 사용한다.

compatibility
Type: boolean
Default: false
excel 2007 호환 여부를 지정한다.
JS Ver.만 지원

showLevelOutLine
Type: boolean
Default: true
row grouping 된 자료를 export시 엑셀 왼쪽에 위치한 그룹간 묶음선 표시여부를 지정한다.
JS Ver.만 지원

documentTitle
Type: number
Default: 0
export를 시작할 행을 지정한다.
JS Ver.만 지원

start
Type: number
Default: 0
export를 시작할 행을 지정한다.
JS Ver.만 지원

count
Type: number
Default: -1
export할 행 수를 지정한다. -1을 지정하면 모든 행이 export된다.
JS Ver.만 지원

showProgress
Type: boolean
Default: false
Export시 프로그래스 바 표시 여부를 지정한다.
JS Ver.만 지원

progressMessage
Type: string
Default: “Exporting…”
Export시 프로그래스 바에 표시될 메시지를 지정한다.
JS Ver.만 지원

applyDynamicStyles
Type: boolean
Default: false
DynamicStyles을 적용하여 Export할 것인지를 지정한다.
JS Ver.만 지원

separateRows
Type: Boolean
Default: false
true로 지정하면 export시 병합을 해제한 상태로 excel에 표시됩니다.

pagingAllItems
Type: Boolean
Default: false
true로 지정하면 엑셀 다운로드시 페이징되어 보이지 않는 데이터를 포함한 모든 데이터를 받을 수 있다. RealGridJS 1.1.23 부터 지원된다.

allColumns
Type: Boolean
Default: false
true로 지정하면 보이지 않는 컬럼들도 export 된다.
RealGridJS만 1.1.24 부터 지원된다.

onlyCheckedItems
Type: Boolean
Default: false
true로 지정하면 체크바에 체크된 행들만 export 된다.
그룹핑 상태나 트리 그리드인 경우는 지원하지 않는다.
RealGridJS 1.1.25 부터 지원된다.

exportSeriesColumn
Type: Boolean
Default: false
true로 지정하면 sparkLine, sparkColumn, sparkWinLoss컬럼들이 export 된다.
spark컬럼들이 참조하고 있는 DataColumn들을 반드시 포함하여 export해야하며 DataColumn의 name 속성은 반드시 지정되어 있어야 한다. 또한 DataColumn은 참조한 순서대로 표시되어 있어야 한다.
excel 2010 이상부터 지원한다.
RealGridJS 1.1.27 부터 지원된다.

textCallback
Type: function (index, column, value)
text 필드 출력시 수행될 콜백함수를 지정한다. 원하는 형태로 지정 가능하다.
일반적인 경우 사용하지 않는다.
text타입으로 된 시간값을 export하였을때 엑셀에서 연산을 가능할 수 있게 하기위해 만들어졌다.
return 값이 숫자인 경우 숫자 형식으로 export된다.
RealGridJS 1.1.28 부터 지원된다.

showColumns
Type: Array of String
Default: null
visible이 false이지만 excel로 export하고자 하는 컬럼을 배열로 지정한다.
RealGridJS 1.1.31 부터 지원된다.

hideColumns
Type: Array of String
Default: null
visible이 true이지만 excel로 export하지 않을 컬럼을 배열로 지정한다.
RealGridJS 1.1.31 부터 지원된다.

applyFitStyle
Type: Boolean
Default: false
true이면 FitStyle이 적용된 너비로 export 된다.
RealGridJS 1.1.32 부터 지원된다.

Example

var columns = [{
    name: "T_TIME",
    fieldName: "T_TIME",
    width: 80,
    header: { text: "소요시간" },
    styles: { textAlignment: "center", datetimeFormat: "HH:mm:ss" },
    excelFormat: "[h]:mm:ss"
}];

...

gridView.exportGrid({
    type: "excel",
    target: "local",
    fileName: "gridExportSample.xlsx",
    indicator: "default",
    header: "visible",
    footer: "hidden",
    //데이터가 "00:00:00"의 형태일때 엑셀 export처리
    textCallback: function (itemIndex, column, value) {              
	    if (column === "T_TIME" && value) {
	        var vals = value.split(":");
	        return (parseInt(vals[0]) * 3600 + parseInt(vals[1]) * 60 + parseInt(vals[2])) / 86400;
	    } else {
	        return value;
	    }
	}
});