파일 읽기/쓰기

ssemworks-microservice-base.readWriteFile

파일IO

컨테이너 로컬 파일시스템에서 파일을 읽거나 쓴다(base64).

입출력 포트

입력

파일 읽기/쓰기

readWriteFile

데이터

데이터(main)

다이어그램 설명

• 입력: 메인 1개.
• 출력 포트 1개 — 결과 아이템이 다음 마이크로서비스로 전달됩니다.
• 색 규약 — 실선/파랑은 데이터(main) 흐름, 점선/색상 포트는 AI 서브마이크로서비스 연결(ai_*)입니다.

기본 정보

항목	값
서비스 타입	ssemworks-microservice-base.readWriteFile
표시 이름	파일 읽기/쓰기
카테고리	파일
그룹	input
버전	1

입출력

• 입력: 메인(main)
• 출력: 메인(main)

파라미터

파라미터	이름	타입	기본값	설명
동작	operation	선택	read	파일 읽기 또는 쓰기. 경로는 이 마이크로서비스가 실행되는 컨테이너 로컬 파일시스템 기준 선택지: 디스크에서 읽기(read) · 디스크에 쓰기(write)
파일 선택	fileSelector	문자열	""	읽을 파일 경로 또는 glob 패턴 — 필수. 일치하는 파일마다 출력 아이템 1개 표시 조건: operation = "read"
파일 경로	fileName	문자열	""	저장할 파일의 전체 경로 — 필수 표시 조건: operation = "write"
입력 필드명	dataPropertyName	문자열	data	저장할 base64 바이너리가 담긴 입력 아이템의 json 필드명 표시 조건: operation = "write"
옵션	options	컬렉션	{}	표시 조건: operation = "read"
옵션	options	컬렉션	{}	표시 조건: operation = "write"

옵션 하위 필드

파라미터	이름	타입	기본값	설명
출력 필드명	dataPropertyName	문자열	data	읽은 파일(base64) 데이터를 담을 출력 아이템의 json 필드명
파일명 지정	fileName	문자열	""	출력 파일명을 강제 지정(비어있으면 실제 파일명 사용)
파일 확장자 지정	fileExtension	문자열	""	출력 파일 확장자를 강제 지정(비어있으면 파일명에서 추출)
MIME 타입 지정	mimeType	문자열	""	출력 MIME 타입을 강제 지정(비어있으면 확장자로 추정)

옵션 하위 필드

파라미터	이름	타입	기본값	설명
이어쓰기(append)	append	불리언	false	true 면 기존 파일 뒤에 이어쓰기(여러 아이템을 같은 경로로 쓰면 순차 append)