가이드
RealPivot2 개요

RealPivot2 개요

브라우저에서 다차원 데이터를 엑셀 피벗처럼 집계·필터·시각화하여 사용할 수 있는 JavaScript 웹 컴포넌트 라이브러리입니다.

행·열·값·필터를 배치하면 즉시 집계 결과가 갱신되며, 셀 단위 탐색·오버레이·내보내기 등의 기능을 지원합니다.

RealPivot2 전체 화면 예시


이런 경우에 사용합니다

  • 웹 업무 시스템·대시보드에 인터랙티브 피벗 분석을 넣어야 할 때
  • 엑셀 피벗에 익숙한 사용자에게 드래그 앤 드롭 UI를 그대로 제공하고 싶을 때
  • 집계 숫자뿐 아니라 원본 행·차트·지도까지 이어서 보고 싶을 때
  • Excel / CSV / PDF로 보고서 출력이 필요할 때

핵심 개념

개념설명
Book여러 피벗 테이블(시트)을 담는 최상위 단위. 공통 필터·메뉴·테마를 공유합니다.
Table (Page)하나의 피벗 뷰. 행·열·값·필터 배치와 소계·총계·렌더러 등이 테이블마다 독립적으로 적용됩니다.
Cube차원(Dimension)·측정값(Measure) 스키마와 집계 엔진. 데이터셋 위에 분석 모델을 올립니다.
Field행·열·필터에 올리는 차원, 값에 올리는 측정값. 인스펙터나 필드 바에서 배치합니다.

설정 객체의 전체 구조는 Config 개요PivotBookConfiguration을 참고하세요.


화면 구성

RealPivot2 UI는 북 헤더 · 인스펙터 · 피벗 테이블 · 탐색기 · 북 푸터로 나뉩니다.

RealPivot2 UI 영역 구성

#영역역할
1북 헤더메뉴(보내기·설정·Undo/Redo), 공용 필터, 인스펙터·탐색기 위치 전환
2인스펙터전체 필드 목록. 검색·드래그로 필드를 찾는 시작점
3필드 바행·열·값·필터 섹션. 현재 테이블에 배치된 필드를 표시 (엑셀 피벗 필드 목록과 유사)
4열 바테이블 상단의 열·값·필터 필드 칩. 메뉴로 정렬·필터·집계 변경
5행 바테이블 좌측의 행 필드 칩
6열 헤더열 차원 계층 (위→아래)
7행 헤더행 차원 계층 (왼쪽→오른쪽)
8본문집계 결과가 그려지는 메인 그리드
9탐색기셀 선택 시 Detail / Chart / Map 패널로 드릴다운
10북 푸터시트 탭, 행·열 수 등 상태 정보

분석 흐름

일반적인 사용 순서는 다음과 같습니다.

  1. 데이터·큐브 준비 — JSON/CSV 데이터를 DataSet으로 불러온 뒤, Cube 스키마(차원·측정값)를 정의합니다.
  2. 필드 배치 — 인스펙터에서 행·열·값·필터를 드래그합니다.
  3. 집계·표시 조정 — 집계 함수, showAs, 숫자 서식, 소계·총계 위치를 맞춥니다.
  4. 필터·정렬 — 공통 필터·집계 필터·라벨/값 정렬로 범위를 좁힙니다.
  5. 시각화·강조 — 데이터바·히트맵·강조·아이콘셋, 렌더러(스파크)로 패턴을 드러냅니다.
  6. 탐색·내보내기 — 탐색기를 통해 원본 데이터, 차트, 지도를 확인하고 Excel, CSV, PDF 형식으로 내보냅니다.

인스펙터에서 필드를 열 영역으로 드래그하는 장면


주요 기능

필드 구성 · 다차원 집계

  • 행 / 열 / 값 / 필터 섹션에 필드를 자유롭게 배치
  • 날짜 차원의 연·반기·분기·월 등 파생 단위(Date 분해)
  • 합계·평균·개수·최소·최대 등 집계 함수와 showAs(비중·순위 등)
  • 소계·총계의 표시 여부(visible), 위치(position), 스크롤 고정(fixed) 제어
  • 트리·그리드 행 헤더 지원 및 값을 행으로 표시하는 기능(valuesAsRows)

필터 · 정렬

  • 북 공통 필터(드롭다운·트리·슬라이더 등)와 테이블 집계 필터
  • 라벨 정렬, 값 기준 정렬, fallback 정렬

셀 오버레이

값 셀 위에 시각적 장식을 겹칩니다.

  • 데이터바 · 히트맵 · 강조(규칙) · 아이콘셋

렌더러 (스파크)

소계·총계 옆 등에 미니 차트 열을 생성할 수 있습니다. 셀 오버레이(조건부 서식)와 달리 별도 열입니다.

  • sparkbar — 구간별 크기 비교 바 차트
  • sparkline — 추세 및 흐름 꺾은선 차트
  • sparkwinloss — 기준값 대비 승/패 비교 차트

sparkline·sparkbar 렌더러 Trend 열이 보이는 피벗 화면

탐색기 (Drill-down)

셀을 더블클릭하거나 선택 후 탐색기를 열면:

패널내용
Detail집계에 기여한 원본 행 목록
Chart동일 계층 항목 비교 차트
Map지역·좌표가 있을 때 지도 시각화

피벗과 하단 탐색기(Detail)가 함께 보이는 화면

내보내기 · Undo

  • Excel / CSV / PDF 보내기
  • 필드 배치·옵션 변경에 대한 Undo / Redo

AI Assistant (선택)

RealPivot2는 AI 모델·서비스를 제공하지 않으며, 외부 AI와 연동하는 패널·도구·실행 API만 제공합니다.
설정·연동 방법은 AI Assistant를 참고하세요.


문서 읽는 순서

순서문서목적
1이 페이지제품·화면·기능 지도
2데모동작하는 샘플로 감 잡기
3ConfigPivotBookConfiguration 설정 트리
4API클래스·옵션·타입 레퍼런스

바로 화면을 만져 보려면 데모로, 옵션을 찾으려면 Config로 이동하세요.