콘텐츠로 이동

File Uploader

목적

Application 외부에서 파일을 업로드하기 위한 절차 및 설정 방법 제공


주요 단계

1. File Uploader UI 추가 및 설정

1.1. File Uploader UI를 추가

1.2. Properties에서 uploadOnChange 값을 true로 설정

1.3. Events > uploadComplete 이벤트 추가

이미지

<사진 1> File Uploader UI 및 설정 화면


2. File Uploader 속성 설명

이미지

<사진 2> File Uploader Properties 상세 화면

2.1. 주요 Properties 리스트

Name Description
sameFilenameAllowed - 동일 파일명을 여러 번 업로드 가능 여부 설정
- false일 경우 동일 파일명 업로드 시 이벤트가 호출되지 않음
fileType - 허용된 파일 확장자 설정
- 확장자가 입력되지 않으면 모든 파일이 업로드 가능
- 여러 확장자는 콤마로 구분
multiple - 여러 파일을 한 번에 업로드 가능 여부 설정
- true로 설정 시 여러 파일 동시 업로드 가능
maximumFileSize - 업로드 가능한 파일의 최대 크기 설정 (단위: MB)
- 다중 업로드 시 총합 크기가 초과할 경우 업로드 제한
mimeType - 파일 선택 창에서 필터링할 MIME 타입 설정
- 필터링만 제공하며 업로드 대상 확장자가 설정되지 않으면 업로드 불가
placeholder - 파일 입력 필드의 배경 텍스트 설정
style - 버튼 스타일 설정
- 버튼의 색상, 모양 등을 변경 가능
buttonOnly - UI 버튼만 표시 여부 설정
- true로 설정 시 입력 필드 없이 버튼만 표시
maximumFilenameLength - 파일 제목 길이 제한 설정
- 초과 시 업로드 제한 및 이벤트 호출

3. File Uploader Events 설명

이미지

<사진 3> File Uploader 이벤트 동작 화면

Name Description
uploadComplete - 파일 업로드 성공 시 호출되는 Method
- 업로드 완료 후 관련 작업 수행 가능.
typeMismatch - 허용되지 않은 확장자 업로드 시 호출되는 Method
- 설정된 확장자 외 파일 업로드 시 호출
fileSizeExceed - 파일 크기 초과 시 호출되는 Method
- 설정된 크기를 초과한 파일 업로드 시 이벤트 발생
filenameLengthExceed - 파일 제목 길이 초과 시 호출되는 Method
- 제목 길이가 설정된 값을 초과할 경우 호출.

4. Application 실행 및 File Uploader 클릭

이미지

<사진 4> File Uploader 실행 화면


5. 파일 선택 후 열기 버튼 클릭

이미지

<사진 5> 파일 선택 및 업로드 버튼 화면


6. Upload Complete Method 확인

이미지

<사진 6> IT_FILES에 파일 데이터 삽입 확인 화면


7. IT_FILES 필드 정보 (TYPE : /U4A/Y0006)

이미지

<사진 7> IT_FILES 필드 상세 정보 화면

7.1. IT_FILES 필드 설명

Name Description
FNAME 파일 이름. 업로드된 파일의 이름이 저장됨.
FSIZE 파일 크기. 업로드된 파일의 크기(MB 단위)가 저장됨.
MIME 파일 타입. 업로드된 파일의 MIME 타입이 저장됨.
EXTEN 파일 확장자. 업로드된 파일의 확장자가 저장됨.
CONTENT 파일 내용 정보. 파일의 내용 또는 메타데이터 정보가 포함됨.

8. 업로드된 파일 확인

이미지

<사진 8> 업로드 완료 확인 화면


참고 자료