> For the complete documentation index, see [llms.txt](https://help.smallbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smallbuilder.com/ko/smallbuilder-line-items/builder/filter-expression-tool.md).

# 필터 설정 도구

필터 설정 도구를 사용하면 필터를 손쉽게 추가, 수정 및 삭제할 수 있습니다. 필터 값에는 부모 또는 조회 필드를 바인딩할 수 있어 동적인 조건 설정도 가능합니다. 보다 복잡한 조건이 필요한 경우, SOQL 문을 직접 입력하여 필터를 구성할 수도 있습니다.

<figure><img src="/files/uRBFxvcsTNbTP89811MO" alt=""><figcaption></figcaption></figure>

### SOQL 작성

복잡한 조건(예: 서브쿼리)이나 필터 도구에서 제공하지 않는 필드, 연산자, 값을 사용해야 하는 경우, 직접 SOQL 조건절을 입력할 수 있습니다.

<figure><img src="/files/fqT9jasibIQJ94CzOgAI" alt=""><figcaption></figcaption></figure>

**필터 도구로 조건을 설정한 경우, 해당 조건이 SOQL 입력란에 자동으로 표시**됩니다.

<figure><img src="/files/wH11lGqFkR5p5OBoc2PD" alt=""><figcaption></figcaption></figure>

직접 작성한 SOQL이 있는 경우, 필터 도구에서 설정한 조건과 `AND` 조건으로 자동 연결됩니다.

<figure><img src="/files/HXY1cdfLJ0KEKENNZYtG" alt=""><figcaption></figcaption></figure>

만약 필드나 바인딩할 부모 및 조회 필드를 삽입해야 하는데 필드 API명을 잘 모르는 경우 우측 상단에 ‘**표현식 삽입**’ 버튼을 클릭하여 도움을 받을 수 있습니다.

<figure><img src="/files/3YWkXmxo3TMGMmfZRRKa" alt=""><figcaption></figcaption></figure>

### 필터 설정 시 부모 개체 필드와 바인딩하기

필터를 설정할 때, 조건값을 부모 개체의 필드 값과 바인딩할 수 있습니다. 값 입력란 앞에 있는 옵션에서 부모를 선택하면, 해당 부모 개체의 필드를 선택하여 필터 조건으로 사용할 수 있습니다.

이 기능을 통해 부모 개체의 동적인 필드 값을 기준으로 필터를 설정할 수 있어 더욱 유연한 데이터 조회가 가능합니다.

#### 예시: 기회의 가격 목록에 해당하는 가격 목록 항목 조회하기

{% hint style="info" %}
이 예시에서는 기회 제품에 대한 라인 아이템 편집기를 설정하였습니다.

* **부모:** 기회(`Opportunity`)
* **라인 아이템:** 기회 제품(`OpportunityLineItem`)
* **조회:** 가격 목록 항목(`PricebookEntry`)
  {% endhint %}

가격 목록 항목의 가격 목록(`Pricebook2Id`)이 부모 개체인 기회의 가격 목록(`Pricebook2Id`)과 일치하는 데이터를 조회하도록 필터를 설정하려고 합니다.

1. 개체 연결 단계에서 조회 개체의 필터 설정(Filter by Query) 항목으로 이동한 후, 필드에 가격 목록(`Pricebook2Id`)을 검색하여 선택합니다.

<figure><img src="/files/6GrZJBk3gYJhnPwju8i9" alt=""><figcaption></figcaption></figure>

2. 값 입력란 옆의 옵션에서 **부모**(Parent)를 선택합니다.

<figure><img src="/files/QMrdsYq3knDiMmiLOhDs" alt=""><figcaption></figcaption></figure>

3. 값 입력란에 다시 가격 목록(`Pricebook2Id`)을 검색하여, 부모 개체의 가격 목록 ID를 선택합니다.

<figure><img src="/files/ckn1ilsrILkPaUWchthK" alt=""><figcaption></figcaption></figure>

4. SOQL 편집기를 열어보면, 가격 목록 조건이 부모의 가격 목록 필드와 바인딩된 것을 확인할 수 있습니다.

<figure><img src="/files/xmm1ptZ9igUfalfpbACj" alt=""><figcaption></figcaption></figure>

이 설정을 통해 부모 개체의 가격 목록과 일치하는 가격 목록 항목 데이터를 필터링할 수 있습니다. 필터 도구를 사용하면 조건을 쉽고 편리하게 추가할 수 있습니다.