# setValueColumns

검증된 변경 경로로 피벗 값 축을 교체하고 성공 여부를 반환합니다.

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

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

## 무엇을 하는 API인가요

검증된 변경 경로로 피벗 값 축을 교체하고 성공 여부를 반환합니다.

Pro 기능 관련 API: Pivot

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

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

```typescript
setValueColumns(columns: string[]): Promise<boolean>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| columns | 필수 | string[] |

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

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

## 사용 흐름

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

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

## 기능별 설명과 예제

- [피벗 분석](https://grid.syidax.com/ko/docs/features/pivot.md) — 피벗은 원본 주문을 행 축·열 축·값 축으로 나누어 교차 집계표를 만듭니다. 지역별 주문 행을 접는 그룹과 달리, 고유한 상태 값 등이 새로운 결과 열로 생깁니다.