스프레드시트 파일
ssemworks-microservice-base.spreadsheetFile파일변환일부 옵션 미지원 라벨 있음
CSV/XLSX 등 스프레드시트를 읽거나 생성한다.
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 타입 | ssemworks-microservice-base.spreadsheetFile |
| 표시 이름 | 스프레드시트 파일 |
| 카테고리 | 파일 |
| 그룹 | transform |
| 버전 | 1 |
입출력
- 입력: 메인(main)
- 출력: 메인(main)
파라미터
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 동작 | operation | 선택 | fromFile | 파일에서 읽거나(행 목록 추출) 파일로 생성 선택지: 파일에서 읽기( fromFile) · 파일로 생성(toFile) |
| 필드명 | binaryPropertyName | 문자열 | data | fromFile: base64 파일이 담긴 입력 필드명 / toFile: 생성 파일(base64)을 담을 출력 필드명 |
| 파일 형식 | fileFormat | 선택 | autodetect | 읽을 파일 형식 (자동판별은 확장자/MIME/매직바이트로 감지) 선택지: 자동 감지( autodetect) · CSV(csv) · XLS(xls) · XLSX(xlsx) · ODS (미지원 — 오류 반환)(ods) · HTML (미지원 — 오류 반환)(html) · RTF (미지원 — 오류 반환)(rtf)표시 조건: operation = "fromFile" |
| 파일 형식 | fileFormat | 선택 | xls | 생성할 파일 형식 선택지: CSV( csv) · XLS(xls) · XLSX(xlsx) · ODS (미지원 — 오류 반환)(ods) · HTML (미지원 — 오류 반환)(html) · RTF (미지원 — 오류 반환)(rtf)표시 조건: operation = "toFile" |
| 옵션 | options | 컬렉션 | {} | 표시 조건: operation = "fromFile" |
| 옵션 | options | 컬렉션 | {} | 표시 조건: operation = "toFile" |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 헤더 행 사용 | headerRow | 불리언 | true | 첫 행을 헤더(필드명)로 사용할지 여부 |
| 원본 값 그대로(rawData) | rawData | 불리언 | false | xls/xlsx 셀 값을 파싱하지 않고 표시 형식 그대로 문자열로 반환 |
| 빈 셀 포함 | includeEmptyCells | 불리언 | false | 값이 없는 셀도 필드로 포함할지 여부 |
| 시트 이름 | sheetName | 문자열 | "" | 읽을 시트 이름 (xls/xlsx, 비어있으면 첫 시트) |
| 구분자 | delimiter | 문자열 | , | CSV 구분자 문자 (첫 글자만 사용) |
| 시작 라인(0부터) | fromLine | 숫자 | 0 | CSV 를 읽기 시작할 라인 번호(0-base) |
| 최대 행 수 | maxRowCount | 숫자 | -1 | 읽을 최대 데이터 행 수 (-1=무제한) |
| 시작 행(숫자) | range | 문자열 | "" | 읽기 시작할 행 번호(0-base 숫자만 지원, A1 표기 등 문자열 셀 범위는 미지원) |
| 인코딩 | encoding | 문자열 | utf-8 | csv/html 디코딩 인코딩 |
| BOM 제거 | enableBOM | 불리언 | false | CSV 앞의 BOM(Byte Order Mark)을 제거할지 여부 |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 헤더 행 포함 | headerRow | 불리언 | true | 생성 파일 첫 행에 헤더를 쓸지 여부 |
| 시트 이름 | sheetName | 문자열 | Sheet | 생성할 시트 이름 (표현식 사용 가능, 비어있으면 Sheet) |
| 구분자 | delimiter | 문자열 | , | CSV 구분자 문자 (첫 글자만 사용) |
| 파일명 | fileName | 문자열 | "" | 생성할 파일명 (표현식 사용 가능, 비어있으면 spreadsheet.<확장자>) |