FTP/SFTP
ssemworks-microservice-base.ftp통신/외부전송
FTP·SFTP 서버에서 파일을 업/다운로드하거나 목록을 조회한다.
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 타입 | ssemworks-microservice-base.ftp |
| 표시 이름 | FTP/SFTP |
| 카테고리 | 통신/외부 |
| 그룹 | input |
| 버전 | 1 |
자격증명
| 이름 | 필수 |
|---|---|
ftp | 예 |
입출력
- 입력: 메인(main)
- 출력: 메인(main)
파라미터
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 프로토콜 | protocol | 선택 | ftp | 사용할 전송 프로토콜 선택지: FTP( ftp) · SFTP(sftp) |
| 동작 | operation | 선택 | download | 수행할 동작 선택지: 목록 조회( list) · 다운로드(download) · 업로드(upload) · 삭제(delete) · 이름변경/이동(rename) |
| 경로 | path | 문자열 | "" | 대상 경로 (표현식 사용 가능) 표시 조건: operation = "list" 또는 "download" 또는 "upload" 또는 "delete" |
| 이전 경로 | oldPath | 문자열 | "" | 이름변경/이동 대상의 현재 경로 (표현식 사용 가능) 표시 조건: operation = "rename" |
| 새 경로 | newPath | 문자열 | "" | 이름변경/이동 후 경로 (표현식 사용 가능) 표시 조건: operation = "rename" |
| 바이너리 프로퍼티명 | binaryPropertyName | 문자열 | data | 다운로드 결과를 담을(또는 업로드 시 읽을) base64 바이너리 필드명 표시 조건: operation = "download" 또는 "upload" |
| 바이너리 데이터 사용 | binaryData | 불리언 | true | true 면 입력의 바이너리 프로퍼티명 필드(base64)를 업로드, false 면 텍스트 필드(fileContent)를 업로드 표시 조건: operation = "upload" |
| 파일 내용 | fileContent | 문자열 | "" | 업로드할 텍스트 본문 (표현식 사용 가능, 바이너리 데이터 사용=false 일 때) 표시 조건: operation = "upload", binaryData = false |
| 옵션 | options | 컬렉션 | {} | — |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 타임아웃(ms) | timeout | 숫자 | 10000 | 연결/응답 타임아웃(밀리초) |
| 폴더 대상 | folder | 불리언 | false | 동작=삭제일 때만 적용. 삭제 대상이 파일이 아닌 디렉토리인지 여부 |
| 상위 디렉토리 자동 생성 | createDirectories | 불리언 | false | 동작=이름변경/이동일 때만 적용. 새 경로의 상위 디렉토리가 없으면 생성 후 재시도할지 여부 |