makeSubTotal (method)

stdCol(기준 열)의 같은 값끼리 그룹으로 묶어 합계, 평균, 건수 등을 계산한 소계행을 추가합니다.(SearchMode 0, 2만 지원)
데이터 조회 후 사용하며, onDataLoad에서 호출을 권장합니다.
onSearchFinish에서 호출하면 데이터가 많을 경우 성능이 저하될 수 있습니다.
머지된 행을 1건으로 계산하려면 CalcMergeMode를 설정해야 합니다.

Syntax

void makeSubTotal( subTotalRows, usermerge, excludeSubTotalRowCount );

Parameters

subTotalRows

Return Value

none

Example

단일 컬럼 소계

// captionCol 미설정 — 기본 캡션("소계: 값")이 자동 표시
sheet.makeSubTotal([
  {
    stdCol: 'sPolicy',
    sumCols: 'A|B|C|D',
    position: 'bottom',
    color: '#dbe2eb'
  }
]);

단일 컬럼 소계 (mode:1)

// mode:1 — 소계 계산 대상 행이 2건 이상인 그룹만 소계행 표시
sheet.makeSubTotal([
  {
    stdCol: 'sPolicy',
    sumCols: 'A|B|C|D',
    position: 'bottom',
    color: '#dbe2eb',
    mode: 1
  }
]);

단일 컬럼 소계/누계

// captionCol 설정 시 기본 캡션("소계: 값")은 사라지므로,
// 표시하려면 captionCol에 { col: 'stdCol명', val: '%s: %col' }을 직접 지정해야 합니다.
sheet.makeSubTotal([
  {
    stdCol: 'sPolicy',
    sumCols: 'A|B|C|D',
    color: '#dbe2eb',
    cumulateColor: '#b2c4d9',
    showCumulate: 1,
    position: 'bottom',
    captionCol: [
      { col: 'sPolicy', val: '%s: %col', cumVal: '%s: %col' }
    ]
  }
]);

captionCol 함수형 val 사용

// captionCol의 val에 함수를 사용하여 소계 값을 동적으로 계산
// 소계행은 Text 타입이므로 숫자 포맷이 필요하면 함수에서 직접 처리해야 합니다.
sheet.makeSubTotal([
  {
    stdCol: 'sPolicy',
    sumCols: 'A|B|C|D',
    position: 'bottom',
    captionCol: [
      {
        col: 'E',
        val: function (fr) {
          // Type과 Format을 직접 설정하면 숫자 포맷 적용 가능
          var ratio = (fr.Row["B"] / fr.Row["A"] * 100).toFixed(1);
          var type = fr.Sheet.getAttribute("", fr.Col, "Type");
          fr.Row[fr.Col + "Type"] = type;
          fr.Row[fr.Col + "Format"] = "#,##0.##### \\%";
          return ratio;
        }
      },
      {
        col: 'F',
        val: function (fr) {
          var val = fr.Row["A"] + fr.Row["B"];
          var type = fr.Sheet.getAttribute("", fr.Col, "Type");
          fr.Row[fr.Col + "Type"] = type;
          fr.Row[fr.Col + "Format"] = "#,##0";
          return val;
        }
      }
    ]
  }
]);

소계 그룹 데이터 접근

// captionCol function에서 소계 그룹의 데이터 행에 접근
sheet.makeSubTotal([
  {
    stdCol: 'sPolicy',
    sumCols: 'A',
    avgCols: 'B',
    countCols: 'C',
    captionCol: [
      {
        col: 'sUnit',
        val: function (fr) {
          // 현재 소계행의 그룹 데이터를 가져옴
          var subSumSet = fr.Sheet.SubSumRowsArray.filter(function(rowSet) {
            return rowSet.SubSumRow == fr.Row;
          });
          // SubSumGroupedRows: 소계 그룹에 속한 데이터 행 배열
          return subSumSet[0].SubSumGroupedRows.length;
        }
      }
    ]
  }
]);

소계 그룹 데이터 접근 — 시간 데이터 합산

