Upload
Upload은(는) 하나 이상의 파일을 업로드하고 반환된 파일 메타데이터를 Form에 바인딩합니다. 이 필드는 Form의 상태, 검증 및 제출 범위에 포함됩니다.
1. 사용 시점
일반적인 용도:
- 첨부 및 증빙 자료
- 이미지 또는 문서 업로드
- 형식, 개수 및 크기 제한이 필요한 파일 입력
2. 추가 및 구성
- Form Section의 Fields 영역에 Upload을(를) 추가합니다.
- 백엔드 DTO 속성과 일치하는 안정적이고 고유한 Field Key / Name을 설정합니다.
- 아래의 컴포넌트 속성을 구성하고 필요에 따라 Required, Help Text, Full row 또는 조건식을 추가합니다.
- Design Preview에서 초기값과 레이아웃을 확인한 다음 Form Validate / Submit으로 전체 데이터 경로를 테스트합니다.
3. 주요 속성
| 속성 | 역할 |
|---|---|
| Multiple | 이 동작을 켜거나 끕니다. |
| Form Upload / Upload URL | 선택 데이터의 원본과 매핑 방식을 정의합니다. |
| Component Style | Design Preview와 Runtime에서 필드가 표시되는 방식을 제어합니다. |
| Upload Format Filter | 허용되는 개수, 길이 또는 값 범위를 제한합니다. |
| Upload Count / Size Limit | 허용되는 개수, 길이 또는 값 범위를 제한합니다. |
| Enable Image Cropping | 이 동작을 켜거나 끕니다. |
Field Key, Required, Help Text, Full row, Visible When 같은 공통 속성은 Form 필드 계약에서 제공합니다. 표에는 Upload에 특히 중요한 설정을 정리했습니다.
4. Form 값과 백엔드 계약
제출 값: 업로드 응답과 매핑으로 결정되는 파일 메타데이터 배열이며 브라우저 바이너리 객체가 아닙니다.
[
{"id": "file-1024", "name": "evidence.pdf", "url": "/files/file-1024"}
]
예시는 데이터 형태만 보여 줍니다. API는 업무 DTO에 따라 형식, 범위 및 권한을 계속 검증해야 합니다.
5. 검증, 조건 및 인터랙션
모든 필드에서 Required, Visible When, Disabled When, Required When, Dependencies, Clear When Hidden을 사용할 수 있습니다. 조건식은 사용성을 높이지만 백엔드 검증이나 권한을 대체하지 않습니다.
컴포넌트 기능: setValue를 지원하며 업로드 성공 스크립트와 상태로 서버 응답을 처리합니다.
6. 구성 권장 사항
권장 사항: 먼저 요청 및 응답 JSON 계약을 고정한 뒤 배열 항목, 파일 메타데이터 및 서버 오류 경로를 종단 간 테스트하세요.
레이아웃, 검증, 제출, 초안 및 백엔드 프로토콜은 Form 개요를 참고하세요.