RealPivot2 개요
브라우저에서 다차원 데이터를 엑셀 피벗처럼 집계·필터·시각화하여 사용할 수 있는 JavaScript 웹 컴포넌트 라이브러리입니다.
행·열·값·필터를 배치하면 즉시 집계 결과가 갱신되며, 셀 단위 탐색·오버레이·내보내기 등의 기능을 지원합니다.

이런 경우에 사용합니다
- 웹 업무 시스템·대시보드에 인터랙티브 피벗 분석을 넣어야 할 때
- 엑셀 피벗에 익숙한 사용자에게 드래그 앤 드롭 UI를 그대로 제공하고 싶을 때
- 집계 숫자뿐 아니라 원본 행·차트·지도까지 이어서 보고 싶을 때
- Excel / CSV / PDF로 보고서 출력이 필요할 때
핵심 개념
| 개념 | 설명 |
|---|---|
| Book | 여러 피벗 테이블(시트)을 담는 최상위 단위. 공통 필터·메뉴·테마를 공유합니다. |
| Table (Page) | 하나의 피벗 뷰. 행·열·값·필터 배치와 소계·총계·렌더러 등이 테이블마다 독립적으로 적용됩니다. |
| Cube | 차원(Dimension)·측정값(Measure) 스키마와 집계 엔진. 데이터셋 위에 분석 모델을 올립니다. |
| Field | 행·열·필터에 올리는 차원, 값에 올리는 측정값. 인스펙터나 필드 바에서 배치합니다. |
설정 객체의 전체 구조는 Config 개요와 PivotBookConfiguration을 참고하세요.
화면 구성
RealPivot2 UI는 북 헤더 · 인스펙터 · 피벗 테이블 · 탐색기 · 북 푸터로 나뉩니다.

| # | 영역 | 역할 |
|---|---|---|
| 1 | 북 헤더 | 메뉴(보내기·설정·Undo/Redo), 공용 필터, 인스펙터·탐색기 위치 전환 |
| 2 | 인스펙터 | 전체 필드 목록. 검색·드래그로 필드를 찾는 시작점 |
| 3 | 필드 바 | 행·열·값·필터 섹션. 현재 테이블에 배치된 필드를 표시 (엑셀 피벗 필드 목록과 유사) |
| 4 | 열 바 | 테이블 상단의 열·값·필터 필드 칩. 메뉴로 정렬·필터·집계 변경 |
| 5 | 행 바 | 테이블 좌측의 행 필드 칩 |
| 6 | 열 헤더 | 열 차원 계층 (위→아래) |
| 7 | 행 헤더 | 행 차원 계층 (왼쪽→오른쪽) |
| 8 | 본문 | 집계 결과가 그려지는 메인 그리드 |
| 9 | 탐색기 | 셀 선택 시 Detail / Chart / Map 패널로 드릴다운 |
| 10 | 북 푸터 | 시트 탭, 행·열 수 등 상태 정보 |
분석 흐름
일반적인 사용 순서는 다음과 같습니다.
- 데이터·큐브 준비 — JSON/CSV 데이터를 DataSet으로 불러온 뒤, Cube 스키마(차원·측정값)를 정의합니다.
- 필드 배치 — 인스펙터에서 행·열·값·필터를 드래그합니다.
- 집계·표시 조정 — 집계 함수, showAs, 숫자 서식, 소계·총계 위치를 맞춥니다.
- 필터·정렬 — 공통 필터·집계 필터·라벨/값 정렬로 범위를 좁힙니다.
- 시각화·강조 — 데이터바·히트맵·강조·아이콘셋, 렌더러(스파크)로 패턴을 드러냅니다.
- 탐색·내보내기 — 탐색기를 통해 원본 데이터, 차트, 지도를 확인하고 Excel, CSV, PDF 형식으로 내보냅니다.

주요 기능
필드 구성 · 다차원 집계
- 행 / 열 / 값 / 필터 섹션에 필드를 자유롭게 배치
- 날짜 차원의 연·반기·분기·월 등 파생 단위(Date 분해)
- 합계·평균·개수·최소·최대 등 집계 함수와 showAs(비중·순위 등)
- 소계·총계의 표시 여부(
visible), 위치(position), 스크롤 고정(fixed) 제어 - 트리·그리드 행 헤더 지원 및 값을 행으로 표시하는 기능(
valuesAsRows)
필터 · 정렬
- 북 공통 필터(드롭다운·트리·슬라이더 등)와 테이블 집계 필터
- 라벨 정렬, 값 기준 정렬, fallback 정렬
셀 오버레이
값 셀 위에 시각적 장식을 겹칩니다.
- 데이터바 · 히트맵 · 강조(규칙) · 아이콘셋
렌더러 (스파크)
소계·총계 옆 등에 미니 차트 열을 생성할 수 있습니다. 셀 오버레이(조건부 서식)와 달리 별도 열입니다.
sparkbar— 구간별 크기 비교 바 차트sparkline— 추세 및 흐름 꺾은선 차트sparkwinloss— 기준값 대비 승/패 비교 차트

탐색기 (Drill-down)
셀을 더블클릭하거나 선택 후 탐색기를 열면:
| 패널 | 내용 |
|---|---|
| Detail | 집계에 기여한 원본 행 목록 |
| Chart | 동일 계층 항목 비교 차트 |
| Map | 지역·좌표가 있을 때 지도 시각화 |

내보내기 · Undo
- Excel / CSV / PDF 보내기
- 필드 배치·옵션 변경에 대한 Undo / Redo
AI Assistant (선택)
RealPivot2는 AI 모델·서비스를 제공하지 않으며, 외부 AI와 연동하는 패널·도구·실행 API만 제공합니다.
설정·연동 방법은 AI Assistant를 참고하세요.
문서 읽는 순서
| 순서 | 문서 | 목적 |
|---|---|---|
| 1 | 이 페이지 | 제품·화면·기능 지도 |
| 2 | 데모 | 동작하는 샘플로 감 잡기 |
| 3 | Config | PivotBookConfiguration 설정 트리 |
| 4 | API | 클래스·옵션·타입 레퍼런스 |