EXCEL » Api

downloadfile

Description

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

Parameters

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

Return Value

Type Description
BOOL 정상 처리 여부

Remark

서버에 있는 엑셀 파일을 로드할 때 사용한다.

엑셀 파일 저장시 DRM이 적용되야 하는 경우에, 엑셀 파일에 대한 HTML File 오브젝트를 서버로 송신하여, DRM 해제된 엑셀 파일 데이터를 수신하여 저장할 때 사용한다.

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

Example

// "savefileobject" 버튼 이벤트 function btn_savefileobject_on_click(objInst) { // 엑셀 데이터를 HTML File 오브젝트 행텨로 저장 // 처리 완료시 "on_savefile" 이벤트를 통해서 저장된 HTML File 오브젝트가 전달되며, // 전달된 파일 오브젝트를 downloadfile API를 통해서 저장 가능 obj_excel.savefileobject("save.xlsx"); } /** * 엑셀 데이터를 HTML 파일 오브젝트 형태로 저장 완료 이벤트 * * @param objInst 엑셀 컴포넌트 인스턴스 * @param nResult 처리 결과 (1:성공, 그외 오류) * @param strCode 에러 코드 * @param strMsg 에러 메시지 * @param strFileName 파일 이름 * @param objFile HTML 파일 오브젝트 * @param nStartTime 처리 시작 시각 * @param nEndTime 처리 완료 시각 */ function excel_on_savefile(objInst, nResult, strCode, strMsg, strFileName, objFile, nStartTime, nEndTime) { console.log(arguments); // HTML File 오브젝트 및 데이터를 서버로 송신하고, 수신된 데이터를 파일로 저장 // 처리 완료시 "on_save" 이벤트 발생 obj_excel.downloadfile(objFile, "http://127.0.0.1/multisheet.xlsx"); }

Viewer Ver.

24.3.29.1

Update Date

20240401