SpreadJS 피벗 테이블로 다점포 매출 KPI 웹 대시보드 만들기
웹 프론트엔드 개발을 하다 보면 '브라우저에서 엑셀처럼 동작하는 KPI 보고서를 만들어달라'는 요구를 받게 됩니다. HTML 테이블이나 일반 그리드 라이브러리로는 피벗 집계·조건부 서식·복합 차트를 함께 지원하기가 어렵고, 기존 xlsx 파일을 불러오면 서식이 무너지는 문제도 반복됩니다.
SpreadJS(스프레드JS)는 MESCIUS가 만든 JavaScript 스프레드시트 라이브러리로, React·Vue·Angular·Vanilla JS 환경에서 Excel과 동일한 피벗 테이블·조건부 서식·차트를 브라우저 안에서 직접 구현할 수 있게 해 줍니다. 서버 사이드 렌더링이나 외부 BI 도구 없이 프론트엔드 코드만으로 완성됩니다.
이 글에서는 유통·소매·프랜차이즈 업종에서 자주 요구되는 다점포 KPI 대시보드를 SpreadJS로 구현하는 전 과정을 단계별 코드와 함께 소개합니다. 피벗 테이블로 점별·월별 매출을 집계하고, 조건부 서식으로 달성·미달성을 시각화하며, 완성된 보고서를 xlsx로 내보내는 흐름을 따라가 보겠습니다.

다점포 KPI 보고서를 웹으로 옮기면 어떤 문제가 생기나요?
국내 유통·소매 기업의 웹 보고서 전환 프로젝트에서 가장 빈번하게 발생하는 문제는 서식과 수식의 손실입니다. 일반적인 HTML 테이블이나 그리드 라이브러리는 셀 병합·조건부 서식·피벗 집계를 지원하지 않아 기존 Excel 보고서의 구조를 그대로 옮길 수 없습니다.
SpreadJS는 이 문제에 직접 대응하는 컴포넌트입니다. Excel 가져오기 기능으로 xlsx를 불러오면 셀 서식·수식·조건부 서식이 거의 그대로 웹에 렌더링됩니다. 그 결과 현업 담당자들이 익숙한 레이아웃을 유지하면서도 웹 시스템의 실시간성과 협업 기능을 함께 활용할 수 있습니다.
SpreadJS 피벗 테이블로 점포별·기간별 매출 데이터를 집계하는 방법
SpreadJS 피벗 테이블은 원본 데이터 시트와 분리된 별도 시트에 크로스 탭 분석 뷰를 자동 생성합니다. 점포명을 행 필드, 월을 열 필드로 설정하면 점별×월별 매출 합계가 한 화면에 집계됩니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: 피벗 테이블 생성
columnField
에 월 데이터를 지정하면 1월·2월·3월이 자동으로 열로 펼쳐집니다. 하단의 "데이터" 시트 탭을 클릭하면 원본 데이터 구조를 확인할 수 있습니다.
JavaScript에서 조건부 서식으로 KPI 달성률을 색상과 아이콘으로 표시하는 방법
SpreadJS의 조건부 서식은 색상 스케일(ScaleRule)·데이터 바(DataBarRule)·아이콘 세트(IconSetRule) 세 가지 유형을 지원합니다. 다점포 KPI 요약 테이블에서 이 세 가지를 조합하면 담당자가 수치를 읽기 전에 달성 현황을 파악할 수 있습니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: KPI 현황판 + 조건부 서식 적용
IconSetRule
의 기본 임계값은 범위 내 최솟값 기준 백분위(0~33%, 33~67%, 67~100%)로 자동 계산됩니다. 달성률 기준이 고정값(예: 100%)인 경우, iconSetRule.icons()
API로 임계값을 직접 지정해 운영 기준에 맞게 조정할 수 있습니다.Column+Line 복합 차트로 월별 매출 추이와 목표치를 한 화면에서 비교하는 방법
매출액과 합계 추이처럼 같은 단위 데이터를 함께 표현할 때 SpreadJS의 복합 차트(Combo Chart)가 유용합니다. 막대형으로 점포별 월별 매출을 보여주고, 꺾은선형으로 전체 합계 추이를 겹쳐서 경영진이 흐름을 직관적으로 파악할 수 있도록 합니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: Column+Line 복합 차트 생성
chart.series().add()
의 name
, xValues
, yValues
는 셀 참조 문자열을 사용합니다. 워크시트 데이터가 갱신되면 차트도 자동으로 반영되므로, 실시간 KPI 대시보드에서 매우 유용합니다.
웹 앱에서 클릭 한 번으로 xlsx 경영진 보고서를 자동 생성하는 방법
SpreadJS IO 플러그인을 로드하면 spread.export()
호출 한 번으로 현재 워크북을 xlsx 파일로 내보낼 수 있습니다. 피벗·조건부 서식·차트가 모두 포함된 상태로 내보내므로 경영진이 Excel에서 열어도 서식이 그대로 유지됩니다.
STEP 1: IO 플러그인 CDN 추가
STEP 2: 내보내기 버튼 HTML
STEP 3: 내보내기 로직
spread.export()
는 현재 워크북에 로드된 모든 시트(피벗, 조건부 서식, 차트 포함)를 xlsx blob으로 내보냅니다. IO 플러그인 없이 호출하면 동작하지 않으니 반드시 CDN 스크립트를 함께 로드하세요.개발자들이 자주 묻는 질문
웹 앱에서 다점포 매출 KPI를 시각화하는 데 적합한 JavaScript 라이브러리는 무엇인가요?
SpreadJS는 피벗 테이블·조건부 서식·차트를 모두 지원해 별도 BI 도구 없이 웹 애플리케이션 안에서 Excel 수준의 KPI 분석 화면을 구현할 수 있습니다. 다점포 대시보드를 브라우저에서 바로 렌더링하므로 서버 의존도를 낮출 수 있습니다.
SpreadJS에서 피벗 테이블로 다점포 KPI 화면을 만들려면 어떻게 하나요?
sheet.pivotTables.add()
로 데이터 소스 테이블을 지정한 뒤 rowField
, columnField
, valueField
를 설정하면 크로스 탭 집계 뷰가 자동으로 생성됩니다. 피벗 플러그인( gc.spread.pivot.pivottables
)을 CDN 스크립트 태그로 추가하는 것만으로 바로 사용할 수 있습니다.
기존 Excel 보고서의 서식과 수식을 그대로 웹 화면으로 불러오는 방법이 있나요?
SpreadJS의 Excel 가져오기를 사용하면 xlsx 파일을 열 때 셀 서식·수식·조건부 서식이 거의 그대로 브라우저에 렌더링됩니다. IO 플러그인을 로드한 후 spread.import()
에 파일 객체를 전달하면 됩니다.
웹 스프레드시트에서 KPI 달성률을 조건부 서식으로 강조 표시하려면 어떻게 하나요?
sheet.conditionalFormats.addRule()
을 사용해 ScaleRule
(색상 스케일), DataBarRule
(데이터 바), IconSetRule
(아이콘 세트) 중 원하는 유형을 추가하면 됩니다. 셀 범위와 기준값만 지정하면 SpreadJS가 자동으로 시각적 효과를 적용합니다.
피벗 테이블·차트·조건부 서식이 포함된 KPI 보고서를 Excel 파일로 내보내는 방법은?
SpreadJS IO 플러그인을 사용해 spread.export(callback, errorCallback, { fileType: GC.Spread.Sheets.FileType.excel })
호출로 내보내기를 지원합니다. 피벗 테이블, 조건부 서식, 복합 차트가 모두 포함된 상태로 xlsx 파일이 생성됩니다.