// 시간 데이터는 합산 시 24시간을 초과할 수 있으므로,
// SubSumGroupedRows로 그룹 데이터에 접근하여 직접 계산
sheet.makeSubTotal([
  {
    stdCol: 'weekOdr',
    captionCol: [
      {
        col: 'wkTm',
        val: function (fr) {
          var subSumSet = fr.Sheet.SubSumRowsArray.filter(function(rowSet) {
            return rowSet.SubSumRow == fr.Row;
          });
          var rows = subSumSet[0].SubSumGroupedRows;

          // Date 타입은 timestamp로 저장되므로 dateToString으로 변환 후 파싱
          var totalMin = 0;
          rows.forEach(function(row) {
            var hm = IBSheet.dateToString(row.wkTm, "HHmm");
            var h = parseInt(hm.substring(0, 2)) || 0;
            var m = parseInt(hm.substring(2)) || 0;
            totalMin += h * 60 + m;
          });

          var days = Math.floor(totalMin / (24 * 60));
          var hours = Math.floor((totalMin % (24 * 60)) / 60);
          var mins = totalMin % 60;
          return days + "일 " + hours + "시간 " + mins + "분";
        }
      }
    ]
  }
]);

Def.SubSum으로 소계행 스타일 설정

소계행은 CSS로 스타일 변경이 안 됩니다.
배경색, 글자색, 포맷 등은 Def.SubSum에서 설정하며, makeSubTotal의 color 속성으로 배경색을 덮어쓸 수 있습니다.

Def: {
  SubSum: {
    Color: '#f0f0f0',           // 소계행 기본 배경색 (makeSubTotal의 color로 덮어쓰기 가능)
    TextColor: 'red',           // 소계행 전체 글자 색상
    ATextColor: 'green',        // A컬럼 소계행 글자 색상
    // Format은 sumCols, avgCols, countCols로 계산된 컬럼만 적용 가능 (8.0.0.25~)
    // captionCol의 function으로 생성된 소계행은 Text 타입이라 Format이 적용되지 않음
    AFormat: '합계 : #,##0.##', // A컬럼 소계행 포맷
    BFormat: '#,##0'            // B컬럼 소계행 포맷
  }
}

다중 컬럼 소계

sheet.makeSubTotal([
  {
    stdCol: 'sPolicy',
    sumCols: 'B|C',
    position: 'bottom',
    color: '#b2c4d9'
  },
  {
    stdCol: 'sUnit',
    avgCols: 'B|C',
    position: 'bottom',
    color: '#dbe2eb',
    captionCol: [
      { col: 'sUnit', val: '%s: %col' }
    ]
  }
]);

usermerge 사용

// Cfg.DataMerge:0 (머지 없음) 설정일 때

// usermerge:0 (기본값) — DataMerge:0 이어도 stdCol 기준으로 자동 머지
sheet.makeSubTotal([
  { stdCol: 'sPolicy', sumCols: 'A|B|C|D', position: 'bottom', color: '#dbe2eb' }
]);

// usermerge:1 — DataMerge:0 설정을 따르므로 머지 없이 소계행만 추가
sheet.makeSubTotal([
  { stdCol: 'sPolicy', sumCols: 'A|B|C|D', position: 'bottom', color: '#dbe2eb' }
], 1);

소계행 식별 / 제외

makeSubTotal로 생성된 소계행은 Name 속성이 "SubSum"으로 설정됩니다. 일반 데이터 행은 Name이 undefined이므로, 특정 행이 소계행인지 이 값으로 판별할 수 있습니다. 소계행도 Kind는 "Data"이므로 Kind로는 구분되지 않습니다.

// 특정 행이 소계행인지 확인
if (row.Name === "SubSum") { /* 소계행 */ }

// 소계/누계 행을 제외한 데이터 행만 가져오기
var dataRows = sheet.getDataRows(1);

getPrevRow / getNextRow 등 행 탐색 함수는 소계행도 포함해 반환하므로, 소계를 건너뛰려면 위 방법으로 판별하거나 getDataRows(1) 배열을 사용하세요. 소계행 전체 목록이 필요하면 getSubTotalRows를 사용합니다.

Read More

• SearchMode cfg
• CalcMergeMode cfg
• onDataLoad event
• removeSubTotal method
• getSubTotalRows method
• NoCalculate row

Since