레퍼런스노드 레퍼런스트리거트리거
파일 업로드 트리거
CSV, Excel 등 파일을 업로드하여 워크플로우를 시작합니다.
개요
| 항목 | 내용 |
|---|---|
| 카테고리 | 트리거 |
| 연동 필요 | 없음 |
| 동작 방식 | 사용자가 파일을 업로드하면 워크플로우 실행 |
설정 옵션
| 옵션 | 설명 | 필수 |
|---|---|---|
| 허용 파일 형식 | 업로드를 허용할 파일 확장자 (콤마 구분) | |
| 최대 파일 크기 (MB) | 업로드 가능한 최대 파일 크기 (1~100MB) | |
| 안내 텍스트 | 파일 업로드 시 사용자에게 보여줄 안내 문구 |
기본값
- 허용 파일 형식:
.csv, .xlsx, .xls - 최대 파일 크기: 10MB
출력 데이터
업로드된 파일의 정보가 트리거 출력으로 전달됩니다.
| 필드 | 설명 |
|---|---|
data | 파일 내용 (Base64 인코딩) |
fileName | 파일 이름 |
fileSize | 파일 크기 |
mimeType | 파일 MIME 타입 |
활용 예시
CSV 파일 업로드 후 데이터모델에 저장
트리거: 파일 업로드
├── 허용 파일 형식: .csv
├── 안내 텍스트: "주문 데이터 CSV 파일을 업로드하세요"
액션 1: CSV 파싱
├── 소스 필드: data
├── 구분자: 쉼표
├── 첫 행을 헤더로 사용: 활성
액션 2: 반복 (파싱 결과)
액션 3: 행 생성 (주문 데이터모델)Excel 파일 업로드 후 처리
트리거: 파일 업로드
├── 허용 파일 형식: .xlsx,.xls
├── 최대 파일 크기: 50
├── 안내 텍스트: "재고 현황 Excel 파일을 업로드하세요"
액션 1: Excel 파싱 (Excel -> JSON)
├── 소스 필드: data
├── 첫 행을 헤더로 사용: 활성
액션 2: 반복 (파싱 결과)
액션 3: 행 생성 (재고 데이터모델)대량 데이터 업데이트
트리거: 파일 업로드
├── 허용 파일 형식: .csv,.xlsx,.xls,.json
├── 안내 텍스트: "가격 변경 데이터를 업로드하세요"
액션 1: 조건 분기 (파일 형식)
├── CSV → CSV 파싱
├── Excel → Excel 파싱
액션 2: 반복 (파싱 결과)
액션 3: 행 수정 (상품 데이터모델)모범 사례
파일 업로드 트리거는 CSV 파싱 또는 Excel 파싱 노드와 함께 사용하면 효과적입니다. 업로드된 파일의 데이터(Base64)를 파싱 노드의 소스 필드로 연결하세요.
파일 형식 제한
허용 파일 형식을 적절히 제한하여 사용자 실수를 방지하세요. 예를 들어 CSV만 허용하려면 .csv만 입력합니다.
파일 크기 관리
대용량 파일은 처리 시간이 길어질 수 있으므로 적절한 크기 제한을 설정하세요.