# setFilterModel

검증된 통합 필터 모델을 적용합니다. null은 모든 필터 계열을 지우며 유효하지 않은 모델은 보고서를 확인해야 합니다.

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

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

## 무엇을 하는 API인가요

검증된 통합 필터 모델을 적용합니다. null은 모든 필터 계열을 지우며 유효하지 않은 모델은 보고서를 확인해야 합니다.

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

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

```typescript
setFilterModel(model: SyGridFilterSlice | null): Promise<FilterSliceApplyResult['report']>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| model | 필수 | SyGridFilterSlice \| null |

반환 타입은 `Promise<FilterSliceApplyResult['report']>`입니다.

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

## 사용 흐름

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

<a id="types"></a>

## 관련 타입 읽기

- [SyGridFilterSlice](https://grid.syidax.com/ko/docs/types/SyGridFilterSlice.md)
- [FilterSliceApplyResult](https://grid.syidax.com/ko/docs/types/FilterSliceApplyResult.md)

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

## 기능별 설명과 예제

- [열마다 다른 조건](https://grid.syidax.com/ko/docs/features/column-filters.md) — 열 필터는 특정 열에 조건을 적용합니다. 텍스트·숫자·날짜별로 입력과 비교 방식이 다르며 여러 열의 조건은 함께 결과를 좁힙니다.