AUISoft
AUIPivot 2.5 Documentation
Properties

AUIPivot 에서 정의 가능한 속성 리스트입니다.

NameDescription
autoGridHeight
Type : Boolean   Version: 1.5

피벗 그리드의 높이(height)가 피벗팅 된 결과에 따라 유동적으로 변해 최적화되어 표현될지 여부를 지정합니다.

예를 들어 피벗팅된 결과로 1 행만 출력된 경우, 기존 그리드 하단에 여백이 남습니다.

이 여백을 제거하고 그리드 높이가 최적화 되어 표현되기를 원하면 이 속성을 true 설정하십시오.

반대로, 그리드의 행의 개수가 많은 경우 처음 create 된 시점의 높이를 초과해서 표현되지 않고, 처음 높이를 유지하고 수직 스크롤이 생성됩니다.

기본값(default) : true.
autoGridMinHeight
Type : Number   Version: 1.5

autoGridHeight 을 true 로 설정한 경우, 피벗 그리드의 최소 높이를 명시적으로 지정합니다.

예를 들어 이 속성의 값이 100 으로 지정하면 피벗팅 된 데이터에 따라 유동적으로 변하는 그리드의 높이가 100 보다 작아지지 않습니다.

기본값(default) : NaN.
autoGridParentHeight
Type : Boolean   Version: 1.5

autoGridHeight 을 true 로 설정한 경우, 피벗 그리드의 높이가 유동적으로 변할 때 그리드의 부모 DIV 도 같이 적용 시킬지 여부를 지정합니다.

기본값(default) : false.
autoScrollSize
Type : Boolean   Version: 1.0

터치가 지원되는 모바일 기기(아이폰, 아이패드, 안드로이드 기기 등)에서 스크롤 높이(수직 스크롤인 경우 넓이)를 자동으로 작게 만들지 여부를 지정합니다.

만약 true 로 설정한다면 scrollHeight4Mobile 설정값으로 스크롤 크기가 적용됩니다.

기본값(default) : false.
columnAutoWidthGap
Type : Number   Version: 1.0

피벗팅 업데이트 완료 후 칼럼들의 넓이가 자동으로 설정되어 렌더링 됩니다.

이 때 자동으로 설정된 칼럼들의 width 에 추가 넓이를 픽셀 단위로 지정할 수 있습니다.

칼럼들의 width 를 추가로 넓히고자 한면 이 속성의 값을 증가 시키십시오.

반대로 줄이고자 하는 경우 음수 값을 설정합십시오.

기본값(default) : 4.
copyDisplayValue
Type : Boolean   Version: 1.0

그리드의 셀 또는 행을 복사(Ctrl+C) 할 때 원래 데이터 값을 복사할 지 그리드에 의해 포매팅된 값을 복사할 지 여부를 나타냅니다.

예를 들어 실 데이터는 1000 이나, 그리드에 의해 "1,000원" 으로 포매팅되어 출력되고 있을 때 Ctrl+C 로 복사할 대상이 1000 또는 "1,000원" 인지를 지정합니다.

copyDisplayValue = true 인 경우 "1,000원" 이 복사됩니다.

기본값(default) : false.
dateTypeField
Type : String   Version: 1.0

피벗 대상 데이터에서 날짜를 "일(days)" 을 기준으로 "월(month)", "분기(quarter)", "반기(half)", "년(year)" 로 분기시킬 날짜에 해당되는 필드명을 지정합니다.

예를 들어 원본 데이터에 판매일에 해당되는 날짜가 "2016/05/13" 이 있는 경우 각각 "월", "분기", "반기", "년" 을 만들어 냅니다.

각각 "필드명_MONTH", "필드명_QTR", "필드명_HALF", "필드명_YEAR" 로 만들어냅니다.

즉, dateTypeField 의 속성값을 "DATE" 로 지정하면 "DATE_MONTH", "DATE_QTR", "DATE_HALF", "DATE_YEAR" 로 만들어냅니다.

기본값(default) : null.
defaultFormatString
Type : String   Version: 1.0

