# 쿼리 마법사(Query Wizard)를 사용하여 필터 삽입하기

빌더에서 필터 설정은 보통 SOQL의 WHERE 절에 해당하는 구문을 입력합니다. 그러나 SOQL을 잘 모르는 관리자라면 이 과정을 어렵게 느낄 수 있습니다.

이를 해결하기 위해 **쿼리 마법사**를 제공하여 관리자가 SOQL 문법에 대한 깊은 지식 없이도 **간단하게 필터 조건을 설정**할 수 있도록 지원합니다. 쿼리 마법사를 사용하면 조건을 선택하고 값을 입력하는 방식으로 필터를 설정할 수 있어 필터 작성이 훨씬 쉬워집니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FIpNVoHkSPiJBeUbDKYSk%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A12.png?alt=media&#x26;token=8775d8d4-8253-45a5-b1f5-d2294523398f" alt=""><figcaption></figcaption></figure>

### 로직 설정하기

쿼리 마법사에서 여러 필터를 설정하면 기본적으로 조건이 ‘**AND**’로 묶여 생성됩니다.

예를 들어 쿼리 마법사에서 3개의 필터를 추가하였을 때:

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FNImlehHJnTIK28BdW5Cn%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%85%E1%85%A9%E1%84%8C%E1%85%B5%E1%86%A8_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B51.png?alt=media&#x26;token=bd4dbde1-bb1c-460d-842e-05373d7fdeac" alt=""><figcaption><p>쿼리 마법사에서 3개의 필터를 추가 </p></figcaption></figure>

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

```sql
1 AND 2 AND 3
```

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F6dMp4hhIgMfz8bJVB4sp%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%85%E1%85%A9%E1%84%8C%E1%85%B5%E1%86%A8_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B52.png?alt=media&#x26;token=a4abdb9b-7200-48ca-b495-a48f199d9549" alt=""><figcaption></figcaption></figure>

#### **로직 변경하기**

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

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FSCBfEMPT9ddydVwVl6B8%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%85%E1%85%A9%E1%84%8C%E1%85%B5%E1%86%A8_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B53.png?alt=media&#x26;token=d679ac3d-b7fc-4182-b86c-4b8ddb3225ae" alt=""><figcaption></figcaption></figure>

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

```sql
1 OR 2 OR 3
```

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fawwn6tOqjHpCszWqcDQx%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%85%E1%85%A9%E1%84%8C%E1%85%B5%E1%86%A8_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B54.png?alt=media&#x26;token=3891c635-b974-4a60-8665-cda05d07fe37" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FhwnTDtBPRBhrms6rL647%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%85%E1%85%A9%E1%84%8C%E1%85%B5%E1%86%A8_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B55.png?alt=media&#x26;token=6b5c7c5b-52a5-4a29-befb-372046af1907" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

1. 개체 연결 단계에서 조회 개체의 **필터 설정(Filter by Query)**&#xC5D0;서 **쿼리 마법사** 버튼을 클릭합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FA7DscTtutLAKHkT0H68e%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%87%E1%85%AE%E1%84%86%E1%85%A9_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B50.png?alt=media&#x26;token=be000b19-0ec2-48f0-b6a0-32acc3fa1275" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FDBmrrpB142IHY4YxJ6VC%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%87%E1%85%AE%E1%84%86%E1%85%A9_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B5.png?alt=media&#x26;token=b2b31ab1-f362-4b57-8671-396a5e4dd12b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F47AHTfQ7w2RkQdlUiSe4%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%87%E1%85%AE%E1%84%86%E1%85%A9_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B52.png?alt=media&#x26;token=fc08b8bf-d024-48d3-9515-5be75e84783a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FHFhP32EkU65Po3LtE59K%2F%E1%84%8F%E1%85%AF%E1%84%85%E1%85%B5%E1%84%86%E1%85%A1%E1%84%87%E1%85%A5%E1%86%B8%E1%84%89%E1%85%A1_%E1%84%87%E1%85%AE%E1%84%86%E1%85%A9_%E1%84%8B%E1%85%A8%E1%84%89%E1%85%B53.png?alt=media&#x26;token=8b2e0243-a140-469e-8ec0-d8352e02c633" alt=""><figcaption></figcaption></figure>

이 설정을 통해 부모 개체의 가격 목록과 일치하는 가격 목록 항목 데이터를 필터링할 수 있습니다. 쿼리 마법사를 사용하면 필터 구문이 자동으로 생성되어, 조건을 쉽고 편리하게 추가할 수 있습니다.