down2Text (method)

시트의 내용을 txt파일이나 csv파일로 내보내기 합니다.

해당함수는 시트의 내용을 Down2Text.jsp 파일로 전달하고, 이 파일에서 실제 txt파일(혹은 csv)을 생성하여 클라이언트 측으로 전송하게 됩니다.

따라서 해당 함수를 사용하시려면 자바 서버모듈의 경우 Down2Text.jsp와 더불어 ibsheet8-1.0.x.jar 파일과 apache POI 라이브러리가 필요로 하고, 닷넷 서버모듈의 경우 Down2Text.aspx와 더불어 IBSheet8-4.0.dll 파일과 Syncfusion 라이브러리 dll가 필요합니다. 이 기능을 사용하시려면, 배포시 같이 보내드리는 /plugins/ibsheet-excel.js 파일을 include 하셔야 합니다.

Down2Text.jsp 파일에 대한 경로는 Cfg에 Export 속성을 통해 설정해야 합니다.

매 시트 생성시 마다 Export속성을 설정하기 번거로운 경우에는 IBSheet.CommonOptions 속성을 통해 모든 시트에 공통으로 설정할 수도 있습니다.

다시 정리해 보자면 다음과 같은 작업이 필요 합니다.

자바 서버모듈

1. ibsheet8-1.0.x.jar 파일과 공통 라이브러리(POI jar)를 WEB-INF/lib에 추가.
2. /plugins/ibsheet-excel.js 파일을 해당 페이지에 include.
3. 시트 생성시 Cfg 에 Export을 통해 Down2Text.jsp 파일에 대한 경로 설정

닷넷 서버모듈

1. IBSheet8-4.0.dll 파일과 공통 라이브러리(Syncfusion dll)을 bin 또는 참조에 추가.
2. /plugins/ibsheet-excel.js 파일을 해당 페이지에 include.
3. 시트 생성시 Cfg에 Export 속성을 통해 Down2Text.aspx 파일에 대한 경로 설정

Syntax

void down2Text( param );

Parameters

Return Value

none

Example

//1. text 확장자로 다운로드
sheet.down2Text({fileName:"yearsProfit.txt"});


//2. csv 확장자로 다운로드
sheet.down2Text({fileName:"yearsProfit.csv", colDelim:","});

downloadEncoding 설정시 유의사항

downloadEncoding을 UTF-8로 설정해 csv 파일을 다운로드하시면 엑셀로 열였을 때 한글이 깨지는 현상이 발생합니다.
엑셀로 열었을 때 한글이 깨지는 현상을 예방하면서 UTF-8 인코딩을 적용하기 위해서는 downloadEncoding을 UTF-8(BOM)으로 설정해주세요 (서버모듈 1.1.18 버전 이후 설정 가능).

csv 다운로드시 기본 인코딩에 관해

엑셀 플러그인 1.0.21 버전 이후로 csv 다운로드시 기본 인코딩 형식이 EUC-KR에서 UTF-8(BOM)으로 변경되었습니다.
그런데 해당 인코딩 형식은 서버모듈 1.1.18 버전 이후로 지원되는 형식이기에, 엑셀 플러그인 1.0.21 버전을 사용하시며 down2Text 기능을 사용하시려면 반드시 서버모듈 버전을 1.1.18 버전 이후의 버전으로 업그레이드하시거나 downloadEncoding 옵션을 UTF-8(BOM) 이외의 값으로 별도 설정해주셔야 됩니다.

Read More

• AutoExcelMode cfg
• down2Excel method
• exportData method
• loadText method
• onBeforeExport event
• onExportFinish event

Since