값 차원에 필드를 설정하면 연산되어 요약된 값이 출력됩니다. 이 요약된 숫자의 기본 포맷스트링을 지정합니다.

이 포맷스트링은 숫자 형식에만 유효합니다.

숫자 포맷 스트링은 다음과 같습니다.

"0" 과 "#"의 차이는 "0"은 반드시 자리수를 차지하도록 채웁니다. "#"은 있는 경우 출력 시킴

  • ###0 : 컴마 구분자 없이 정수 표현(소수점은 기본적으로 반올림 처리)
  • #### : 컴마 구분자 없이 정수 표현, 0인 경우 공백 처리(소수점은 기본적으로 반올림 처리)
  • #,##0 : 천단위 마다 컴마 구분자 정수 표현(소수점은 기본적으로 반올림 처리)
  • #,### : 천단위 마다 컴마 구분자 정수 표현, 0인 경우 공백 처리(소수점은 기본적으로 반올림 처리)
  • #,##0.0 : 천단위 마다 컴마 구분자 소수 1자리 의무 표현(소수 2자리에서 기본적으로 반올림 처리)
  • #,##0.# : 천단위 마다 컴마 구분자 소수 있다면 1자리 표현, 0인 경우 공백 처리(소수 2자리에서 기본적으로 반올림 처리)
  • #,##0.00 : 천단위 마다 컴마 구분자 소수 2자리 의무 표현(소수 3자리에서 기본적으로 반올림 처리)
  • #,##0.0# : 천단위 마다 컴마 구분자 소수 1자리 의무, 2자리 있다면 표현(소수 3자리에서 기본적으로 반올림 처리)
기본값(default) : "###0.#####".
defaultHeatmapColors
Type : Array   Version: 1.0

히트맵으로 출력을 사용하는 경우(useHeatmap=true) 히트맵 색상의 기본값을 지정합니다.

반드시 Array 로 2개 이상의 색상을 지정하십시오.

기본값(default) : ["#FFFFFF", "#4374D9"].
displayAutoAscending
Type : Boolean   Version: 2.5

행, 열의 값을 자동 오름차순으로 출력되는 방식을 지정합니다.

기본적으로 피벗 보고서는 설정된 행, 열의 값에 따라 자동으로 오름 차순 정렬되어 출력됩니다.

이 값을 false 로 설정하면 자동 오름 차순 출력이 아닌 원본 데이터(source data)의 순서대로 출력됩니다.

기본값(default) : true.
displayTreeOpen
Type : Boolean   Version: 1.0

계층형에서 최초로 보여지는 그리드의 브랜치 아이템이 모두 열린 상태로 출력될지 닫힌 상태로 출력될지를 결정합니다.

이 값이 true 라면 모두 열린 상태이고, false 라면 최상위 브랜치만 표시됩니다.

기본값(default) : false.
enableClipboard
Type : Boolean   Version: 1.0

그리드 데이터 복사하기(Ctrl+C) 활성화 여부를 지정합니다.

기본값(default) : true.
enableColumnResize
Type : Boolean   Version: 1.0

칼럼 리사이징 가능 여부를 지정합니다.

기본값(default) : true.
enableFocus
Type : Boolean   Version: 1.0

그리드에 키보드 포커스 설정을 할지 여부를 지정합니다.

기본값(default) : true.
enableMultipleSorting
Type : Boolean   Version: 1.0

다중 칼럼 필드 정렬(Sorting) 여부를 지정합니다. (선행 : enableSorting 속성 true 설정)

이 값이 true 라면 multiSortingKey( 기본 : shiftKey )에 따라 다중 칼럼 헤더 클릭 시 멀티 정렬이 실행됩니다.

기본값(default) : true.
enableSorting
Type : Boolean   Version: 1.0

정렬 가능 여부를 지정합니다.

기본값(default) : true.
exportURL
Type : String   Version: 1.0

엑셀(xlsx), CSV, TXT 등으로 내보내기(Export) 할 때 내보내기 된 내용물을 다운로드 형식으로 응답해 줄 서버단 URL 주소를 지정합니다.

