down2Text (method)

시트의 내용을 txt 또는 csv 파일로 다운로드합니다.
사용 전 서버모듈 설치와 /plugins/ibsheet-excel.js 스크립트 로드가 필요합니다.
이 함수를 호출하면 Cfg.Export 속성에 지정한 Down2Text.jsp(또는 Down2Text.aspx)가 호출되며, 이 jsp 파일이 시트 정보(컬럼 정의 등)와 데이터를 받아 텍스트 파일을 생성해 클라이언트로 전송합니다.
시트마다 반복 설정이 번거로우면 IBSheet.CommonOptions로 공통 적용할 수 있습니다.

Syntax

void down2Text( param );

Parameters

Return Value

none

Example

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


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

//3. csv 다운로드 + CSV 인젝션 방어
//   셀 값이 `=1+1`, `+82-10-...`, `@SUM(...)`처럼 위험 선두 문자로 시작하면
//   파일에 `'`가 prefix되어 저장되고, 엑셀에서 텍스트로 표시됩니다.
sheet.down2Text({fileName:"safe.csv", escapeCsvInjection: 1});

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
• down2Pdf method
• exportData method
• loadText method
• onBeforeExport event
• onExportFinish event

Since