SpreadJS로 공공기관 웹 예산 시스템 개발하기 — JavaScript 실전 가이드
웹 프론트엔드를 개발하다 보면 "엑셀 파일을 그대로 웹에서 열고 편집하게 해달라"는 요구사항을 받는 경우가 있습니다. SpreadJS는 이런 요구사항을 순수 JavaScript로 구현할 수 있는 엔터프라이즈 스프레드시트 컴포넌트로, xlsx 가져오기·수식 계산·조건부 서식·PDF 출력을 별도 서버 없이 브라우저 환경에서 모두 처리합니다.
특히 공공기관 SI 프로젝트나 행정 업무 시스템에서는 Excel 기반 예산 프로세스를 웹으로 전환해야 하는 상황이 자주 생깁니다. 이메일로 오가는 수십 개의 파일, 버전 충돌, 동시 편집 불가, 수동 PDF 작성 — 이 비효율들은 모두 웹 시스템 전환으로 해소할 수 있지만, 현업 담당자가 화면을 새로 익혀야 한다는 저항이 도입의 가장 큰 걸림돌입니다.
SpreadJS를 사용하면 기존 .xlsx 예산 서식을 수식·셀 병합·인쇄 설정 그대로 웹 앱에 불러올 수 있어 담당자가 UI를 새로 배울 필요가 없습니다. CDN 스크립트 두 줄만 추가하면 기존 전자정부 프레임워크나 Spring 포털에 즉시 통합할 수 있어 도입 비용도 최소화됩니다.

