SuitsDocs
레퍼런스노드 레퍼런스액션액션데이터데이터

Excel 파싱

Excel(XLSX/XLS/CSV) 파일을 JSON으로 변환하거나, JSON 데이터를 Excel/CSV 파일로 생성합니다.

개요

항목내용
카테고리데이터
연동 필요없음
지원 작업Excel -> JSON (파일 읽기), JSON -> Excel (파일 생성)
지원 형식XLSX, XLS, CSV

작업 종류

작업설명
Excel -> JSON (파일 읽기)Base64로 인코딩된 Excel/CSV 파일을 JSON 배열로 변환
JSON -> Excel (파일 생성)JSON 데이터를 XLSX 또는 CSV 파일로 변환

설정 옵션

Excel -> JSON (파일 읽기)

옵션설명필수
소스 필드이전 노드 데이터에서 파일 내용(Base64)이 담긴 필드명
시트 이름읽을 시트 이름 (비워두면 첫 번째 시트)
첫 행을 헤더로 사용첫 행을 컬럼 헤더로 사용 (비활성 시 인덱스가 키)
읽을 범위읽을 셀 범위, 예: A1:D10 (비워두면 전체)
빈 셀 포함빈 셀도 빈 문자열로 결과에 포함

JSON -> Excel (파일 생성)

옵션설명필수
첫 행을 헤더로 사용첫 행에 컬럼명 포함 여부
빈 셀 포함빈 값도 포함 여부
결과 필드명생성된 파일(Base64)을 저장할 필드명
출력 형식XLSX 또는 CSV

활용 예시

업로드된 Excel 파일 처리

트리거: 파일 업로드
액션 1: Excel 파싱 (Excel -> JSON)
├── 소스 필드: data
├── 시트 이름: "Sheet1"
├── 첫 행을 헤더로 사용: 활성
액션 2: 반복 (파싱 결과)
액션 3: 행 생성 (데이터모델)

데이터를 Excel 파일로 내보내기

트리거: 수동 실행
액션 1: 행 조회 (매출 데이터모델)
액션 2: Excel 파싱 (JSON -> Excel)
├── 출력 형식: XLSX
├── 첫 행을 헤더로 사용: 활성
└── 결과 필드명: excelData
액션 3: 이메일 발송
└── 첨부: {{actions.excelParse.excelData}}

특정 범위만 읽기

트리거: 파일 업로드
액션 1: Excel 파싱 (Excel -> JSON)
├── 소스 필드: data
├── 읽을 범위: "B2:F50"
├── 첫 행을 헤더로 사용: 활성
액션 2: 반복 (필터링된 데이터)

모범 사례

파일 형식(XLSX/XLS/CSV)은 자동 감지됩니다. 별도로 형식을 지정할 필요가 없습니다.

대용량 파일 처리

대용량 Excel 파일 처리 시 메모리 사용량에 유의하세요. 필요한 범위만 읽도록 "읽을 범위" 옵션을 활용하면 성능이 향상됩니다.