# Excel 내보내기

Excel 내보내기는 XLSX 바이트를 생성하거나 파일로 내려받습니다. CSV보다 시트 이름과 워크북 형식이 필요한 교환 작업에 적합하며 Pro 기능입니다.

Canonical: https://grid.syidax.com/ko/docs/features/excel-export/

<a id="understand"></a>

## 동작 원리와 선택 기준

exportDataAsExcel은 다운로드하고 getDataAsExcel은 Uint8Array를 반환합니다. 앱의 업로드·첨부 과정에 연결할 때는 바이트를 사용하고 텍스트로 해석하지 않습니다.

이 기능을 제품에서 사용하려면 Pro 패키지와 유효한 라이선스가 필요합니다. 설정 이름이 같더라도 Community에서 Pro 기능이 활성화되는 것은 아닙니다.

코드의 grid는 설치와 연결 장에서 준비한 Grid 요소입니다. 예제마다 필요한 데이터·설정을 확인하고, 코드에서 소개하는 앱 함수와 서버 주소는 프로젝트에 맞게 구현하세요.

- [설치와 연결 · 공통 예제 데이터](https://grid.syidax.com/ko/docs/guides/getting-started.md)

<a id="example-1"></a>

## 예제 1. 주문 파일 다운로드

파일명과 시트명을 사용자가 이해할 수 있게 지정합니다.

```javascript
await grid.exportDataAsExcel({ fileName: 'orders.xlsx', sheetName: '주문' });
```

결과 확인: XLSX 파일의 주문 시트에서 결과를 확인합니다.

<a id="example-2"></a>

## 예제 2. 선택한 주문만 전달

먼저 행을 선택한 뒤 범위를 제한합니다.

```javascript
await grid.exportDataAsExcel({ onlySelected: true, columnKeys: ['product', 'quantity'] });
```

결과 확인: 선택 행의 지정 열만 출력합니다. 선택이 없는 경우의 결과도 앱의 안내 문구와 함께 확인하세요.

<a id="example-3"></a>

## 예제 3. 파일 바이트 사용

첨부파일 미리보기나 앱 업로드 단계에 연결할 수 있습니다.

```javascript
const bytes = await grid.getDataAsExcel({ sheetName: 'Orders' });
const blob = new Blob([bytes], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' });
console.log(blob.size);
```

결과 확인: 다운로드하지 않고 파일 객체를 만들 수 있습니다. 실제 외부 업로드는 앱에서 구현합니다.

<a id="pitfalls"></a>

## 조합할 때와 문제를 해결할 때

Grid의 임의 HTML 렌더러나 앱 버튼을 Excel 셀 모양으로 재현한다고 기대하지 마세요. 교환할 데이터와 서식 범위를 확인합니다.

서버 전체 데이터 출력과 현재 Grid의 출력은 범위가 다릅니다. 대용량 보고서는 서버에서 생성하는 방식을 검토합니다.

<a id="related-api"></a>

## 이 기능에 사용하는 API

- [getDataAsExcel](https://grid.syidax.com/ko/docs/methods/getDataAsExcel.md) — XLSX 파일 내용을 Uint8Array 바이트로 생성합니다. 앱의 첨부·업로드 등에 사용할 수 있습니다.
- [exportDataAsExcel](https://grid.syidax.com/ko/docs/methods/exportDataAsExcel.md) — 지정한 시트명·열·선택 조건으로 XLSX 파일을 내려받습니다.

<a id="next"></a>

## 함께 읽기

- [행·열·ID의 관계](https://grid.syidax.com/ko/docs/guides/concepts.md)
- [결과와 이벤트 연결](https://grid.syidax.com/ko/docs/guides/data-event-access.md)
- [Features에서 살펴보기](https://grid.syidax.com/grid/excel-export) — 직접 체험 가능한 범위는 해당 가이드에 안내되어 있습니다.