공공기관 예산 담당자는 왜 아직도 Excel에서 벗어나지 못하는가?
한국 정부의 디지털플랫폼정부 추진으로 공공기관 행정업무의 웹 전환 압력이 가속화되고 있습니다. 특히 예산 집행 관리는 Excel 의존도가 가장 높은 영역으로, 현장에서 반복되는 문제들이 명확합니다.
| 문제 영역 | 기존 Excel 방식 | 웹 시스템 전환 후 |
|---|---|---|
| 버전 관리 | 파일명에 "최종_수정2" | 단일 소스·실시간 반영 |
| 동시 편집 | 파일 잠금으로 불가 | 다중 사용자 동시 접근 |
| 보안 | 이메일 첨부·유출 위험 | 접근 권한 중앙 통제 |
| 감사 추적 | 수정 이력 없음 | 변경 로그 자동 기록 |
| 결재 보고 | 서식 수동 편집 후 출력 | PDF 자동 생성 |
JavaScript로 Excel 기능을 구현할 때 SpreadJS를 선택하는 이유
SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 스프레드시트 컴포넌트로, 브라우저 환경에서 Excel과 동일한 사용자 경험을 제공합니다. 공공기관 예산 시스템에 적합한 세 가지 핵심 강점이 있습니다.
첫째, 기존 Excel 서식 무손실 이전
Excel 가져오기 기능을 통해 예산 담당자가 수년간 사용해온 .xlsx 파일을 그대로 웹으로 불러옵니다. 수식, 셀 병합, 조건부 서식, 인쇄 설정까지 모두 보존됩니다.
둘째, 세출예산 다계층 구조 완벽 지원
세출예산의 장·관·항·세항·목으로 이어지는 다계층 예산 코드 구조도 SpreadJS의 아웃라인 및 그룹화 기능으로 그대로 재현할 수 있습니다. 상위 계층 값은 하위 항목 합산 수식으로 자동 갱신됩니다.
셋째, 공문서 수준 PDF 출력
savePDF()
API 하나로 인쇄 여백, 머리글·바닥글, 페이지 번호가 포함된 결재 문서 형태의 PDF를 코드에서 직접 생성합니다.
.xlsx 예산 파일을 코드 한 줄로 웹 앱에서 열고 저장하는 방법
기존 Excel 예산 서식을 웹으로 이전하는 가장 빠른 방법은 SpreadJS의 import
/ export
API를 활용하는 것입니다. v16부터 gc.spread.sheets.io
플러그인 한 개로 가져오기·내보내기가 모두 처리됩니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: JavaScript 코드
spread.import()
메서드는 .xlsx 파일의 수식, 셀 병합, 조건부 서식, 인쇄 설정까지 모두 그대로 불러옵니다. 기존 Excel 예산 서식을 수정하지 않고 바로 웹에서 사용할 수 있습니다.
예산 집행률을 실시간으로 계산하고 시각화하는 대시보드 구현하기
공공기관 예산 관리의 핵심은 부서별·과목별 집행률을 한눈에 파악하는 것입니다. SpreadJS의 조건부 서식과 수식 엔진을 결합하면 즉시 갱신되는 예산 집행 현황판을 구축할 수 있습니다.
아래 데모는 7개 부서의 2024년 세출예산 집행 현황을 실시간으로 표시하며, 집행률에 따라 3단계 색상 경보를 조건부 서식으로 자동 적용합니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: JavaScript 코드
add3ScaleRule()
로 3색 스케일을 적용하면 저집행(빨강)→보통(노랑)→정상(녹색) 구간을 한눈에 파악할 수 있습니다. 행정감사 전 집행 부진 부서를 즉시 식별하는 데 효과적입니다.
JavaScript로 공문서 수준의 PDF 보고서를 자동 출력하는 방법
공공기관에서 예산 관련 문서는 PDF 형태로 결재·보관됩니다. SpreadJS의 savePDF()
메서드로 스프레드시트를 공문서 수준의 PDF로 즉시 변환할 수 있습니다. PDF 플러그인만 추가하면 서버 없이 클라이언트 측에서 완전히 처리됩니다.
STEP 1: 라이브러리 참조 (CDN)
STEP 2: HTML 구조
STEP 3: JavaScript 코드
printInfo.showGridLine(false)
설정으로 격자선을 숨기고, showRowHeader
/ showColumnHeader
를 hide
로 설정하면 행·열 번호가 제외된 깔끔한 공문서 형태의 PDF가 생성됩니다. savePDF()
의 options
객체에 title, author, subject를 지정해 PDF 문서 속성도 설정할 수 있습니다.개발자가 자주 묻는 질문
JavaScript로 공공기관 Excel 예산 파일을 웹 앱에서 열려면 어떻게 해야 하나요?
SpreadJS의 spread.import()
메서드에 .xlsx 파일 객체를 전달하면 수식과 서식을 그대로 유지한 채 웹 브라우저에서 렌더링됩니다. 기존 Excel 서식을 수정하지 않아도 되므로 현업 담당자의 적응 부담이 최소화됩니다.
SpreadJS로 예산 집행 관리 화면을 처음 개발할 때 어디서부터 시작하면 되나요?
Workbook·Worksheet API로 예산 데이터를 표에 렌더링한 뒤, 내장 수식 엔진으로 잔액을 자동 계산하고 조건부 서식으로 집행률을 색상으로 구분할 수 있습니다. 기본 구현은 CDN 스크립트 두 개(스프레드시트 본체 + IO 플러그인)를 페이지에 추가하는 것만으로 시작할 수 있습니다.
공공기관 프로젝트에서 SpreadJS를 기술 선택 근거로 제시할 수 있는 이유는 무엇인가요?
Excel과의 높은 호환성, 전자정부 프레임워크에 통합 가능한 순수 JS 구조, 세출예산 다계층 코드 처리 지원, 공문서 수준의 PDF 출력 기능이 주요 근거입니다. 클라이언트만으로 동작해 별도 서버 처리가 필요 없어 도입 및 운영 비용이 낮다는 점도 설득력 있는 이유입니다.
기존 엑셀 예산 서식을 웹에서 수식·서식 그대로 열 수 있나요?
가능합니다. spread.import(file, success, error, { fileType: GC.Spread.Sheets.FileType.excel })
한 줄 호출로 기존 .xlsx 파일을 수식과 셀 서식 손실 없이 브라우저에서 엽니다. IO 플러그인 스크립트를 페이지에 추가하는 것 외에 별도 설정이 필요하지 않습니다.
SpreadJS로 공공기관 예산 보고서를 PDF로 자동 출력하려면 어떻게 구현하나요?
PDF 플러그인( gc.spread.sheets.pdf.19.0.6.min.js
)을 로드한 뒤 spread.savePDF(successCallback, errorCallback, options)
를 호출하면 됩니다. printInfo
객체로 여백, 격자선 표시 여부, 머리글·바닥글, 페이지 번호 등을 지정해 공문서 양식에 맞는 PDF를 코드에서 직접 생성할 수 있습니다.
