파일로 변환
ssemworks-microservice-base.convertToFile파일변환일부 옵션 미지원 라벨 있음
아이템 데이터를 CSV/XLSX/JSON 등 파일(base64)로 변환한다.
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 타입 | ssemworks-microservice-base.convertToFile |
| 표시 이름 | 파일로 변환 |
| 카테고리 | 파일 |
| 그룹 | output |
| 버전 | 1 |
입출력
- 입력: 메인(main)
- 출력: 메인(main)
파라미터
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 동작 | operation | 선택 | csv | 생성할 파일 종류 선택지: CSV( csv) · HTML(html) · RTF(rtf) · ODS(ods) · XLS(xls) · XLSX(xlsx) · JSON(toJson) · 텍스트(toText) · 바이너리(base64 패스스루)(toBinary) · iCal (미지원 — 오류 반환)(iCal) |
| 출력 필드명 | binaryPropertyName | 문자열 | data | 생성된 파일(base64) 정보를 담을 출력 아이템의 json 필드명 표시 조건: operation = "csv" 또는 "html" 또는 "rtf" 또는 "ods" 또는 "xls" 또는 "xlsx" 또는 "toJson" 또는 "toText" 또는 "toBinary" |
| JSON 변환 모드 | mode | 선택 | once | once=전체 아이템을 배열 1개 파일로, each=아이템마다 파일 1개씩 선택지: 한 번에(전체 배열)( once) · 아이템별로(each)표시 조건: operation = "toJson" |
| 입력 필드명 | sourceProperty | 문자열 | "" | 파일 내용으로 쓸 입력 아이템의 필드명 (toText: 텍스트로 변환할 필드, toBinary: base64 데이터가 담긴 필드) — 필수 표시 조건: operation = "toText" 또는 "toBinary" |
| 옵션 | options | 컬렉션 | {} | 표시 조건: operation = "csv" 또는 "html" 또는 "rtf" 또는 "ods" 또는 "xls" 또는 "xlsx" 또는 "toJson" 또는 "toText" 또는 "toBinary" |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 헤더 행 포함 | headerRow | 불리언 | true | 표/스프레드시트 파일 첫 행에 헤더를 쓸지 여부 표시 조건: operation = "csv" 또는 "html" 또는 "rtf" 또는 "ods" 또는 "xls" 또는 "xlsx" |
| 시트 이름 | sheetName | 문자열 | Sheet | 생성할 시트 이름 (표현식 사용 가능, 비어있으면 Sheet) 표시 조건: operation = "csv" 또는 "html" 또는 "rtf" 또는 "ods" 또는 "xls" 또는 "xlsx" |
| 구분자 | delimiter | 문자열 | , | CSV 등 구분자 문자 (첫 글자만 사용) 표시 조건: operation = "csv" 또는 "html" 또는 "rtf" 또는 "ods" 또는 "xls" 또는 "xlsx" |
| 예쁘게 출력 | format | 불리언 | false | JSON 을 들여쓰기해 출력할지 여부 표시 조건: operation = "toJson" |
| 인코딩 | encoding | 문자열 | utf8 | 텍스트 파일 인코딩 표시 조건: operation = "toJson" 또는 "toText" |
| BOM 추가 | addBOM | 불리언 | false | 파일 앞에 BOM(Byte Order Mark)을 추가할지 여부 표시 조건: operation = "toJson" 또는 "toText" |
| MIME 타입 | mimeType | 문자열 | application/octet-stream | toBinary 로 생성되는 파일의 MIME 타입 표시 조건: operation = "toBinary" |
| 파일명 | fileName | 문자열 | "" | 생성할 파일명 (표현식 사용 가능, 비어있으면 형식별 기본값: File.<확장자>/file.json/file.txt/file) |