# 필터 설정 도구

필터 설정 도구를 사용하면 필터를 손쉽게 추가, 수정 및 삭제할 수 있습니다. 필터 값에는 부모 또는 조회 필드를 바인딩할 수 있어 동적인 조건 설정도 가능합니다. 보다 복잡한 조건이 필요한 경우, 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>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.smallbuilder.com/ko/smallbuilder-line-items/builder/filter-expression-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.