GRID FEATURE · PRO
피벗 분석
피벗은 원본 주문을 행 축·열 축·값 축으로 나누어 교차 집계표를 만듭니다. 지역별 주문 행을 접는 그룹과 달리, 고유한 상태 값 등이 새로운 결과 열로 생깁니다.
동작 원리와 선택 기준
예를 들어 팀은 왼쪽 행, 지역은 위쪽 열, 수량은 합산할 값입니다. 세 축이 모두 준비된 상태에서 pivotMode를 켜고 숫자 필드마다 집계 방식을 선택합니다.
이 기능을 제품에서 사용하려면 Pro 패키지와 유효한 라이선스가 필요합니다. 설정 이름이 같더라도 Community에서 Pro 기능이 활성화되는 것은 아닙니다.
코드의 grid는 설치와 연결 장에서 준비한 Grid 요소입니다. 예제마다 필요한 데이터·설정을 확인하고, 코드에서 소개하는 앱 함수와 서버 주소는 프로젝트에 맞게 구현하세요.
예제 1. 팀 × 지역의 수량
원본 데이터에 team, region, quantity가 있는 표에 적용합니다.
grid.pivotRowGroupColumns = ['team'];
grid.pivotColumns = ['region'];
grid.pivotValueColumns = ['quantity'];
grid.pivotAggFuncs = { quantity: 'sum' };
grid.pivotMode = true;결과 확인: 지역마다 결과 열이 생기고 각 팀의 수량 합계가 채워집니다. 원본 주문 행 자체가 수정되는 것은 아닙니다.
예제 2. 소계와 총계 배치
여러 단계의 행 축을 사용하면서 중간 합계와 전체 합계의 위치를 정합니다.
grid.pivotRowGroupColumns = ['region', 'team'];
grid.pivotSubtotals = 'bottom';
grid.pivotGrandTotal = 'top';
grid.pivotPanelShow = 'always';결과 확인: 하위 그룹을 펼쳤을 때 소계를 아래에서 읽고, 전체 합계는 위에서 먼저 확인합니다.
예제 3. 생성된 결과 열 확인
차트나 내보내기를 연결하기 전에 결과 열의 실제 식별자와 현재 조합 상태를 읽습니다.
console.log(await grid.getPivotSecondaryColumns());
console.log(await grid.getPivotCombinationReport());결과 확인: 지역 라벨을 임의로 열 ID로 쓰지 않고 반환된 식별자를 사용합니다. 서버 피벗은 getServerPivotResultColumns()와 별도의 서버 응답 계약을 사용합니다.
조합할 때와 문제를 해결할 때
행 그룹·트리·피벗의 우선순위를 추측하지 마세요. 조합 보고서에 표시된 활성 기능과 제한을 먼저 확인합니다.
원본 필터가 피벗 집계에 자동으로 같은 방식으로 적용된다고 가정하지 마세요. 현재 집계 대상과 결과를 확인하고 필요하면 피벗에 공급할 데이터를 먼저 준비합니다.
함께 읽기
- 행·열·ID의 관계
- 결과와 이벤트 연결
- Features에서 살펴보기
직접 체험 가능한 범위는 해당 가이드에 안내되어 있습니다.