makePivotTable (method)

대상 시트의 모든 데이터를 기준으로 피벗 테이블을 생성합니다.
다이얼로그 UI 없이 코드로 직접 피벗 시트를 만들 때 사용하며, 다이얼로그 형태가 필요하면 showPivotDialog를 사용하세요.
피벗 생성 시점에 대상 시트가 필터링되어 있으면 필터가 취소된 후 피벗이 생성됩니다.
생성된 피벗 시트의 id는 "pivotSheet_" + 원본시트id 입니다. (예: 원본 id "sheet" → 피벗 id "pivotSheet_sheet")
피벗 시트에서는 DataMerge 기능을 지원하지 않습니다.

주의: 행 5,000개 또는 열 200개를 초과하는 피벗 테이블은 브라우저 성능을 보장할 수 없습니다.
init 설정 시 기준 행·열이 그 미만이 되도록 권장합니다.

Syntax

object makePivotTable(criterias, init, format, type, callback, hideTotal);

Parameters

criterias (선택)

init (필수)

hideTotal

Return Value

object — 생성된 피벗 시트 객체

Example

// 1. 가장 단순한 케이스 — 부서별 급여 합계 (열 분류 없음)
//    → 행 레이블(부서) 1개 컬럼 + 합계: 급여 1개 컬럼
sheet.makePivotTable(null, {
    row:  'sDept',
    col:  '',
    data: 'sSalary'
});

// 2. 행 × 열 교차표 — 부서 × 직급별 급여 합계
//    → 부서(행) × 직급(열) 매트릭스 + 우측에 행별 합계 컬럼
sheet.makePivotTable(null, {
    row:  'sDept',
    col:  'sPosition',
    data: 'sSalary'
}, '#,###');

// 3. 여러 데이터 컬럼 + 다른 집계 방식 — 부서×직급별 (급여 합계, 인원수)
//    → 각 직급마다 '합계: 급여' / '개수: 성명' 두 서브 컬럼 생성
sheet.makePivotTable(null, {
    row:  'sDept',
    col:  'sPosition',
    data: 'sSalary,sName'
}, '#,###', 'Sum,Count');

// 4. 콜백으로 생성 후 후처리 — 부서별 급여 합계가 2천만 넘는 행은 빨간색
sheet.makePivotTable(null, {
    row:  'sDept',
    col:  'sPosition',
    data: 'sSalary'
}, '#,###', 'Sum', function (evt) {
    var rows = evt.sheet.getDataRows();
    for (var i = 0; i < rows.length; i++) {
        if (evt.sheet.getValue(rows[i], 'SUMsSalary') > 20000000) {
            evt.sheet.setAttribute(rows[i], 'SUMsSalary', 'TextColor', '#FF0000');
        }
    }
});

// 5. 합계 숨김 — 우측 행별 합계 컬럼 숨기기
//    → hideTotalRow: 각 행의 합계 컬럼(우측), hideTotalCol: 각 열의 합계 행(하단)
sheet.makePivotTable(null, {
    row:  'sDept',
    col:  'sPosition',
    data: 'sSalary'
}, '#,###', 'Sum', null, { hideTotalRow: true });

// 6. criterias 사용 — UsePivot 모드에서 피벗 고정행 드래그 제한
//    → 'sSalary'를 col에만 넣어두면 고정행에서 '급여' 항목은 '세로행 기준'으로만 드롭 가능
options.Cfg = { UsePivot: true };  // 피벗 고정행 활성화

var criterias = {
    row:  'sDept,sTeam,sPosition,sGender,sAgeRanges,sAddr',
    col:  'sDept,sTeam,sPosition,sGender,sAgeRanges,sAddr,sSalary',
    data: 'sAge'
};
var init = {
    row:  'sDept',
    col:  'sPosition,sTeam',
    data: 'sSalary'
};
sheet.makePivotTable(criterias, init);

Try it

• Demo of makePivotTable

Read More

• showPivotDialog method
• switchPivotSheet method
• onAfterPivot event
• UsePivot cfg
• PivotFunc cfg
• PivotFormat cfg

Since