사용자가 선택한 엑셀 파일을 시트에 로드하지 않고 지정한 서버 측 페이지로 바로 전달합니다.
엑셀 내용을 시트에 띄울 필요 없이 서버에서 직접 처리하는 경우 사용합니다.
사용 전 서버모듈 설치와/plugins/ibsheet-excel.js스크립트 로드가 필요합니다.
이 함수를 호출하면 파일 선택 창이 나타나고, 사용자가 선택한 엑셀 파일이Cfg.Export속성에 지정한DirectLoadExcel.jsp(또는DirectLoadExcel.aspx)로 전달됩니다. 이 jsp 파일이 엑셀을 파싱한 뒤extendParam의FP인자로 지정한 서버 측 페이지로 데이터를 forward합니다.

void directLoadExcel( param );
| Name | Type | Required | Description |
|---|---|---|---|
| extendParam | string |
선택 | 전달할 parameter(querystring형식으로 작성, String 형태로 rquest.setAttribute("extendParam에 설정한 파라미터 이름")으로 담음) DirectLoadExcel.jsp에서 파싱한 정보를 처리할 서블릿(혹은 jsp)경로를 FP라는 이름으로 전달해야 함 |
| fileExt | string |
선택 | 업로드 가능한 파일 확장자를 구분자("|")로 연결하여 설정합니다. (default: "xls\|xlsx") |
| mode | string |
선택 | "HeaderMatch", "NoHeader", "HeaderSkip" 중에 하나의 문자열을 입력합니다. 각 문자의 의미는 다음과 같습니다.
default: "HeaderMatch")
|
| startRow | number |
선택 | 엑셀에서 시트가 몇번째 행에서 시작하는지 설정합니다. 설정하지 않으면 엑셀의 첫번째 행부터 (1부터시작) 읽어들임. |
| endRow | number |
선택 | 엑셀에서 시트가 몇번째 행까지 읽어들일지를 설정합니다. 설정하지 않으면 엑셀의 마지막 행까지 읽어들임. |
| workSheetName | string |
선택 | 읽어들일 엑셀 파일의 워크시트 명을 설정합니다. 일치하는 워크시트 명이 없으면 첫번째 워크시트를 읽습니다. |
| workSheetNo | number |
선택 | 읽어들일 엑셀 파일의 워크시트 순번을 설정합니다. 설정하지 않으면 첫번째 워크시트를 읽습니다. |
| reqHeader | object |
선택 | 서버 전송 헤더에 사용자가 지정한 헤더 정보를 설정합니다. |
| useXhr | boolean |
선택 | xhr 통신을 이용해 엑셀 파일을 로드합니다.0(false):xhr 통신 사용 안함 (default)1(true):xhr 통신 사용 |
none
//FP로 최종 데이터를 받을 서블릿(혹은 jsp) 경로를 지정해야 함
var param = {
startRow:5,
workSheetName:"sheet4",
extendParam:"year=2019&deptNo=0041&FP=./save/empExcelData.do"
};
sheet.directLoadExcel(param);
//directLoadExcel 자바 서버모듈 예시
List<Map<String, Object>> data = (List<Map<String, Object>>)request.getAttribute("SHEETDATA");
Map<String, Object> header = (Map<String, Object>)data.get(0);
for (String key : header.keySet()) {
System.out.print(key + "|");
}
System.out.println();
for (Map<String, Object> row : li) {
for (String key : row.keySet()) {
System.out.print(row.get(key) + "|");
}
System.out.println();
}
//directLoadExcel 닷넷 서버모듈 예시
List<Object> data = (List<Object>)this.Context.Items["sheetData"];
Dictionary<String, String> header = (Dictionary<String, String>)data[0];
foreach (String key in header.Keys) {
System.Diagnotics.Debug.Write(key + "|");
}
System.Diagnotics.Debug.WriteLine();
foreach (Dictionary<String, String> row in data) {
foreach (String key in row.Keys) {
System.Diagnotics.Debug.Write(row[key] + "|");
}
System.Diagnotics.Debug.WriteLine();
}
| product | version | desc |
|---|---|---|
| excel | 0.0.0 | 기능 추가 |
| excel | 0.0.8 | reqHeader 기능 추가 |