해당 서버단 파일은 PHP, JSP 등이 될 수 있습니다. 제공된 샘플의 server_script 폴더에 샘플 JSP와 PHP 가 있습니다.

해당 파일을 WAS 에 업로드 후 해당 주소를 지정해 주십시오.

기본값(default) : null.
fieldListAreaRatio
Type : Number   Version: 1.5

피벗 필드 패널의 필드 리스트 영역이 차지하는 비율을 지정합니다.

예를 들어 이 값을 0.3으로 지정하면 필드 리스트 영역의 높이 크기가 전체 피벗 필드 패널의 30% 를 차지합니다.

유효 값은 0.3 ~ 0.7 입니다.

기본값(default) : 0.5.
filterLayerHeight
Type : Number   Version: 1.0

필터 기본 메뉴의 높이를 픽셀 단위로 지정합니다.

기본값(default) : 380.
filterLayerWidth
Type : Number   Version: 1.0

필터 기본 메뉴의 넓이를 픽셀 단위로 지정합니다.

기본값(default) : 240.
filterMenuItemMaxCount
Type : Number   Version: 1.0

필터링 아이콘 클릭 시 나오는 필터링 메뉴에서 해당 값들이 많을 경우 모두 체크 박스로 출력되지 않습니다.

filterMenuItemMaxCount 은 필터링 가능한 체크박스의 최대값을 지정합니다.

보이지 않는 값들을 필터링하고자 할 때 자동완성(auto complete) 기능으로 검색하여 체크박스 선택하십시오.

기본값(default) : 40.
filterPanelHeight
Type : Number   Version: 1.0

필터 차원 설정 기본 메뉴의 넓이를 픽셀 단위로 지정합니다.

기본값(default) : 240.
fixedAlterWidth
Type : Number   Version: 2.5.4

고정 칼럼이 설정된 경우 고정 칼럼외의 영역 보장 크기(width)를 지정합니다.

설정된 fixedAlterWidth 보다 고정 칼럼의 전체 크기(width)가 커진 경우 고정 칼럼들은 크기를 줄여 출력됩니다.

기본값(default) : 200.
fixedColumnHGap
Type : Number   Version: 1.0

행 줄번호 또는 fixedColumnCount 설정 시 좌측으로 구분되는 그리드와 메인 그리드 사이의 여백을 지정합니다.

기본값(default) : 0.
footerHeight
Type : Number   Version: 1.0

푸터의 높이를 지정합니다.

기본값(default) : 30.
footerVGap
Type : Number   Version: 1.0

푸터와 메인 그리드 사이의 간격, 공백을 지정합니다.

기본값(default) : 1.
headerHeight
Type : Number   Version: 1.0

헤더의 높이를 지정합니다.

기본값(default) : 24.
height
Type : Number   Version: 1.0

그리드의 세로 사이즈를 픽셀 단위로 지정합니다. 이 세로 사이즈를 지정하지 않으면 부모 DIV 의 height 만큼 할당됩니다.(즉, 부모 height의 100%)

기본값(default) : NaN.
isFormatNullValue
Type : Boolean   Version: 2.5

피벗 분석 데이터 값이 없는 값(null value)도 포맷팅을 할지 여부를 지정합니다.

예로 분석 후 값이 없는 경우 빈 공백으로 출력되는데 만약 0으로 출력하고자 한다면 이 속성을 true 설정 후 defaultFormatString(또는 개별 값 차원의 formatString) 을 "#,##0" 으로 설정 하십시오.

기본값(default) : false.
layoutType
Type : String   Version: 1.0

피벗 그리드의 행 차원에 다수의 필드를 설정한 경우, 그리드의 출력 방식을 지정합니다.

유효값은 다음 3가지가 존재합니다.

  • tree : 요약형 트리 형식의 계층 구조로 출력합니다.
  • table : 행 차원에 설정한 필드 대로 칼럼을 출력 하나, 셀 병합된 형태가 아닌 반복적은 값이 나오도록 출력합니다.
  • tableCellMerge : 행 차원에 설정한 필드 대로 칼럼을 출력 후 반복적인 값은 병합하여 출력하도록 합니다.
