directLoadExcel (method)

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

업로드 실패 시 결과 코드와 메시지는 onImportFinish의 result(음수 코드)와 message로 받습니다. 중계 페이지에서 조건에 따라 오류 메시지를 내보내는 방법은 엑셀 서버 모듈 트러블슈팅을 참고하세요.

Syntax

void directLoadExcel( param );

Parameters

Return Value

none

Example

//FP로 최종 데이터를 받을 서블릿(혹은 jsp) 경로를 지정해야 함
var param = {
        startRow:5,
        workSheetName:"sheet4",
        extendParam:"year=2019&deptNo=0041&FP=./save/empExcelData.do"
        };
sheet.directLoadExcel(param);

DirectLoadExcel.jsp(서버모듈)에서 directLoadExcel()로 파싱한 뒤 sendDirectToFP()를 호출하면, FP로 지정한 페이지로 파싱 데이터가 SHEETDATA 속성에 담겨 forward됩니다.

// DirectLoadExcel.jsp (서버모듈): 엑셀 파싱 후 FP 페이지로 forward
IBSheetLoad load = new IBSheetLoad();
load.setEncoding("UTF-8");
load.setService(request, response);
load.directLoadExcel();   // 엑셀 파싱
load.sendDirectToFP();    // FP 로 지정한 페이지로 파싱 데이터(SHEETDATA) forward

forward된 FP 페이지에서는 아래처럼 SHEETDATA를 받아 처리합니다.

// FP 페이지(예: empExcelData.do): forward된 데이터를 SHEETDATA 로 받아 처리
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 : data) {
  for (String key : row.keySet()) {
    System.out.print(row.get(key) + "|");
  }
  System.out.println();
}

forward 대신, sendDirectToFP()를 호출하지 않고 directLoadExcel()의 반환값(List)을 서버모듈에서 바로 처리할 수도 있습니다(아래). 이 방식은 FP를 사용하지 않으므로, 클라이언트도 FP 없이 sheet.directLoadExcel();로 호출하면 됩니다.

// directLoadExcel() 반환값(List)을 중계 페이지에서 바로 받아 처리 + 오류 처리
IBSheetLoad load = new IBSheetLoad();
load.setEncoding("UTF-8");
load.setService(request, response);   // getLoadError/getLoadFinish가 response를 사용 → 필수

OutputStream out = response.getOutputStream();
try {
    List<Map<String, String>> rows = load.directLoadExcel();   // 파일 전체를 한 번에 List로 반환

    for (Map<String, String> row : rows) {
        // 검증/저장 (개발자 로직) — 실패 시 아래 catch로
        // myDao.insert(row);
    }

    // 성공: 완료 신호 (result 0 이상 = 정상)
    out.write(load.getLoadFinish("EXCEL", 1, rows.size() + "건 완료"));
    out.flush();
} catch (Exception e) {
    // 실패: 음수 코드 + 메시지 (메시지의 따옴표 등은 제거 후 전달)
    String msg = ("업로드 실패: " + e.getMessage()).replace("\"", "").replace("'", "");
    out.write(load.getLoadError(-500, msg));
    out.flush();
}

이 방식은 파일 전체를 메모리에 올리므로 일반 건수에 적합합니다.
행 수가 매우 많으면 서버 메모리 부족(OutOfMemoryError)이 발생할 수 있어 초대용량 처리에는 권장하지 않습니다.
오류 처리 상세(메시지 정제, 전체 롤백, 예약 오류 코드)는 엑셀 서버 모듈 트러블슈팅을 참고하세요.

//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();
}

Read More

• loadExcel method
• directDown2Excel method
• importData method
• onSelectFile event
• onImportFinish event
• 대용량 엑셀 파일 처리 appendix
• 엑셀 업로드/다운로드 설정 appendix
• 엑셀 서버 모듈 트러블슈팅 appendix
• 엑셀 DRM 처리 appendix
• 엑셀 비밀번호 설정 appendix

Since