# 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

Name | Type | Required | Description
--- | --- | --- | ---
fileName | `string` | 선택 | 다운로드 받을 파일명입니다. 확장자를 설정하지 않으면 `txt` 파일로 다운로드 됩니다.
rowDelim | `string` | 선택 | text파일을 만들때 행 구분자(기본은 줄넘김 문자: `"\r\n"`)
colDelim | `string` | 선택 | txt 다운로드 일 경우(`default: \t(탭문자)`, csv 다운로드 일 경우(`default: ,(콤마)` 업로드되는 파일에 따라 기본 구분자가 변경됩니다.
downRows | `string` | 선택 | 다운로드 받을 행 인덱스(구분자 "|"로 연결 ex: "1|3|4|5|7")
downCols | `string` | 선택 | 다운로드 받을 열 Name(구분자 "|"로 연결 ex: "amt|qty1|qty2|qty3|years")
downHeader | `boolean` | 선택 | 헤더행을 다운로드 받을지 여부(default:`1(true)`)
downSum | `boolean` | 선택 | 합계행도 다운로드 받을지 여부(default:`1(true)`)
downTreeHide | `boolean` | 선택 | tree를 사용하는 경우, 접혀진 행도 엑셀에 다운로드 할지 여부를 설정합니다. `1(true)`로 설정시 접혀있는 자식노드도 모두 다운로드 됩니다.(`defalut: 0(false)`)
reqHeader | `object` | 선택 | 서버 전송 헤더에 사용자가 지정한 헤더 정보를 설정합니다.

### Return Value

none

### Example

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

### Read More

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

### Since

product | version | desc
--- | --- | ---
excel | 0.0.0 | 기능 추가
excel | 0.0.8 | `reqHeader` 기능 추가