기본값(default) : "tree".
minFieldPanelHeight
Type : Number   Version: 1.5

피벗 필드 패널의 최소 높이(height) 사이즈를 지정합니다.

피벗 필드 패널은 이 값보다 작아지지 않습니다.

기본값(default) : 400.
minFieldPanelWidth
Type : Number   Version: 1.5

피벗 필드 패널의 최소 넓이(width) 사이즈를 지정합니다.

피벗 필드 패널은 이 값보다 작아지지 않습니다.

기본값(default) : 300.
movableFieldPanel
Type : Boolean   Version: 1.0

피벗 필드 패널을 생성할 때 이동 가능(resizable) 하게 만들지를 결정합니다.

기본값(default) : true.
multiSortingKey
Type : String   Version: 1.0

다중 칼럼 정렬을 실행 할 때 클리과 더블어 함께 할 키(key)를 지정합니다.

예를 들어 이 값을 "shiftKey" 로 설정한 경우 쉬프트키와 함께 칼럼 헤더 클릭 시 다중 정렬이 실행됩니다.

유효값은 "shiftKey", "ctrlKey", "always" 입니다.

"always" 값은 단순 클릭만으로 항상 다중 정렬이 실행됩니다.

기본값(default) : "shiftKey".
onlyTreeLastDepthSorting
Type : Boolean   Version: 1.0

트리 그리드(계층형 데이터 그리드)에서 정렬을 할 때 최하단의 Depth 에 해당되는 행(rows)만 정렬을 실행할지 여부를 지정합니다.

기본값(default) : false.
panelHeight
Type : Number   Version: 1.0

피벗 필드 패널의 세로 사이즈를 픽셀 단위로 지정합니다. 이 세로 사이즈를 지정하지 않으면 부모 DIV 의 height 만큼 할당됩니다.(즉, 부모 height의 100%)

기본값(default) : NaN.
panelWidth
Type : Number   Version: 1.0

피벗 필드 패널의 가로 사이즈를 픽셀 단위로 지정합니다. 이 가로 사이즈를 지정하지 않으면 부모 DIV 의 width 만큼 할당됩니다.(즉, 부모 width의 100%)

기본값(default) : NaN.
pivotPanelId
Type : String   Version: 1.0

피벗 필드 패널을 표시하고자 할 때 피벗 필드가 출력될 DIV 의 id 를 지정합니다.

DIV 태그의 id 를 지정하면 AUIPivot 이 생성될 때 같이 지정된 id 에 피벗 필드 패널이 생성됩니다.

기본값(default) : null.
resizableFieldPanel
Type : Boolean   Version: 1.0

피벗 필드 패널을 생성할 때 크기 조절 가능(resizable) 하게 만들지를 결정합니다.

기본값(default) : true.
reverseRowNum
Type : Boolean   Version: 1.0

행번호 칼럼에서 행 번호를 반대로 출력할지 여부를 나타냅니다.

기본값(default) : false.
rowHeight
Type : Number   Version: 1.0

행의 높이를 지정합니다. 행의 높이는 20보다 작아질 수 없습니다. (즉, 행 높이 최소값은 20)

기본값(default) : 24.
rowNumColumnWidth
Type : Number   Version: 1.0

행 줄번호(로우 넘버링) 칼럼의 가로 사이즈(width)를 지정합니다.

showRowNumColumn=true 설정인 경우만 유효합니다.

기본값(default) : 40.
rowStyleFunction
Type : Function   Version: 1.0

행(row) 단위로 동적 스타일을 적용할 수 있는 스타일 함수를 지정합니다.

스타일함수는 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

 
// rowIndex : 행 인덱스
// item : 해당 인덱스의 행 아이템
 rowStyleFunction : function(rowIndex, item) {
   var myCss = "my-Css";
   // 로직 처리
   return myCss;
} 

함수의 반환값은 CSS 에서 이미 선언되어 있는 CSS 클래스여야 합니다.

다중의 CSS 클래스는 지원하지 않습니다. 예를 들어 "right-style bold-style font12-style" 과 같은 구조는 지원하지 않습니다.

