# getDataAsExcel

XLSX 파일 내용을 Uint8Array 바이트로 생성합니다. 앱의 첨부·업로드 등에 사용할 수 있습니다.

Canonical: https://grid.syidax.com/ko/docs/methods/getDataAsExcel/

<a id="meaning"></a>

## 무엇을 하는 API인가요

XLSX 파일 내용을 Uint8Array 바이트로 생성합니다. 앱의 첨부·업로드 등에 사용할 수 있습니다.

Pro 기능 관련 API: Built-in Excel export

<a id="contract"></a>

## 입력과 결과의 정확한 타입

```typescript
getDataAsExcel(options?: {
      sheetName?: string;
      onlySelected?: boolean;
      columnKeys?: readonly string[];
      skipHeaders?: boolean;
    }): Promise<Uint8Array>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| options | 선택 | {<br>      sheetName?: string;<br>      onlySelected?: boolean;<br>      columnKeys?: readonly string[];<br>      skipHeaders?: boolean;<br>    } |

반환 타입은 `Promise<Uint8Array>`입니다.

<a id="usage"></a>

## 사용 흐름

등록과 초기화를 마친 Grid 요소에서 grid.getDataAsExcel(…)를 호출합니다. 반환값은 await로 읽으세요. boolean이나 보고서를 반환하는 메서드는 결과를 확인한 뒤 다음 작업을 진행합니다.

<a id="recipes"></a>

## 기능별 설명과 예제

- [Excel 내보내기](https://grid.syidax.com/ko/docs/features/excel-export.md) — Excel 내보내기는 XLSX 바이트를 생성하거나 파일로 내려받습니다. CSV보다 시트 이름과 워크북 형식이 필요한 교환 작업에 적합하며 Pro 기능입니다.