# 쿼리 마법사(Query Wizard)를 사용하여 필터 삽입하기 빌더에서 필터 설정은 보통 SOQL의 WHERE 절에 해당하는 구문을 입력합니다. 그러나 SOQL을 잘 모르는 관리자라면 이 과정을 어렵게 느낄 수 있습니다. 이를 해결하기 위해 **쿼리 마법사**를 제공하여 관리자가 SOQL 문법에 대한 깊은 지식 없이도 **간단하게 필터 조건을 설정**할 수 있도록 지원합니다. 쿼리 마법사를 사용하면 조건을 선택하고 값을 입력하는 방식으로 필터를 설정할 수 있어 필터 작성이 훨씬 쉬워집니다.

### 로직 설정하기 쿼리 마법사에서 여러 필터를 설정하면 기본적으로 조건이 ‘**AND**’로 묶여 생성됩니다. 예를 들어 쿼리 마법사에서 3개의 필터를 추가하였을 때:

쿼리 마법사에서 설정한 1\~3번 필터는 다음과 같이 모두 ‘**AND**’로 묶여 생성됩니다. ```sql 1 AND 2 AND 3 ```

#### **로직 변경하기** 로직을 변경하려면 **로직 편집**을 눌러 필터 번호를 기반으로 로직을 수정하세요.

예를 들어, 모든 조건을 **OR**로 변경하고 싶은 경우 아래와 같이 입력합니다: ```sql 1 OR 2 OR 3 ```

수정한 로직대로 필터가 생성된 것을 확인할 수 있습니다.

### 필터 설정 시 부모 개체 필드와 바인딩하기 필터를 설정할 때, 조건값을 부모 개체의 필드 값과 바인딩할 수 있습니다. 값 입력란 앞에 있는 옵션에서 부모를 선택하면, 해당 부모 개체의 필드를 선택하여 필터 조건으로 사용할 수 있습니다. 이 기능을 통해 부모 개체의 동적인 필드 값을 기준으로 필터를 설정할 수 있어 더욱 유연한 데이터 조회가 가능합니다. #### 예시: 기회의 가격 목록에 해당하는 가격 목록 항목 조회하기 {% hint style="info" %} 이 예시에서는 기회 제품에 대한 라인 아이템 편집기를 설정하였습니다. * **부모:** 기회(`Opportunity`) * **라인 아이템:** 기회 제품(`OpportunityLineItem`) * **조회:** 가격 목록 항목(`PricebookEntry`) {% endhint %} 가격 목록 항목의 가격 목록(`Pricebook2Id`)이 부모 개체인 기회의 가격 목록(`Pricebook2Id`)과 일치하는 데이터를 조회하도록 필터를 설정하려고 합니다. 1. 개체 연결 단계에서 조회 개체의 **필터 설정(Filter by Query)**에서 **쿼리 마법사** 버튼을 클릭합니다.

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

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

4. 필터 조건이 `{$Parent.Pricebook2Id}`로 자동 바인딩되어 추가된 것을 확인합니다.

이 설정을 통해 부모 개체의 가격 목록과 일치하는 가격 목록 항목 데이터를 필터링할 수 있습니다. 쿼리 마법사를 사용하면 필터 구문이 자동으로 생성되어, 조건을 쉽고 편리하게 추가할 수 있습니다. --- # 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/query-wizard.md?ask= ``` 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.