EXCEL » Api

uploadfile

Description

HTML File 오브젝트와 데이터를 서버로 송신하고, 수신된 엑셀 파일 데이터를 로드 API이다.

Parameters

Parameters Type Description
objFile INSTANCE 엑셀 파일에 대한 HTML File 오브젝트 (미 지정시, null 지정)
strUrl STRING 서버 URL
objPostData INSTANCE [옵션] 서버로 POST 방식으로 송신할 Simple 자바스크립트 오브젝트 (기본값: null)
bWithCredentials BOOL [옵션] AJAX CORS withCredentials 값 (기본값: true)

Return Value

Type Description
BOOL 정상 처리 여부

Remark

objFile 파라미터가 NULL인 경우, 서버로부터 수신된 엑셀 파일을 로드할 때 사용한다.

엑셀 파일에 DRM이 적용되어 있는 경우에, selectfile API를 통해서, 선택한 HTML File 오브젝트를 서버로 송신하여, DRM 해제된 엑셀 파일 데이터를 수신하여 로드할 때 사용한다.

objPostData 파라미터는 옵션 파라미터로 서버로 송신한 데이터를 일반 자바 스크립트 오브젝트로 지정한다.

Example

// "selectfile" 버튼 이벤트 function btn_selectfile_on_click(objInst) { // 로드 대상 파일 선택 // 처리 완료시 "on_selectfile" 이벤트 발생하며, // 선택한 파일에 대한 HTML File 오브젝트가 전달되며, // 전달된 파일 오브젝트를 loadfileobject API를 통해서 로드 obj_excel.selectfile(); } /** * selectfile API를 통한 로컬 파일 선택 이벤트 * * @param objInst 엑셀 컴포넌트 인스턴스 * @param objFile 선택한 파일에 대한 HTML File 오브젝트 */ function excel_on_selectfile(objInst, objFile) { // 선택한 엑셀 파일을 서버를 통해서 EXCEL 파일 업로드 obj_excel.uploafile(objFile, "http://127.0.0.1/uploadexcel.jsp"); } function uplaodFileTest(objFile, strUrl) { // CASE 1. // 서버에 있는 엑셀 파일에 대한 URL 지정하여 데이터 로드 // 처리 완료시 "on_load" 이벤트 발생 obj_excel.uploadfile(null, "http://127.0.0.1/excel.xlsx"); var post_data = { "POST_DATA_KEY_A": "VALUE_A", "POST_DATA_KEY_A": "VALUE_B" }; // CASE 2. // 서버로 데이터를 송신하고, // 수신된 엑셀 파일 데이터를 로드 // 처리 완료시 "on_load" 이벤트 발생 obj_excel.uploadfile(null, "http://127.0.0.1/uploadexcel.jsp", post_data); }

See Also

selectfile

Viewer Ver.

24.3.29.1

Update Date

20240401