기본값(default) : null.
scrollHeight
Type : Number   Version: 1.0

스크롤의 높이(수직 스크롤인 경우 넓이)를 지정합니다.

기본값(default) : 14.
scrollHeight4Mobile
Type : Number   Version: 1.0

autoScrollSize=true 설정한 경우, 터치가 지원되는 모바일 화면(아이에서의 스크롤 높이(수직 스크롤인 경우 넓이)를 지정합니다.

기본값(default) : 4.
scrollThumbHeight
Type : Number   Version: 1.0

스크롤 썸(thumb)의 높이(수직 스크롤인 경우 넓이)를 지정합니다.

기본값(default) : 12.
showColumnLabelHeader
Type : Boolean   Version: 1.7

열(column) 의 최상단 헤더로 출력되는 "열 레이블" 헤더 출력 여부를 지정합니다.

기본값(default) : true.
showColumnTreeIcon
Type : Boolean   Version: 1.7

열(column) 필드를 복수로 지정한 경우, 열에 트리 아이콘이 출력됩니다. 이 트리 아이콘의 출력 여부를 지정합니다.

기본값(default) : true.
showFooter
Type : Boolean   Version: 1.0

푸터 출력 여부를 지정합니다.

기본값(default) : false.
showGrandTotalColumn
Type : Boolean   Version: 1.7

열(column) 의 전체 합계 출력 여부를 지정합니다.

기본값(default) : true.
showRowNumColumn
Type : Boolean   Version: 1.0

행 줄번호(로우 넘버링) 칼럼의 출력 여부를 지정합니다.

이 속성 값이 true 이면 최좌측에 행번호 칼럼이 생성됩니다.

기본값(default) : true.
showSelectionBorder
Type : Boolean   Version: 1.0

셀 선택 시 선택된 셀에 테두리(border) 를 표시할지 여부를 나타냅니다.

기본값(default) : true.
showStateColumn
Type : Boolean   Version: 1.0

그리드 좌측에 행의 위치 상태를 나타내는 칼럼 출력 여부를 결정합니다.

기본값(default) : true.
showSummaryColumn
Type : Boolean   Version: 1.7

열(column) 필드를 복수로 지정한 경우, 개별 열에 부분 합계(소계)가 출력 됩니다. 이 부분 합계 열의 출력 여부를 지정합니다.

기본값(default) : true.
showSummaryRow
Type : Boolean   Version: 1.7

layoutType 을 "table" 또는 "tableCellMerge" 로 설정한 경우, 행의 부분 합계(소계) 출력 여부를 지정합니다.

참고 : layoutType = "tree" 인 경우 트리 형태 유지를 위해 부분 합계(소계)가 출력 되므로 showSummaryRow 속성은 무시됩니다.

기본값(default) : true.
showTooltip
Type : Boolean   Version: 1.0

그리드 툴팁 표시 여부를 지정합니다.

기본값(default) : false.
showTreeIcon
Type : Boolean   Version: 1.7

layoutType 을 "table" 또는 "tableCellMerge" 로 설정한 경우, 트리 아이콘 출력 여부를 지정합니다.

참고 : layoutType = "tree" 인 경우 필수로 트리 아이콘이 출력되어야 하므로 showTreeIcon 속성은 무시됩니다.

기본값(default) : true.
showValueLabelHeader
Type : Boolean   Version: 1.7

값 필드의 정보를 나타내는 헤더 출력 여부를 지정합니다. 예를 들어 값 필드를 "TOTAL" 필드 "합계" 연산으로 설정했다면,

피벗 그리드의 최상단 좌측에 "합계 : TOTAL" 이라고 나오는 헤더 출력 여부 지정 속성입니다.

기본값(default) : true.
stateColumnWidth
Type : Number   Version: 1.0

행 상태 칼럼(showStateColumn = true)을 설정한 경우 해당 칼럼의 가로 사이즈를 지정합니다.

기본값(default) : 16.
summaryColumnPosition
Type : String   Version: 1.0

요약 칼럼(부분 합계 칼럼, 전체 합계 칼럼 칼럼)의 위치를 지정합니다.

기본적으로 요약 칼럼은 뒤에 출력 시킵니다. 만약 앞에 출력하고자 한다면 이 속성을 "first" 로 지정하십시오.

유효값은 "first", "last" 입니다.

기본값(default) : "last".
tooltipFunction
Type : Function   Version: 1.0

그리드 셀에 마우스 오버 시 생기는 툴팁을 사용자 정의 할 수 있는 함수를 설정합니다. (속성 showTooltip = true 설정 선행 필수)

tooltipSensitivity 은 함수로 설정하고 형식은 다음과 같습니다.

// 툴팁 사용자 정의 함수 // displayName : 값에 해당되는 연산 정보 텍스트(예: 합계 : 가격) // rowText : 행 텍스트 // colText : 열 텍스트 // valText : 값 텍스트 // Return : 반환하는 그대로를 툴팁으로 출력합니다.(innerHTML 처리) tooltipFunction : function(displayName, rowText, colText, valText) { var htmlStr = '<p class="my-tooltip-title">AUIPivot 툴팁 사용자 정의</p>'; htmlStr += '<b>' + displayName + '</b>'; htmlStr += '<br/><b>행 : </b>' + rowText.replace(/ - /gi, " → "); if(colText != "") htmlStr += '<br/><b>열 : </b>' + colText.replace(/ - /gi, " → "); if(valText != "") htmlStr += '<br/><b>값 : </b>' + valText; return htmlStr; // 반환하는 그대로를 툴팁으로 출력합니다.(innerHTML 처리) } 기본값(default) : null.
tooltipSensitivity
Type : Number   Version: 1.0

툴팁 표시를 설정한 경우(showTooltip:true 설정) 툴팁이 표시되는 시간을 ms 로 지정합니다.

즉, 특정 셀에 마우스 오버를 한 경우 tooltipSensitivity 값 이후에 툴팁이 출력됩니다.

예를 들어 tooltipSensitivity=1000 을 지정한 경우 1 초 후 툴팁이 표시됩니다. 마우스 오버 시 바로 툴팁 표시를 원하면 0 을 설정하십시오.

기본값(default) : 700.
treeLevelIndent
Type : Number   Version: 1.0

레이아웃 유형이 "tree" 인 경우 자식 행과 부모 행의 왼쪽 간격(indent)를 지정합니다.

기본값(default) : 18.
treeOpenRecursivly
Type : Boolean   Version: 1.0

계층형에서 열기/닫기 실행 시 재귀적으로(recursivly) 열/닫을 실행할지 결정합니다.

재귀란 바로 아래 자식 뿐 아니라 자손까지 영향을 미칠지를 나타냅니다.

기본값(default) : false.
useFixedColumns
Type : Boolean   Version: 1.0

행 차원에 필드를 설정하면 해당 행 필드에 의해 만들어진 칼럼을 틀 고정 처리 할지 여부를 지정합니다.

틀 고정은 행 차원 필드 개수에 따라 동적으로 변합니다.

기본값(default) : true.
useHeaderFilterMenu
Type : Boolean   Version: 2.5

행 차원 칼럼의 헤더에 필터 메뉴를 생성 시킬지 여부를 지정합니다.

기본값(default) : true.
useHeatmap
Type : Boolean   Version: 1.0

피벗된 그리드의 셀을 히트맵 형식으로 출력할지 여부를 지정합니다.

기본값(default) : false.

wheelSensitivity
Type : Number   Version: 1.0

마우스 휠에 의한 수직 스크롤의 반응도를 결정합니다.

예를 들어 이 속성의 값을 2로 주면 마우스 휠로 반응하는 행의 개수가 2로 변경됩니다.

기본값(default) : 5.
width
Type : Number   Version: 1.0

그리드의 가로 사이즈를 픽셀 단위로 지정합니다. 이 가로 사이즈를 지정하지 않으면 부모 DIV 의 width 만큼 할당됩니다.(즉, 부모 width의 100%)

기본값(default) : NaN.