> 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/datasource/object.md).

# 관련 개체 데이터 가져오기

{% hint style="warning" %}
버전 1.37부터 ‘**데이터소스(Data Source)**’가 ‘**비즈니스 규칙(Business Rule)**’으로 명칭이 변경되었습니다.
{% endhint %}

**단순히 관련된 개체를 조회**하려는 경우, 해당 비즈니스 규칙을 사용해보세요. 조회 또는 라인 아이템과 관련된 개체를 선택하고, 비즈니스 규칙을 통해 가져온 개체의 필드 값을 조회 또는 라인 아이템 필드에 매핑할 수 있습니다.

<figure><img src="/files/qCx9QgilQPjezvO8YHsb" alt="" width="375"><figcaption></figcaption></figure>

***

### 관련 개체를 이용한 비즈니스 규칙 설정

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

<table><thead><tr><th width="87">번호</th><th width="117">항목</th><th width="446.33333333333326">설명</th><th>필수</th></tr></thead><tbody><tr><td><strong>1</strong></td><td>소스 개체</td><td>데이터를 가져올 개체를 선택합니다.</td><td><mark style="color:red;">✔</mark></td></tr><tr><td><strong>2</strong></td><td>설명</td><td>비즈니스 규칙에 대한 설명을 기재합니다.</td><td></td></tr><tr><td><strong>3</strong></td><td>필터 조건</td><td>필터 설정 방법</td><td></td></tr><tr><td><strong>4</strong></td><td>평가 이벤트</td><td><p>비즈니스 규칙의 <strong>실행 시점</strong>을 설정합니다.</p><ul><li><strong>초기화 시(On Initialization):</strong> 라인 아이템 레코드가 새로 추가될 때 실행됩니다.</li><li><strong>로딩 시(On Loading):</strong> 라인 아이템 화면이 로드될 때마다 실행됩니다.</li><li><strong>변경 시(On Change):</strong> 라인 아이템의 특정 필드가 변경될 때마다 실행됩니다.</li><li><strong>저장 전(Before Save):</strong> 라인 아이템 레코드가 저장되기 전에 실행됩니다.</li></ul><p><span data-gb-custom-inline data-tag="emoji" data-code="2757">❗</span> <em><mark style="color:red;">라인 아이템에서만 제공되는 설정입니다.</mark></em></p></td><td><mark style="color:red;">✔</mark></td></tr><tr><td><strong>5</strong></td><td><a href="#undefined-1">작업</a></td><td>비즈니스 규칙으로 가져온 데이터를 조회 또는 라인 아이템 필드와 매핑합니다.</td><td><mark style="color:red;">✔</mark></td></tr></tbody></table>

### 작업

비즈니스 규칙을 통해 가져온 데이터를 조회 또는 라인 아이템 필드와 매핑하는 작업입니다. 이 작업을 통해 비즈니스 규칙 값이 지정된 필드에 반영됩니다.

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

<table><thead><tr><th width="63.70703125">번호</th><th width="157.58984375">항목</th><th width="466.33333333333326">설명</th><th>필수</th></tr></thead><tbody><tr><td><strong>1</strong></td><td>Key</td><td>비즈니스 규칙과 조회 또는 라인 아이템 간 데이터 매핑 시 사용할 고유 식별 값입니다. Key를 기준으로 비즈니스 규칙 값이 매핑될 대상을 결정합니다.</td><td></td></tr><tr><td><strong>2</strong></td><td>규칙 필드</td><td>비즈니스 규칙의 소스 개체에서 가져올 필드를 선택합니다.</td><td><mark style="color:red;">✔</mark></td></tr><tr><td><strong>3</strong></td><td>조회/라인 아이템 필드</td><td>데이터를 매핑할 조회 또는 라인 아이템의 필드를 선택합니다.</td><td><mark style="color:red;">✔</mark></td></tr></tbody></table>

### 예시: 제품의 단가 표시

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

* **부모:** 기회(`Opportunity`)
* **라인 아이템:** 기회 제품(`OpportunityLineItem`)
* **조회:** 제품(`Product2`)
  {% endhint %}

조회 개체를 제품(`Product2`)으로 설정한 경우, 사용자들은 일반적으로 단가(`UnitPrice`) 정보를 함께 표시하고 싶어합니다. 하지만 세일즈포스에서는 단가 정보가 가격 목록 항목(`PricebookEntry`) 개체에 저장되어 있습니다. 그러나 가격 목록 항목은 제품의 하위 개체로, 단가 정보를 수식 필드로 가져올 수 없습니다. 따라서 제품과 연결된 가격 목록 항목 데이터를 비즈니스 규칙을 이용해 조회하려고 합니다.

<figure><img src="/files/8iADoFX7uvPdc5wx6jX7" alt=""><figcaption></figcaption></figure>

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

#### 설정

1. 조회 선택기 설정 단계에서 조회 필드에 **통화 유형의 가상 열을 추가**합니다.
2. 바로 하단에 비즈니스 규칙의 ‘**관련 객체에서 데이터 가져오기**’ 레이아웃에서 **비즈니스 규칙 추가**를 클릭합니다.
3. 비즈니스 규칙에서 **소스 개체(Source Object)**&#xB97C; 가격 목록 항목(`PricebookEntry`)로 지정합니다.
4. 필터 설정에서 개체 조회 조건을 설정합니다.
   * **활성화**
     1. **필드:** 활성(IsActive)
     2. **연산자:** 같음(equals)
     3. **값:** 참(true)
   * **기회와 동일한 가격 목록**
     1. **필드:** 가격 목록(Pricebook2Id)
     2. **연산자:** 같음(equals)
     3. **값:** 부모/가격 목록(Pricebook2Id)
5. **작업(Action) 설정**에서 각 제품에 해당되는 가격 목록 항목 데이터를 결합하기 위해 다음과 같이 설정합니다:
   * **규칙:** `Product2Id`
   * **조회:** `Id`
6. 단가를 제품 데이터와 같이 표시하기 위해 **작업(Action)**&#xC744; 추가하여 조회 필드([가상 열](https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/datasource/broken-reference/README.md))을 지정합니다.
   * **규칙:** `UnitPrice`
   * **조회:** `SBLI_Virtual1`

<figure><img src="/files/vFFXSuGN5c2RjSmVAwzS" alt=""><figcaption><p>조회 필드에서 단가 정보를 표시할 가상 열을 추가합니다.</p></figcaption></figure>

<figure><img src="/files/276l0DCEifwTMKwIxmfu" alt=""><figcaption><p>비즈니스 규칙 설정 화면입니다.</p></figcaption></figure>

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

#### 결과

조회 선택기에서 제품에 대한 **데이터소스를 통해 가져온 단가 정보**가 함께 표시되는 것을 확인할 수 있습니다.

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