# SmallBuilder 헬프

본 문서는 세일즈포스 관리자가 더 쉽게 **SmallBuilder**에 익숙해질 수 있도록 다양한 정보를 담고있습니다.

{% hint style="info" %}
SmallBuilder는 윈드밀소프트가 제공하는 세일즈포스 애드온 패키지로 세일즈포스 구현 과정에서 자주 접하는 커스텀 기능을 코딩없이 구현할 수 있도록 지원하는 도구들로 구성되어 있습니다.
{% endhint %}

<table data-card-size="large" data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>SmallBuilder Line Items</strong></td><td>기회, 견적, 주문에 대한 표준 라인 아이템을 커스터마이징하고, Low/No-Code 방식으로 사용자 정의 개체에도 라인 아이템을 손쉽게 구현합니다.</td><td></td><td><a href="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FXlkGdqI8TGnoWAp5iF7f%2FScreenshot%202024-11-18%20at%202.38.23%E2%80%AFPM.png?alt=media&amp;token=30954abd-7627-4cf8-9f3f-1f6673959c9e">Screenshot 2024-11-18 at 2.38.23 PM.png</a></td><td><a href="/ko/smallbuilder-line-items/introduction">제품 소개</a></td></tr><tr><td><strong>SmallBuilder Documents</strong></td><td>쉽게 재사용 가능한 문서 템플릿을 생성하고, 사용자 정의 개체를 지원하며, Low/No-Code 방식으로 구현할 수 있습니다.</td><td></td><td><a href="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FiSzXHbtUtTY0WTFJMRQ5%2FScreenshot%202024-11-18%20at%202.41.58%E2%80%AFPM.png?alt=media&amp;token=6034c3cc-f069-4ffe-b38a-516ff1144e68">Screenshot 2024-11-18 at 2.41.58 PM.png</a></td><td><a href="/ko/smallbuilder-documents/introduction">제품 소개</a></td></tr><tr><td><strong>SmallBuilder Lists</strong></td><td>필터, 대량 작업, 다른 시스템에서 데이터 조회 등을 포함하여 Low/No-Code 방식으로 맞춤형 리스트를 생성합니다.</td><td></td><td><a href="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FA66Sr6WcwnsNH8tdr2mc%2FScreenshot%202024-11-18%20at%202.40.50%E2%80%AFPM.png?alt=media&amp;token=a4a936ff-69a3-4f32-bda6-ba991fce16b8">Screenshot 2024-11-18 at 2.40.50 PM.png</a></td><td><a href="/ko/smallbuilder-lists/introduction">소개</a></td></tr></tbody></table>


# 중요 알림

SmallBuilder 제품 사용 시 꼭 확인이 필요한 사항을 안내합니다.

### [ECA 전환 필요 (2026.05.13)](/ko/important-notice/eca-transition)

Salesforce 정책 변경으로 Connected App이 외부 클라이언트 앱(ECA)으로 대체됩니다. 구버전 사용 시 빌더의 메타데이터 작업이 정상 동작하지 않을 수 있으므로 업그레이드 후 ECA 설정이 필요합니다.


# ECA 전환 필요 (2026.05.13)

{% hint style="danger" %}
**\[중요] 구버전 사용자 안내**

Salesforce의 정책 변경으로 **Connected App이 외부 클라이언트 앱(External Client App, ECA)으로 대체**됩니다. 아래 기준 버전 미만의 SmallBuilder 제품을 사용 중인 경우 **빌더에서 탭/버튼 생성, 페이지 레이아웃에 버튼 추가** 등 메타데이터 관련 기능이 정상 동작하지 않을 수 있습니다.

원활한 사용을 위해 아래 링크를 통해 **각 제품을 기준 버전 이상으로 업그레이드**한 뒤 외부 클라이언트 앱(ECA) 설정을 진행해 주세요.
{% endhint %}

### 제품별 기준 버전 및 업그레이드

<table><thead><tr><th width="220">제품</th><th width="140">기준 버전</th><th>업그레이드 / ECA 설정</th></tr></thead><tbody><tr><td><strong>SmallBuilder Line Items</strong></td><td>버전 <strong>3.0</strong> 이상</td><td><a href="https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000yrsfIAA">패키지 업그레이드</a> · <a href="/ko/smallbuilder-line-items/start-with/eca-setup">ECA 설정</a></td></tr><tr><td><strong>SmallBuilder Lists</strong></td><td>버전 <strong>3.1</strong> 이상</td><td><a href="https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000ytUfIAI">패키지 업그레이드</a> · <a href="/ko/smallbuilder-lists/undefined-1/eca-setup">ECA 설정</a></td></tr><tr><td><strong>SmallBuilder Schedules</strong></td><td>버전 <strong>2.0</strong> 이상</td><td><a href="https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000ytsrIAA">패키지 업그레이드</a> · <a href="/ko/smallbuilder-schedules/eca-setup">ECA 설정</a></td></tr><tr><td><strong>SmallBuilder Documents</strong></td><td>버전 <strong>1.93.29</strong> 이상</td><td><a href="https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000yrflIAA">패키지 업그레이드</a> · <a href="/ko/smallbuilder-documents/start-with/eca-setup">ECA 설정</a></td></tr></tbody></table>


# 시작하기 전에

### 패키지 설치

AppExchange에서 SmallBuilder를 조직에 설치합니다.

| [SmallBuilder Line Items](https://appexchange.salesforce.com/appxListingDetail?listingId=f4a72df3-85bc-45a9-9f8c-0a813c5350c5) | [SmallBuilder Documents](https://appexchange.salesforce.com/appxListingDetail?listingId=5fcef546-fbbb-47d8-b650-6e7e7dff3886) | [SmallBuilder Lists](https://appexchange.salesforce.com/appxListingDetail?listingId=b72c9291-b397-4d49-9917-234e6b5e6e84) | [SmallBuilder Schedules](https://appexchange.salesforce.com/appxListingDetail?listingId=75f63991-3cd2-4137-b8b5-8afe1a133f8b) |
| ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |

### 라이선스 및 권한 할당

**SmallBuilder**는 **10개의 라이선스를 무료로 제공**하고 있습니다. 제품을 사용하기 전에 각 사용자가 제품에 접근할 수 있도록 SmallBuilder 관련 라이선스와 권한 집합을 할당해야 합니다.

[라이선스 및 권한 할당](/ko)

### 조직 통화 설정

조직이 처음 생성된 후 통화가 null로 설정되어 있을 수 있습니다. 통화가 올바르게 설정되지 않으면 SmallBuilder가 제대로 작동하지 않을 수 있습니다. 제품을 사용하기 전에 조직의 통화가 제대로 설정되어 있는지 확인하세요.

[조직 통화 설정](/ko/undefined-1/undefined-1)

### 번역 활성화

SmallBuilder 제품들은 **영어**와 **한국어**를 지원합니다. 기본 언어는 영어이며, 한국어 번역을 사용하려면 **조직에서 번역 기능을 활성화**해야 합니다.

[번역 활성화](/ko/undefined-1/undefined-2)

### 연결된 앱 설정

SmallBuilder 제품에서 **페이지 레이아웃에 버튼 추가, 탭 생성 등** 메타데이터 관련 작업을 수행하려면 SmallBuilder에 연결된 앱에 대한 추가 설정이 필요합니다.

[연결된 앱 설정](/ko/undefined-1/undefined-3)


# 라이선스 및 권한 할당

SmallBuilder는 **10개의 라이선스를 무료로 제공**하고 있습니다. 제품을 사용하기 전에 각 사용자가 제품에 접근할 수 있도록 **SmallBuilder 라이선스와 권한 집합을 할당**해야 합니다.

{% hint style="info" %}
**샌드박스**에서는 라이선스 제한이 없기 때문에, 사용자에게 **라이선스를 할당하지 않아도 제품을 사용할 수 있습니다.**
{% endhint %}

### 라이선스 할당

SmallBuilder 정식 라이선스는 사용자당 부여되어야 합니다. 라이센스를 부여하는 방식은 다음과 같습니다:

1. 설정에서 빠른 찾기 상자에 **설치된 패키지**를 입력한 후 **설치된 패키지**를 선택합니다.
2. SmallBuilder {제품 이름}을 찾아 **라이센스 관리**를 클릭합니다.
3. **사용자 추가**를 눌러 원하는 사용자를 선택합니다.
4. **추가**를 클릭합니다.

{% hint style="info" %}
만약 SmallBuilder Line Items 제품을 사용하는 경우, SmallBuilder Line Items를 찾아 라이선스 관리로 이동하면 됩니다.
{% endhint %}

### 권한 집합 할당

SmallBuilder는 두 가지 권한 집합을 제공합니다. 사용자의 역할에 맞는 권한 집합을 적절히 할당해 주세요. 제품 기능을 원활하게 사용하려면 반드시 권한 집합을 할당해야 합니다.

* **SmallBuilder {제품 이름} Manager**

  SmallBuilder Manager 권한 집합은 제품의 전체 관리를 담당하는 사용자에게 할당됩니다. 주로 **관리자에게 할당**되며, 이 권한을 받은 관리자는 **빌더 설정 구성, 라인 아이템에 버튼 추가, 리스트 제품에서 탭 생성 등** 다양한 작업을 수행할 수 있습니다.
* **SmallBuilder {제품 이름} User**\
  SmallBuilder User 권한 집합은 주로 **영업 담당자나 프로젝트 매니저와 같은 사용자**에게 할당됩니다. 이 권한 집합을 할당받은 사용자는 SmallBuilder로 구현된 리스트나 문서를 보고, 라인 아이템 및 스케줄에서 데이터를 추가 및 수정할 수 있습니다.

{% hint style="info" %}
만약 SmallBuilder Line Items 제품을 사용하는 경우, SmallBuilder Line Items Manager 또는 SmallBuilder Line Items User 권한 집합을 할당합니다.
{% endhint %}


# 조직 통화 설정

SmallBuilder를 사용하기 위해 회사의 통화 설정을 확인합니다.

조직이 처음 생성된 후 통화가 null로 설정되어 있을 수 있습니다. 통화가 올바르게 설정되지 않으면 SmallBuilder가 제대로 작동하지 않을 수 있습니다. 제품을 사용하기 전에 조직의 통화가 제대로 설정되어 있는지 확인하세요.

{% hint style="warning" %}
다중 통화가 활성화되어 있는 경우, 해당 과정을 확인하지 않아도 됩니다.
{% endhint %}

1. 설정에서 빠른 찾기 상자에 **회사**를 입력한 후 **회사 정보**를 선택합니다.
2. **편집**을 클릭합니다.
3. **통화 설정**에서 **사용 통화**가 제대로 선택되어 있는지 확인합니다.

   null로 되어 있는 경우, 올바른 통화를 선택해 주세요.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-f0d7004a6d625e08fd5a45f8ba91fe6e72fc608f%2F%ED%86%B5%ED%99%94%20%EC%84%A4%EC%A0%95%201.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a9ad1c1a60ae24e4dd89cb28114d3b247b8091d8%2F%ED%86%B5%ED%99%94%20%EC%84%A4%EC%A0%95%202.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 번역 활성화

SmallBuilder 제품들은 **영어**와 **한국어**를 지원합니다. 기본 언어는 영어이며, 한국어 번역을 사용하려면 **조직에서 번역 기능을 활성화**해야 합니다.

1. 설정에서 빠른 찾기 상자에 **번역**을 입력한 후 번**역 언어 설정**을 선택합니다.
2. **한국어** **편집**을 클릭합니다.
3. **활성**을 체크합니다.
4. **저장**을 클릭합니다.
5. **영어**에 대해서도 **1\~4번 단계를 반복**합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-2f3ae3d13bf65b740fd5a4ffb3f013982afdc1b6%2F%EB%B2%88%EC%97%AD%20%EC%96%B8%EC%96%B4%20%EC%84%A4%EC%A0%95.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 연결된 앱 설정

SmallBuilder 제품을 설정하는 **빌더 화면**에서 **페이지 레이아웃에 버튼 추가, 탭 생성 등** 메타데이터 관련 작업을 수행하려면 SmallBuilder에 연결된 앱에 대한 추가 설정이 필요합니다.

{% hint style="info" %}
만약 SmallBuilder Line Items 제품을 사용하는 경우, SmallBuilder Line Items OAuth를 설정하세요.
{% endhint %}

### Step 1: 허용된 사용자 설정

1. 설정에서 빠른 찾기 상자에 **연결된 앱**을 입력한 후 **연결된 앱 관리**를 선택합니다.
2. **SmallBuilder {제품 이름} OAuth 편집**을 클릭합니다.
3. **허용된 사용자**를 **관리 승인 사용자가 미리 인증됨**으로 선택합니다.
4. **저장**을 클릭합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-c9779dae3fb9ae9a5c5ded615549d6c056afe2f4%2F%EC%97%B0%EA%B2%B0%EB%90%9C%20%EC%95%B1%20%EC%84%A4%EC%A0%95%201-1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-d8832b66c1962c7e9d0980b3442782e66c8623f4%2F%EC%97%B0%EA%B2%B0%EB%90%9C%20%EC%95%B1%20%EC%84%A4%EC%A0%95%201-2.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### Step 2: 프로필 또는 권한 집합 할당

1. 설정에서 빠른 찾기 상자에 **연결된 앱**을 입력한 후 **연결된 앱 관리**를 선택합니다.
2. **SmallBuilder {제품 이름} OAuth**을 클릭합니다.
3. 하단에 **프로필 관리** 또는 **권한 집합 관리**를 클릭합니다.
4. **빌더 설정을 담당하는 프로필 또는 권한 집합**을 선택합니다.
5. **저장**을 클릭합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1c83ce7da03c8ac9bdf137407574fd8240d2447d%2F%EC%97%B0%EA%B2%B0%EB%90%9C%20%EC%95%B1%20%EC%84%A4%EC%A0%95%202-1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5706ae107bd767df81a90b3ecf3a1ba76f5b1b7e%2F%EC%97%B0%EA%B2%B0%EB%90%9C%20%EC%95%B1%20%EC%84%A4%EC%A0%95%202-2.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 매뉴얼 용어

### 빌더

* 스탠다드 설정 (Standard Setting)
*

***

### 라인 아이템 편집기

* 라인 아이템 편집기 (Line Item Editor)
* 조회 선택기 (Lookup Selector)

***

### 제품 옵션

* 제품 옵션 (Product Option)
*


# 릴리즈 노트

### '26 Update

* [v 3.1](/ko/smallbuilder-line-items/release-notes/2026/v-3.1) - Line Item Editor의 Lookup 컬럼 값에서 레코드 상세 페이지로 이동하는 기능 추가, 빌더 필드 관리 테이블 UI/UX 개선
* [v 3.0](/ko/smallbuilder-line-items/release-notes/2026/v-3.0) - Salesforce 정책 변경에 따라 Connected App을 외부 클라이언트 앱(External Client App, ECA)으로 전환

### '25 Update

* [v 2.0.1](/ko/smallbuilder-line-items/release-notes/2025/v-2.0.1) - 라인 아이템 구성기 마이그레이션 기능 구현, 텍스트 영역 필드 UI/UX 개선, 필터 오류 등 수정
* [v 1.40.2](/ko/smallbuilder-line-items/release-notes/2025/v-1.40.2) - 비즈니스 규칙 변경 및 삭제 관련 오류 수정, 읽기 전용 제어 적용 오류 수정
* [v 1.40](/ko/smallbuilder-line-items/release-notes/2025/v-1.40) - 패키지 업그레이드 시 수식 해제되는 오류 수정, 라인 아이템 열에 도움말 텍스트 표시 제공 등
* [v 1.39](/ko/smallbuilder-line-items/release-notes/2025/v-1.39) - 컬럼 순서 변경 시 JavaScript 오류, 비즈니스 규칙 Key 매핑 오류 등 수정\
  옵션 기능 비활성화, 라인 아이템 가상 열 계산 기능 지원
* [v 1.38](/ko/smallbuilder-line-items/release-notes/2025/v-1.38) - 모바일 UI/UX 이슈 및 일부 저장 오류 수정
* [v 1.37](/ko/smallbuilder-line-items/release-notes/2025/v-1.37) - 데이터소스 명칭 및 UI/UX 변경, 라인 아이템 가상 열(Virtual Column) 제공 등


# '26 업데이트

<table><thead><tr><th width="97.59765625">버전</th><th>업데이트 사항</th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2026/v-3.1">3.1</a></td><td>Line Item Editor의 Lookup 컬럼 값에서 레코드 상세 페이지로 이동하는 기능 추가, 빌더 필드 관리 테이블 UI/UX 개선</td></tr><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2026/v-3.0">3.0</a></td><td>Salesforce 정책 변경에 따라 Connected App을 외부 클라이언트 앱(External Client App, ECA)으로 전환</td></tr></tbody></table>


# v 3.1

:package: **Package Upgrade**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf0000012kW1IAI>

:calendar\_spiral: **Release Date**

2026\. 05. 22.

:gear: **Features**

#### :small\_orange\_diamond: Line Item Editor의 Lookup 컬럼에서 레코드 상세 페이지로 이동

Line Item Editor의 **Lookup 컬럼 값에서 해당 레코드의 상세 페이지로 바로 이동**할 수 있게 되었습니다.

빌더에서 해당 옵션을 설정하면 Line Item Editor의 Lookup 컬럼 값에 **링크가 활성화**되며, 클릭 시 해당 레코드 페이지가 **새 탭에서 열립니다**.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-e375ea4f0e19efd88cf388d40f5f18d624c9d0a4%2F%EC%A1%B0%ED%9A%8C_%EB%A0%88%EC%BD%94%EB%93%9C_%EB%A7%81%ED%81%AC1.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5fad7eccec557a08766bfb33574b4bc0d5fd3a6b%2F%EC%A1%B0%ED%9A%8C_%EB%A0%88%EC%BD%94%EB%93%9C_%EB%A7%81%ED%81%AC2.png?alt=media" alt=""><figcaption></figcaption></figure>

:wrench: **Improvement**

#### :small\_orange\_diamond: 빌더 필드 관리 테이블 UI/UX 개선

빌더의 **Lookup 및 Line Item 필드 관리 테이블**의 UI/UX가 개선되었습니다.

* 평면적으로 나열되어 있던 필드 속성을 **필드 정보 / 초기값 / 레이아웃 / 동작** 그룹으로 묶어 기능 단위로 구분할 수 있도록 개선하였습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-b6bf47ce4f3b1909098e7ea8115f779ab2584aa4%2F%EB%B9%8C%EB%8D%94_%ED%95%84%EB%93%9C%EC%84%A4%EC%A0%95_UI.png?alt=media" alt=""><figcaption></figcaption></figure>

* Line Item Editor의 **고급 설정** 진입 방식을 행 하위에 펼쳐지는 구조에서 **설정(Setup) 아이콘 클릭 시 우측 Drawer로 열리는 방식**으로 변경하였습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-4706c647ae5ebeb1a03ae7700b088a02342011c5%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C_%EA%B3%A0%EA%B8%89%EC%84%A4%EC%A0%95_%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0.png?alt=media" alt=""><figcaption></figcaption></figure>


# v 3.0

:package: **Package Upgrade**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000yrsfIAA>

:calendar\_spiral: **Release Date**

2026\. 05. 13.

:gear: **Changes**

#### :small\_orange\_diamond: 외부 클라이언트 앱(ECA) 전환

Salesforce의 정책 변경에 따라 SmallBuilder Line Items의 **Connected App**이 **외부 클라이언트 앱(External Client App, ECA)** 으로 전환되었습니다. 버전 3.0부터는 빌더에서 **탭/버튼 생성, 페이지 레이아웃에 버튼 추가** 등 메타데이터 관련 작업을 수행하기 위해 ECA 설정이 필요합니다.

[외부 클라이언트 앱 (ECA) 설정 알아보기 >](/ko/smallbuilder-line-items/start-with/eca-setup)


# '25 업데이트

<table><thead><tr><th width="97.59765625">버전</th><th>업데이트 사항</th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2025/v-2.0.1">2.0.1</a></td><td>라인 아이템 구성기 마이그레이션 기능 구현, 텍스트 영역 필드 UI/UX 개선, 필터 오류 등 수정</td></tr><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2025/v-1.40.2">1.40.2</a></td><td>비즈니스 규칙 변경 및 삭제 관련 오류 수정, 읽기 전용 제어 적용 오류 수정</td></tr><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2025/v-1.40">1.40</a></td><td>패키지 업그레이드 시 수식 해제되는 오류 수정, 라인 아이템 열에 도움말 텍스트 표시 제공</td></tr><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2025/v-1.39">1.39</a></td><td>컬럼 순서 변경 시 JavaScript 오류, 비즈니스 규칙 Key 매핑 오류 등 수정<br>옵션 기능 비활성화, 라인 아이템 가상 열 계산 기능 지원</td></tr><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2025/v-1.38">1.38</a></td><td>모바일 UI/UX 이슈 및 일부 저장 오류 수정</td></tr><tr><td><a href="/ko/smallbuilder-line-items/release-notes/2025/v-1.37">1.37</a></td><td>데이터소스 명칭 및 UI/UX 변경, 라인 아이템 가상 열(Virtual Column) 제공 등</td></tr></tbody></table>


# v 2.0.1

:package: **Package Upgrade**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000Vy9ZIAS>

:calendar\_spiral: **Release Date**

2025\. 7. 3.

:gear: **Features**

<table data-header-hidden><thead><tr><th width="117.52734375"></th><th></th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/migration"><strong>마이그레이션</strong></a></td><td><p><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-ad5fb768e926291cfbabba291e09e5c4a0dcc54e%2Fsbli-migration-main.png?alt=media" alt="" data-size="original"></p><ul><li>라인 아이템 구성기 <strong>마이그레이션</strong> 기능 구현</li></ul></td></tr></tbody></table>

:wrench: **Improvement**

<table data-header-hidden><thead><tr><th width="119.15625"></th><th></th></tr></thead><tbody><tr><td><strong>편집기</strong></td><td><p><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FRHwqmK4HIa44AwUyaWsq%2Fimage.png?alt=media&amp;token=eaf2fe0d-2bd4-4f5b-8e51-029967d0cedb" alt="" data-size="original"></p><ul><li><strong>텍스트 영역(Textarea) 필드 UI/UX 개선</strong></li></ul><p>라인 아이템 편집기에서 <strong>텍스트 영역(Textarea) 필드의 입력 방식이 개선</strong>되었습니다.</p><p>기존에는 일반 텍스트 필드와 동일한 단일 줄 입력창으로 제공되어 줄바꿈이 불가능했으나, 이번 버전부터는 <strong>줄바꿈이 가능한 멀티라인 입력창으로 변경</strong>되어 보다 편리한 입력이 가능합니다.</p></td></tr></tbody></table>

:bug: **Bug Fixes**

<table data-header-hidden><thead><tr><th width="117.52734375"></th><th></th></tr></thead><tbody><tr><td><strong>빌더</strong></td><td><ul><li>라인 아이템의 <strong>읽기 전용 설정이 적용되지 않은 문제</strong> 해결</li><li>필터 도구에서 ‘<strong>포함되지 않음</strong>’ 조건이 있는 경우 <strong>‘Not’ 관련 오류</strong>가 발생되는 현상 해결</li><li>조회 또는 라인 아이템에서 <strong>열 추가 모달내</strong> 필드 검색 후 필드 선택 시 <strong>검색 결과가 초기화되는 현상 해결</strong></li></ul></td></tr></tbody></table>


# v 1.40.2

:package: **Package Upgrade**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000VIv7IAG>

:calendar\_spiral: **Release Date**

2025\. 6. 2.

:bug: **Bug Fixes**

<table data-header-hidden><thead><tr><th width="117.52734375"></th><th></th></tr></thead><tbody><tr><td><strong>빌더</strong></td><td><ul><li><p><strong>비즈니스 규칙 오류</strong></p><ul><li>비즈니스 규칙 삭제 후 저장을 누르면 'SObject' 관련 오류가 발생되던 문제 해결</li><li>평가 이벤트(Evaluation Event)를 변경한 후 빌더를 저장해도 변경이 반영되지 않던 문제 해결</li><li>객체 기반 규칙에서 작업을 삭제하고 빌더 저장하고 다시 확인해보면 삭제가 반영되지 않던 문제 해결</li><li>Apex 기반 규칙에서 평가 이벤트(Evaluation Event)가 "변경됨(On Change)"일 경우 평가 필드를 선택하는 모달이 로드가 되지 않던 문제 해결</li></ul></li><li><p>라인 아이템의 '<strong>삭제 제어 필드</strong>'에 대한 도움말 문구가 잘못되어 있어 수정</p><ul><li><strong>이전 내용:</strong> 라인 아이템 개체의 확인란(Boolean 유형) 필드여야 합니다. <mark style="color:red;">지정한 필드 값이 참인 경우, 레코드의 삭제 버튼이 활성화 되고 거짓인 경우 버튼이 비활성화 되어 사용자가 레코드를 삭제할 수 없도록 합니다.</mark></li><li><strong>수정된 내용:</strong> 지정한 필드는 라인 아이템 개체의 확인란(Boolean) 유형 필드여야 합니다. 해당 <mark style="color:green;">필드의 값이 참(</mark><code>true</code><mark style="color:green;">)인 경우, 해당 레코드의 삭제 버튼이 비활성화되어 사용자가 레코드를 삭제할 수 없도록 제어됩니다.</mark></li></ul></li><li>읽기 전용 조건에서 체크박스(Boolean) 필드를 조건으로 사용하는 경우, 제대로 적용되지 않던 문제 해결</li></ul></td></tr></tbody></table>


# v 1.40

:package: **Package Upgrade**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000ThrBIAS>

:calendar\_spiral: **Release Date**

2025\. 4. 30.

:bug: **Bug Fixes**

<table data-header-hidden><thead><tr><th width="117.52734375"></th><th></th></tr></thead><tbody><tr><td><strong>빌더</strong></td><td>버전 1.39 패키지 업그레이드 시 수식 적용이 자동으로 해제되던 현상 수정</td></tr></tbody></table>

:gear: **Features**

<table data-header-hidden><thead><tr><th width="119.2421875"></th><th></th></tr></thead><tbody><tr><td><strong>빌더</strong></td><td><ul><li>라인 아이템 열에서 적용된 계산식을 해제할 수 있도록 설정 제공</li><li>라인 아이템 열에 도움말 텍스트를 표시할 수 있도록 기능 제공</li></ul></td></tr></tbody></table>

### 라인 아이템 열에 적용된 계산식 해제하기

이전에는 적용된 계산식을 해제하려면 다른 옵션을 선택하거나 필드를 제거했다가 다시 추가해야 하는 번거로움이 있었습니다. 이번 버전부터는 **'계산식 적용 해제하기'** 버튼을 통해 계산식을 바로 해제할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-df381707b404cf23257f4f65e12bab2e9960c59a%2Fcalc_remove.png?alt=media" alt=""><figcaption></figcaption></figure>

### 도움말 텍스트 설정

컬럼 옆에 도움말 텍스트를 표시하여 사용자에게 컬럼의 용도를 안내할 수 있습니다. 도움말 텍스트 기능이 활성화된 상태에서 입력한 값이 없는 경우, 개체 필드에 설정된 도움말 텍스트가 표시됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-ac3bb49073b3c6bc1fc5af7b0404abea7a4dd160%2Flineitem_helptext.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-ebf786f29eca665a65d03366d9e57c27098dd6cc%2Fhelptext_example.png?alt=media" alt=""><figcaption></figcaption></figure>


# v 1.39

:package: **Package Upgrade (v1.39.1)**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000TeRtIAK>

:calendar\_spiral: **Release Date**

2025\. 4. 28.

:bug: **Bug Fixes**

<table data-header-hidden><thead><tr><th width="117.52734375"></th><th></th></tr></thead><tbody><tr><td><strong>빌더</strong></td><td><ul><li>Apex 클래스를 이용한 비즈니스 규칙에서 Key 선택 시, 라인 아이템 필드가 검색되어 잘못 매핑되었던 문제 수정</li><li>조회 및 라인 아이템에서 컬럼 순서를 변경할 때 발생하던 JavaScript 오류 수정</li><li>개체 기반 비즈니스 규칙에서 필터 설정 시 조회 개체 필드 바인딩 기능 제거<br>-> 해당 기능은 내부적으로 이슈가 있어 기능을 제거함<br><em><mark style="color:green;">추후 별도의 UI/UX를 통해 다시 제공될 예정입니다.</mark></em></li></ul></td></tr><tr><td><strong>편집기</strong></td><td><ul><li>패키지 라이선스가 없는 경우, “Internal Error” 대신 “라이선스가 필요합니다” 메시지를 표시하여 사용자 혼란 해소</li><li>필수로 설정된 일부 컬럼들이 화면 상에 필수 표시가 나타나지 않던 문제 수정</li><li>편집기가 플로에 삽입되어 있는 상태에서 저장을 진행하면 로딩 화면이 사라지지 않던 현상 해결</li></ul></td></tr></tbody></table>

:gear: **Features**

<table data-header-hidden><thead><tr><th width="119.2421875"></th><th></th></tr></thead><tbody><tr><td><strong>공통</strong></td><td>버전 1.39부터 옵션 기능 비활성화<br><em><mark style="color:orange;">기존에 옵션 기능을 사용 중인 경우 기능은 계속 유지됩니다.</mark></em></td></tr><tr><td><strong>빌더</strong></td><td><ul><li>라인 아이템의 가상 열이 숫자 또는 통화 유형인 경우, 자릿수 표시 및 계산식 적용 기능 제공</li><li>라인 아이템 열에서 필수 및 읽기 전용을 조건에 따라 제어할 수 있도록 설정 제공</li><li>라인 아이템의 참조형 컬럼 설정에서 필터 도구 제공</li><li>필터 도구에서 SOQL 조건이 있는 경우 기본 필터 설정과 ‘AND’ 조건으로 자동 결합되도록 수정</li></ul></td></tr><tr><td><strong>편집기</strong></td><td><ul><li>라인 아이템 열의 너비가 설정되어 있지 않은 경우, 기본적으로 <strong>최소 너비 150px</strong>로 적용되어 지나치게 좁게 표시되는 현상 해소</li></ul></td></tr></tbody></table>

### 라인 아이템 가상 열에 자릿수 표시 및 계산식 설정

기존에는 라인 아이템 가상 열은 그저 비즈니스 규칙(데이터소스)의 데이터 표시 용도로만 사용되었습니다. 해당 버전에서는 가상 열 유형이 **통화 또는 숫자인 경우 자릿수 표시(Scale)와 계산식(수식, 할인율, 기간)을 적용할 수 있도록 설정**할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-054164cca2aa7fe947c064d92e52b3d7027f3982%2Flineitem_virtual_setting.png?alt=media" alt=""><figcaption></figcaption></figure>

### 조건에 따라 라인 아이템 열의 필수 여부 또는 읽기 전용 상태로 제어하기

부모, 조회, 라인 아이템의 필드 값에 따라 필수 여부와 읽기 전용 상태를 제어할 수 있습니다. 라인 아이템의 경우 컬럼에 추가되어 있는 필드가 변경되었을 때 조건을 평가합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-7044074182ffab400fe91321bf3995afe813f1e8%2Freadonly_control.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-332789f0417c55cecdd5c531039cba4e584db524%2Frequired_control.png?alt=media" alt=""><figcaption></figcaption></figure>

### 빌더의 필터 도구 변경사항

기존에는 SOQL을 직접 입력하는 경우 `AND` 또는 `OR`를 앞에 작성해야 했습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-c3fffad25666fae1bc642570acaf074b265d8731%2FSOQL%EC%9E%91%EC%84%B1.png?alt=media" alt=""><figcaption></figcaption></figure>

하지만 이번 버전부터는 자동으로 `AND` 조건으로 결합하게 됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-b656152ac53eafc981dfb13d99dec394a0990578%2Ffilter_tool_soqleditor_and.png?alt=media" alt=""><figcaption></figcaption></figure>


# v 1.38

:package: **Package Upgrade**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000T9KrIAK>

:calendar\_spiral: **Release Date**

2025\. 4. 8.

:bug: **Bug Fixes**

<table data-header-hidden><thead><tr><th width="117.52734375"></th><th></th></tr></thead><tbody><tr><td><strong>빌더</strong></td><td><p>조회 선택기 및 라인 아이템 편집기 설정 단계에서 필드를 모두 삭제한 후 다시 필드를 추가하여 저장할 때 오류가 발생하던 문제 해결<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> 기존에 패키지가 설치된 조직에서는 <strong>라인 아이템 편집기</strong>(<code>SBLI__JunctionBuilder__c</code>) <strong>개체 설정</strong>에서 아래 <strong>확인 규칙(Validation Rule)을 비활성화</strong> 하세요:</p><ul><li>RequiredLookupFieldsAtLeastOne</li><li>RequiredLineItemFieldsAtLeastOne</li></ul></td></tr><tr><td><strong>편집기</strong></td><td><ul><li>옵션 가격이 수정된 상태에서 옵션 선택기를 열면 수정된 가격이 반영되지 않던 현상 해결</li><li>필드 값을 삭제한 뒤 저장하고 다시 편집기를 열었을 때, 공란 상태가 반영되지 않던 문제 해결</li></ul><p><br><strong>모바일 화면:</strong></p><ul><li>라인 아이템 추가 시 Recalculation Formula 관련 오류가 발생하던 문제 해결</li><li>읽기 전용 필드의 값이 없을 때 하단 필드와 간격이 없어 구분이 어려웠던 문제 개선</li></ul></td></tr></tbody></table>


# v 1.37

:package: **Package Upgrade**

<https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPf000000MNh7IAG>

:calendar\_spiral: **Release Date**

2025\. 4. 2.

:gear: **Features**

<table data-header-hidden><thead><tr><th width="198.72265625"></th><th></th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/builder/datasource"><strong>데이터소스</strong></a></td><td><ul><li>데이터소스 명칭 변경: <strong>데이터소스</strong>에서 <strong>비즈니스 규칙(Business Rule)</strong>로 명칭이 변경되었습니다.</li><li>비즈니스 규칙 설정 화면(UI/UX) 개선</li><li>Evaluation Event에 ‘<strong>On Change</strong>’ 옵션 추가: 특정 필드 값이 변경될 때 비즈니스 규칙이 자동으로 실행되도록 설정할 수 있습니다.</li></ul></td></tr><tr><td><strong>라인 아이템 편집</strong></td><td>라인 아이템에 <a href="https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/release-notes/2025/broken-reference/README.md"><strong>Virtual Column(가상 열)</strong></a> 기능 제공<br>(현재 비즈니스 규칙(데이터소스) 용도로만 쓰임)</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/filter-expression-tool"><strong>필터 설정 UI/UX 개선</strong></a></td><td>기존에는 SOQL 문을 직접 입력하여 필터를 설정했지만, 이제는 제공되는 필터 설정 UI를 통해 필터 표현 식을 더 쉽고 직관적으로 구성할 수 있습니다. 라인 아이템, 조회, 비즈니스 규칙(데이터소스)의 필터 설정에 적용되었습니다.</td></tr></tbody></table>

### 데이터소스 UI/UX 변경 사항

기존에는 데이터소스 레이아웃에서 직접 값을 입력하여 설정하는 방식이었으나,UI 변경된 버전에서는 보기 화면과 편집 화면이 분리되어 있습니다. 이제 데이터소스를 추가하거나 편집할 때는 모달 창을 통해 작업하게 됩니다.

* 설명란을 추가하여 해당 비즈니스 규칙(데이터소스)에 대한 정보를 기재할 수 있도록 하였습니다.
* 기존에는 필터를 직접 입력해야 하는 부분이 어드민에게 다소 어려움이 있어 필터 설정 도구를 제공하였습니다.
* Apex 클래스를 사용한 비즈니스 규칙(데이터소스 고급)에서 파라미터가 많을 경우 보이지 않은 불편함을 개선하였습니다.

#### 기존 화면

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FAceobyDAy73p6MoqaERI%2Fimage.png?alt=media&amp;token=075e3a38-e93b-421d-8e70-5a6f3203dc1e" alt=""><figcaption></figcaption></figure>

#### 변경된 화면

**조회 화면**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1f6b300473e875c682422ab175b955f145a56cd2%2F%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%86%8C%EC%8A%A4%EB%B3%80%EA%B2%BD.png?alt=media" alt=""><figcaption></figcaption></figure>

**추가 또는 편집 화면**

<table><thead><tr><th width="373.7265625">관련 객체를 이용한 비즈니스 규칙(데이터소스 기본)</th><th>Apex 클래스를 사용한 비즈니스 규칙(데이터소스 고급)</th></tr></thead><tbody><tr><td><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fu52DDhwr0XeegnfIIWrY%2Fimage.png?alt=media&amp;token=043420fe-9339-4c2b-ab6c-45a9ddd27071" alt="" data-size="original"></td><td><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FeShgrVoKbhX7tm1fvIz8%2Fimage.png?alt=media&amp;token=361570aa-eba0-4d00-8511-4feb28b30a64" alt="" data-size="original"></td></tr></tbody></table>


# '24 Update

:package: [v 1.26](https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/release-notes/24-update/broken-reference/README.md) - 복잡한 계산식 오류, 할인율 및 계산식 적용 방식 수정


# v 1.20 \~

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.26.1-1">v 1.26.1</a></summary>

* Line Item Editor의 할인율과 계산식 중 하나만 적용 가능하도록 수정
* 할인율 관련 일부 레이블 변경

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.26.0-1">v 1.26.0</a></summary>

* Line Item의 레코드를 여러개 삭제할 수 있도록 기능 개선
* 제품 옵션 관련 일부 레이블 변경

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.25.0-1">v 1.25.0</a></summary>

* 편집기의 타이틀명 (조회 선택기, 라인 아이템 편집기) 수정할 수 있도록 설정 추가
* 라인 아이템 편집기의 조회 컬럼을 설정할 수 있도록 기능 추가

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.24.1-1">v 1.24.1</a></summary>

* 라인 아이템 레코드 조회 조건 추가

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.22.0-1">v 1.22.0</a></summary>

* 마이그래이션 시 필요한 Key 필드 추가 및 데이터 작업

</details>

***

## v 1.27.0

:calendar\_spiral: **Release Date**

2024\. 8. 5.

:ledger: **Summary**

* 조회 검색시 화면에서 필터 기능 개선

:bug: **Fixed**

* 할인율 계산 로직 누락

:gear: **Feature**

## v 1.26.1

:calendar\_spiral: **Release Date**

2024\. 7. 22.

:ledger: **Summary**

* Line Item Editor의 할인율과 계산식 중 하나만 적용 가능하도록 수정
* 할인율 관련 일부 레이블 변경

#### :gear: Feature

{% tabs %}
{% tab title="빌더" %} <mark style="color:blue;">**라인 아이템 편집기**</mark>

**할인율과 계산식 중 하나만 적용 가능하도록 수정**

숫자 및 통화 유형의 컬럼에서 설정할 수 있는 '계산식 적용'과 '할인 기능 적용' 설정을 통합하여 둘 중에 하나의 기능만 적용되도록 수정하였습니다.

{% hint style="warning" %}
할인 계산기 적용은 통화 유형의 컬럼에서만 설정이 가능합니다.
{% endhint %}

| 기존                                                                                                                                                                                                                                                        | 변경                                                                                                                                                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fhbvnz7bqwokY5oeDxkcD%2Fimage.png?alt=media&amp;token=8570ae0f-067e-4b92-aae8-54bbed60666e" alt="" data-size="original"> | <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F9ksi3PZeKl5XQd6bN2b0%2Fimage.png?alt=media&amp;token=26cb9da3-2df5-4f0f-8915-870048ec4b83" alt="" data-size="original"> |

**'할인율 계산기 적용' 설정에서 '통화 기반 입력' 레이블 변경**

* **영어**

  Based on Currency -> Enter Discounted Price
* **한국어**\
  통화 기반 할인 입력 -> 할인된 가격 입력
  {% endtab %}
  {% endtabs %}

## v 1.26.0

:calendar\_spiral: **Release Date**

2024\. 7. 19.

:ledger: **Summary**

* Line Item의 레코드를 여러개 삭제할 수 있도록 기능 개선
* 제품 옵션 관련 일부 레이블 변경

:bug: **Fixed**

:heavy\_check\_mark: Calculation Formula에 복잡한 산식을 적용했을 때 계산이 작동하지 않던 문제 해결

:gear: **Feature**

{% tabs %}
{% tab title="편집기" %} <mark style="color:blue;">**라인 아이템 편집기**</mark>

**다중 삭제 기능 추가**\
편집기에서 여러 레코드를 삭제할 수 있도록 다중 삭제 기능을 추가하였습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FwhoMRPFSQ0XUDA1vBBkT%2Fimage.png?alt=media&amp;token=2adb51d4-9b8f-491c-93a6-55952136c26b" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**제품 옵션**</mark>

**필드 레이블 변경**

Product Feature, Option 개체의 한국어 번역과 일부 필드 레이블을 수정하였습니다.

* **Product Feature 한국어 레이블 변경**

  제품 Feature -> 제품 구성
* **Product Feature,** *P***roduct Option 개체의 Product 영어/한국어 레이블 변경**
  * **영어**

    Product -> Main Product
  * **한국어**

    제품 -> 기본 제품
    {% endtab %}
    {% endtabs %}

## v 1.25.0

:calendar\_spiral: **Release Date**

2024\. 7. 16.

:ledger: **Summary**

* 편집기의 타이틀명 (조회 선택기, 라인 아이템 편집기) 수정할 수 있도록 설정 추가
* 라인 아이템 편집기의 조회 컬럼을 설정할 수 있도록 기능 추가

#### :gear: Feature

{% tabs %}
{% tab title="빌더" %} <mark style="color:blue;">**레이블 변경 기능**</mark>

편집기 모달의 타이틀과 조회 레코드 검색 버튼의 레이블을 수정할 수 있도록 빌더에 설정을 추가하였습니다.

| 빌더 설정                                                                                                                                                                                                                                                     | 결과                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FxNm51wRa1XfhG3t3eOXr%2Fimage.png?alt=media&amp;token=8eb9d836-e286-4ac8-8b9b-d8da342c4116" alt="" data-size="original"> | <ul><li><strong>조회 선택기</strong></li></ul><p><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fw4yuPyTjfBsXYO1UNGZG%2Fimage.png?alt=media&amp;token=324233f3-719c-4725-b610-c42552e1bc36" alt="" data-size="original"></p><ul><li><strong>라인 아이템 편집기</strong></li></ul><p><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FEraBchjsLGLc1Eu62SD7%2Fimage.png?alt=media&amp;token=404b9ad9-5020-4a16-b163-b779d8854cae" alt="" data-size="original"></p> |

<mark style="color:blue;">**라인 아이템 편집기**</mark>

**조회 컬럼 설정 기능 추가**

라인 아이템 편집기에서 가장 첫 번째로 나타나는 '조회 컬럼'을 커스텀할 수 있도록 빌더에 설정을 추가하였습니다.

> **설정 가능한 기능**
>
> * 레이블 변경
> * 열 너비
> * 텍스트 정렬
> * 숨김 (제품 옵션이 활성화 된 경우 설정 불가능)

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FgtwuXtXRQxt69lBJxNwX%2Fimage.png?alt=media&amp;token=6e2dbdf6-91de-4314-bae5-321aad7ebfa8" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## v 1.24.1

:calendar\_spiral: **Release Date**

2024\. 7. 10.

:ledger: **Summary**

* 라인 아이템 레코드 조회 조건 추가

#### :gear: Feature

{% tabs %}
{% tab title="빌더" %} <mark style="color:blue;">**라인 아이템 편집기**</mark>

**레코드 조회 조건 기능**

저장된 라인 아이템의 레코드를 조회할 때 조건을 지정할 수 있도록 빌더에 설정을 추가하였습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FmYuybA6ThWbU846WhtrV%2Fimage.png?alt=media&amp;token=59058fa0-31ef-4931-b658-a99c4b064a11" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## v 1.22.0

:calendar\_spiral: **Release Date**

2024\. 6. 19.

:ledger: **Summary**

* 마이그래이션 시 필요한 Key 필드 추가 및 데이터 작업

#### :gear: Feature

SmallBuilder Line Items 관련 개체에 Migration Key(`SBLI__MigrationKey__c)`필드가 추가되었습니다. 레코드를 생성할 때 Migration Key 필드에 값이 없을 경우, 해당 레코드의 ID가 자동으로 저장됩니다.

> **대상 개체**
>
> * 라인 아이템 편집기 (SBLI\_\_JunctionBuilder\_\_c)
> * 조회 열 (SBLI\_\_LookupField\_\_c)
> * 라인 아이템 열 (SBLI\_\_JunctionField\_\_c)
> * 데이터소스 (SBLI\_\_DataSource\_\_c)
> * 데이터소스 작업 (SBLI\_\_DataSourceAction\_\_c)
> * 제품 구성 (SBLI\_\_ProductFeature\_\_c)
> * 제품 옵션 (SBLI\_\_ProductOption\_\_c)


# v 1.10 \~

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.17.5-1">v 1.17.5</a></summary>

미리보기에서 레코드 검색 시 'LastViewedDate' 필드 관련 오류 해결

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.17.3-1">v 1.17.3</a></summary>

쿼리 마법사에서 연산자를 '포함'으로 선택하여 생성한 모든 쿼리에서 발생한 오류 해결

</details>

<details>

<summary><span data-gb-custom-inline data-tag="emoji" data-code="1f4e6">📦</span> <a href="#v-1.16.0-1">v 1.16.0</a></summary>

* 라인 아이템 채번 기능 추가
* 편집기에서 제품 옵션 추가 시 전체 선택 및 해제 기능 추가

</details>

***

## v 1.17.5

:calendar\_spiral: **Release Date**

2024\. 5. 24.

#### :bug: **Fixed**

**빌더**

:heavy\_check\_mark: 미리보기에서 레코드 검색 시 'LastViewedDate' 필드 관련 오류 해결

## v 1.17.3

:calendar\_spiral: **Release Date**

2024\. 5. 23.

:bug: **Fixed**

**빌더**

:heavy\_check\_mark: 쿼리 마법사에서 연산자를 '포함'으로 선택하여 생성한 모든 쿼리에서 발생한 오류 해결

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FG36xMOsDTDP5aRn2tJP4%2Fimage.png?alt=media&amp;token=8f9a16d8-c8a5-4b00-ac23-e62453b16b69" alt=""><figcaption></figcaption></figure>

:heavy\_check\_mark: 조회 검색 설정에서 '일치 조건'이 '다음으로 시작'인 경우, 편집기에서 조회 레코드를 검색할 때 발생했던 오류 해결

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F0jvhBHve8td3yJu1D9Rg%2Fimage.png?alt=media&amp;token=6ce0be32-054e-486f-b782-1454e20faa04" alt=""><figcaption></figcaption></figure>

## v 1.16.0

:calendar\_spiral: **Release Date**

2024\. 4. 29.

:ledger: **Summary**

* 라인 아이템 채번 기능 추가
* 편집기에서 제품 옵션 추가 시 전체 선택 및 해제 기능 추가

:gear: **Feature**

{% tabs %}
{% tab title="빌더" %} <mark style="color:blue;">**라인 아이템 편집기**</mark>

**채번 기능**

라인 아이템 개체 단계에서 채번할 필드를 지정하여 자동 채번이 되도록 설정을 추가하였습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FoZ7wYPkGiW08QsBgx0TA%2Fimage.png?alt=media&amp;token=0633c052-2250-4c16-9495-afb7e0ee890e" alt=""><figcaption><p>개체 연결 > 라인 아이템 개체</p></figcaption></figure>
{% endtab %}

{% tab title="편집기" %} <mark style="color:blue;">**제품 옵션**</mark>

제품 옵션 선택 시 전체 선택 및 해제 가능하도록 상단에 체크박스를 추가하였습니다.

(이미지 준비 중)
{% endtab %}
{% endtabs %}


# 제품 소개

### 개요

SmallBuilder Line Items는 기회 및 견적 같은 표준 개체는 물론 사용자 정의 개체에서 할인율 계산기, 외부 데이터 연동을 지원하는 라인 아이템 편집기를 개발 없이 구현하도록 지원합니다.

### 왜 라인 아이템 편집기를 사용해야 하나요?

세일즈포스에서 대표적으로 Junction 관계를 맺은 개체로는 **기회, 견적, 주문**이 있습니다. 이들은 세일즈 클라우드에서 필수로 사용되는 개체들입니다. 세일즈포스에서 이러한 개체들의 라인 아이템을 추가하거나 변경할 때 제공되는 기본 기능들은 훌륭하지만, 일부 불편한 사항들이 존재합니다.

{% hint style="warning" %}
라인 아이템 편집기는 현재 :link:[**Junction 관계 (many-to-many)**](#junction-object) 개체들만 지원하고 있습니다.
{% endhint %}

예를 들어, 판매 가격이나 수량을 입력할 때 총액이 즉시 계산되지 않거나, 할인율을 사용자가 직접 계산해 입력해야 하는 부분이 있습니다. 또한, 많은 사용자들은 제품 선택이나 라인 아이템 입력 시 자체 서버에서 재고 데이터를 가져와 참고하고 싶어 합니다. 더불어, 다른 개체에서 계정별 할인율을 자동으로 적용하여 계산되길 원합니다. 이러한 요구 사항을 해결하려면 개발자의 도움이 필요하고, 기능을 추가하거나 변경할 때 어드민이 쉽게 커스터마이징할 수 없는 한계가 있습니다. 그러나 라인 아이템 편집기를 사용하면 개발 없이 포인트 & 클릭 방식으로 이와 같은 단점을 보완할 수 있습니다.

* 라인 아이템 추가 또는 편집 시 자동 계산, 외부 데이터 적용 등 **최소한의 개발 및 포인트 & 클릭만으로 기능 확장**이 가능합니다.
* 빌더를 이용하여 손쉽게 화면을 구현할 수 있어 **시간을 절약**할 수 있고 유지보수로서 **기능 추가 및 수정을 하는데 어려움이 없습니다.**
* 라인 아이템 편집기를 구현할 때 필요한 기본 설정은 개발이 필요하지 않아, **세일즈포스 기본 지식을 갖춘 어드민만으로도 화면을 구현**할 수 있습니다.

#### 세일즈포스 스탠다드 화면

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fz26VtPp2wySbeSYXVU7M%2FStandard%20Opportunity%20Line-Item.gif?alt=media&amp;token=5bda1a15-588d-4aa5-816b-6c04aec65cd8" alt=""><figcaption><p>Standard 화면에서 제품 추가 후 단가 또는 수량 변경 시 총액이 자동 계산이 되지 않습니다.</p></figcaption></figure>

#### 라인 아이템 편집기 화면

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FCjyMRWQzV3JvPK4HH2NT%2FLine-Item%20Configurator.gif?alt=media&amp;token=217f6952-1a0a-488a-9c78-d4c2092d2131" alt=""><figcaption><p>라인 아이템 편집기로 스탠다드의 제품 편집을 재구현하여 재고 표시, 자동 계산, 할인율 등 기능을 확장합니다.</p></figcaption></figure>

### Junction Object란 무엇인가요?

라인 아이템 편집기는 Junction 관계를 맺은 개체들을 기반으로 구성됩니다. 앞서 말했듯이 대표적으로 기회, 견적, 주문이 있습니다. 이 중에서 기회의 라인 아이템 구조를 살펴봅시다.

우리는 기회(`Opportunity`)에서 제품을 추가하려고 합니다. 이때 제품의 정보와 가격 정보를 가져오기 위해서는 모든 관련 정보를 포함하는 가격 목록 항목(`PricebookEntry`) 개체가 필요합니다. 그런 다음, 제품을 추가할 때 입력하는 판매가, 수량 등의 정보를 함께 저장하는 개체가 바로 기회 제품(`OpportunityLineItem`)입니다.

<div data-full-width="false"><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FS4WGUfHdeu2Tmc81OH9f%2FJunction_Diagram.png?alt=media&amp;token=5eb22b98-607c-46b2-99a7-805447600fd2" alt=""><figcaption></figcaption></figure></div>

**기회 제품(**`OpportunityLineItem`**)**&#xC740; 위의 그림과 같이 **기회(**`Opportunity`**)**&#xC640; **가격 목록 항목(**`PricebookEntry`**)**&#xC758; 정보를 모두 포함하고 있습니다. 기회 제품은 기회에 여러 가격 목록 항목을 등록할 수 있도록 연결해 주는 역할을 하며, 이러한 역할을 하는 개체를 **Junction 개체**라고 합니다.

위의 관계들만 맺고 있으면 언제든지 라인 아이템 편집기를 구현할 수 있습니다. 그리고 이러한 관계 속에 있는 각 개체들은 라인 아이템 편집기에서 아래와 같이 지칭하고 있습니다:

* 기회: 부모
* 가격 목록 항목: 조회
* 기회 제품: 라인 아이템

### 주요 기능

:heavy\_check\_mark: **모든 개체 지원**

SmallBuilder Line Items의 라인 아이템 편집기는 모든 개체를 지원합니다. 따라서 표준 기회 또는 견적뿐만 아니라 커스텀 개체에서도 제품 등 라인 아이템을 처리 하는 기능을 구현 시 더 이상 코딩은 필요 없습니다.

:heavy\_check\_mark: **포인트 & 클릭 기반 저작 툴**

기회, 제품 및 가격 목록과 같이 3개 이상의 개체로 이루어지는 복잡한 라인 아이템 편집기(Line Item Editor)를 손쉽게 구현할 수 있는 [**빌더**](/ko/smallbuilder-line-items/builder/getting-stared-with-the-builder)를 제공하고 있습니다.

:heavy\_check\_mark: **외부 데이터 실시간 연동**

외부 데이터의 실시간 연동이 필요한 경우 라인 아이템 편집기(Line Item Editor)는 연동을 담당하는 Apex Code를 호출하여 외부 데이터를 실시간으로 연동할 수 있도록 지원합니다.

:heavy\_check\_mark: **CPQ의 대안**

라인 아이템 편집기(Line Item Editor)는 Currency 필드에 할인율 계산기를 적용할 수 있습니다. 편리한 할인율 계산이 중요한 경우 훌륭한 CPQ의 대안으로 활용 가능합니다.


# 시작하기 전에

### 패키지 설치

**AppExchange**에서 **SmallBuilder Line Items**를 조직에 설치합니다.

{% embed url="<https://appexchange.salesforce.com/appxListingDetail?listingId=f4a72df3-85bc-45a9-9f8c-0a813c5350c5>" %}

***

### 라이선스 및 권한 할당

**SmallBuilder Line Items**는 **10개의 라이선스를 무료로 제공**하고 있습니다. 제품을 사용하기 전에 각 사용자가 제품에 접근할 수 있도록 SmallBuilder Line Items 관련 라이선스와 권한 집합을 할당해야 합니다.

[라이선스 및 권한 할당 >](/ko/smallbuilder-line-items/start-with/assigning-licenses-and-permissions)

### 조직 통화 설정

조직이 처음 생성된 후 통화가 null로 설정되어 있을 수 있습니다. 통화가 올바르게 설정되지 않으면 SmallBuilder Line Items가 제대로 작동하지 않을 수 있습니다. 제품을 사용하기 전에 조직의 통화가 제대로 설정되어 있는지 확인하세요.

[조직 통화 설정 >](/ko/undefined-1/undefined-1)

### 번역 활성화

SmallBuilder Line Items는 **영어**와 **한국어**를 지원합니다. 기본 언어는 영어이며, 한국어 번역을 사용하려면 **조직에서 번역 기능을 활성화**해야 합니다.

[번역 활성화 >](/ko/smallbuilder-line-items/start-with/translation)

### 연결된 앱 설정

빌더에서 **페이지 레이아웃에 버튼 추가, 커스텀 라벨 조회 등** 메타데이터 관련 작업을 수행하려면 SmallBuilder Line Items에 연결된 앱에 대한 추가 설정이 필요합니다.

{% hint style="info" %}
버전 3.0부터는 Connected App 대신 **외부 클라이언트 앱(External Client App, ECA)** 으로 전환되었습니다.
{% endhint %}

[연결된 앱 설정 >](/ko/smallbuilder-line-items/start-with/connected-app-setup)

[외부 클라이언트 앱 (ECA) 설정 >](/ko/smallbuilder-line-items/start-with/eca-setup)


# 라이선스 및 권한 할당

SmallBuilder Line Items는 10개의 라이선스를 무료로 제공하고 있습니다. 제품을 사용하기 전에 각 사용자가 제품에 접근할 수 있도록 SmallBuilder Line Items 라이선스와 권한 집합을 할당해야 합니다.

{% hint style="info" %}
샌드박스에서는 라이선스 제한이 없기 때문에, 사용자에게 라이선스를 할당하지 않아도 제품을 사용할 수 있습니다.
{% endhint %}

### 라이선스 할당

SmallBuilder Line Items 정식 라이선스는 사용자당 부여되어야 합니다. 라이센스를 부여하는 방식은 다음과 같습니다:

1. 설정에서 빠른 찾기 상자에 **설치된 패키지**를 입력한 후 **설치된 패키지**를 선택합니다.
2. SmallBuilder Line Items를 찾아 **라이센스 관리**를 클릭합니다.
3. **사용자 추가**를 눌러 원하는 사용자를 선택합니다.
4. **추가**를 클릭합니다.

### 권한 집합 할당

SmallBuilder Line Items는 두 가지 권한 집합을 제공합니다. 사용자의 역할에 맞는 권한 집합을 적절히 할당해 주세요. 제품 기능을 원활하게 사용하려면 반드시 권한 집합을 할당해야 합니다.

**SmallBuilder Line Items Manager**

SmallBuilder Line Items Manager 권한 집합은 조직 내 관리자가 SmallBuilder Line Items의 전체 관리를 쉽게 수행할 수 있도록 설계되었습니다. 이 권한 집합을 할당받은 관리자는 빌더 설정을 구성하거나 라인 아이템 버튼을 추가하는 등의 작업을 원활하게 진행할 수 있습니다.

**SmallBuilder Line Items User**

SmallBuilder Line Items User 권한 집합은 라인 아이템을 편집해야 하는 일반 사용자들이 원활하게 작업할 수 있도록 설계되었습니다. 주로 영업 담당자나 프로젝트 매니저와 같이 라인 아이템을 보고 수정하는 역할을 맡은 사용자에게 할당됩니다. 이 권한 집합을 통해 사용자는 라인 아이템 데이터를 쉽게 조회하고 업데이트할 수 있습니다.


# 조직 통화 설정

SmallBuilder를 사용하기 위해 회사의 통화 설정을 확인합니다.

조직이 처음 생성된 후 통화가 null로 설정되어 있을 수 있습니다. 통화가 올바르게 설정되지 않으면 SmallBuilder가 제대로 작동하지 않을 수 있습니다. 제품을 사용하기 전에 조직의 통화가 제대로 설정되어 있는지 확인하세요.

{% hint style="warning" %}
다중 통화가 활성화되어 있는 경우, 해당 과정을 확인하지 않아도 됩니다.
{% endhint %}

1. 설정에서 빠른 찾기 상자에 **회사**를 입력한 후 **회사 정보**를 선택합니다.
2. **편집**을 클릭합니다.
3. **통화 설정**에서 **사용 통화**가 제대로 선택되어 있는지 확인합니다.

   null로 되어 있는 경우, 올바른 통화를 선택해 주세요.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-4927f9d9ffbb2959b0fc6a88dafc7b02ecced9a0%2F%ED%9A%8C%EC%82%AC%20%EC%A0%95%EB%B3%B4.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-415cdf03a9a1ed16511ca5fcc1e80e89a870e191%2F%ED%86%B5%ED%99%94%20%EC%84%A4%EC%A0%95.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 번역 활성화

SmallBuilder Line Items는 **영어**와 **한국어**를 지원합니다. 기본 언어는 영어이며, 한국어 번역을 사용하려면 **조직에서 번역 기능을 활성화**해야 합니다.

1. 설정에서 빠른 찾기 상자에 **번역**을 입력한 후 번**역 언어 설정**을 선택합니다.
2. **한국어** **편집**을 클릭합니다.
3. **활성**을 체크합니다.
4. **저장**을 클릭합니다.
5. **영어**에 대해서도 **1\~4번 단계를 반복**합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-7c945e3ec36e9168ea36134e50eebf50fa32af6c%2F%EB%B2%88%EC%97%AD_%ED%8E%B8%EC%A7%91.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-27ece776e44ba517260b75efa15bb172a20d7295%2F%EB%B2%88%EC%97%AD_%ED%99%9C%EC%84%B1.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 연결된 앱 설정

{% hint style="warning" %}
**버전 3.0부터는 외부 클라이언트 앱(External Client App, ECA)으로 전환되었습니다.**

버전 3.0 이상을 사용 중이신 경우 [외부 클라이언트 앱 (ECA) 설정](/ko/smallbuilder-line-items/start-with/eca-setup) 페이지를 참고해 주세요. 아래 내용은 버전 3.0 미만의 Connected App 환경에 해당합니다.
{% endhint %}

SmallBuilder Line Items의 **빌더 화면**에서 **버튼 생성 및 페이지 레이아웃에 버튼 추가 등** 메타데이터 관련 작업을 수행하려면 SmallBuilder Line Items에서 제공하는 연결된 앱에 대한 추가 설정이 필요합니다.

### Step 1: 허용된 사용자 설정

1. 설정에서 빠른 찾기 상자에 **연결된 앱**을 입력한 후 **연결된 앱 관리**를 선택합니다.
2. **SmallBuilder Line Items OAuth 편집**을 클릭합니다.
3. **허용된 사용자**를 **관리 승인 사용자가 미리 인증됨**으로 선택합니다.
4. **저장**을 클릭합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-d7cd55cab81732bffff19dd1be9f039f1abffdb5%2F%EC%97%B0%EA%B2%B0%EB%90%9C%EC%95%B1_%EA%B4%80%EB%A6%AC.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-99d61c218550db364c17f52ee261bb64940ae041%2F%EC%97%B0%EA%B2%B0%EB%90%9C%EC%95%B1_%ED%8E%B8%EC%A7%91.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### Step 2: 프로필 또는 권한 집합 할당

1. 설정에서 빠른 찾기 상자에 **연결된 앱**을 입력한 후 **연결된 앱 관리**를 선택합니다.
2. **SmallBuilder Line Items OAuth**을 클릭합니다.
3. 하단에 **프로필 관리** 또는 **권한 집합 관리**를 클릭합니다.
4. **빌더 설정을 담당하는 프로필 또는 권한 집합**을 선택합니다.
5. **저장**을 클릭합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-311636f2e432920005d0c06884e952ea12fce577%2F%EC%97%B0%EA%B2%B0%EB%90%9C%EC%95%B1_%EC%83%81%EC%84%B8.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-10331f02533d9fde88c1a40c586ce45b20193623%2F%EA%B6%8C%ED%95%9C%ED%95%A0%EB%8B%B9.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 외부 클라이언트 앱 (ECA) 설정

SmallBuilder Line Items의 **빌더 화면**에서 **버튼 생성 및 페이지 레이아웃에 버튼 추가 등** 메타데이터 관련 작업을 수행하려면 SmallBuilder Line Items에서 제공하는 외부 클라이언트 앱(External Client App)에 대한 추가 설정이 필요합니다.

### 설정 방법

1. 설정에서 빠른 찾기 상자에 외부 클라이언트 앱(External Client App)을 입력한 후 외부 클라이언트 앱 관리자(External Client App Manager)를 선택합니다.
2. **SmallBuilderLineItems**를 클릭합니다.
3. **편집**을 클릭합니다.
4. **OAuth 정책** 섹션에서 **허용된 사용자**를 **관리 승인 사용자가 사전 인가됨**으로 선택합니다.
5. **앱 정책** 섹션에서 **빌더 설정을 담당하는 프로필 또는 권한 집합**을 선택합니다.
6. **저장**을 클릭합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1d99989442e798ef35137ee55ab7d030bdf0de57%2F%EC%99%B8%EB%B6%80%ED%81%B4%EB%9D%BC%EC%9D%B4%EC%96%B8%ED%8A%B8%EC%95%B1_1.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-066d787a39acb41729b936a080bd18c445f22e45%2F%EC%99%B8%EB%B6%80%ED%81%B4%EB%9D%BC%EC%9D%B4%EC%96%B8%ED%8A%B8%EC%95%B1_2.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-cc6d3cf3ee5f5ad0ac112e9dd7261ff681959108%2F%EC%99%B8%EB%B6%80%ED%81%B4%EB%9D%BC%EC%9D%B4%EC%96%B8%ED%8A%B8%EC%95%B1_3.png?alt=media" alt=""><figcaption></figcaption></figure>


# 빌더

SmallBuilder Line Items는 빌더에서 시작됩니다. 빌더를 사용하여 맞춤형 라인 아이템 편집기를 구성하세요.

### 빌더 시작하기

<table data-header-hidden><thead><tr><th data-type="content-ref"></th><th></th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/builder/getting-stared-with-the-builder">빌더 시작하기</a></td><td>빌더 실행 방법과 빌더의 구성 요소에 대해 설명합니다.</td></tr></tbody></table>

### 라인 아이템 편집기 화면 설정하기

빌더 이름과 설명 등 기본 정보를 입력하여 라인 아이템 편집기 화면의 [기본 설정](/ko/smallbuilder-line-items/builder/default-setting)을 구성합니다.

<table data-header-hidden><thead><tr><th width="360" data-type="content-ref"></th><th></th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/builder/default-setting/device">장치에 맞게 반응형 화면 설정하기</a></td><td>데스크톱, 모바일에 따라 반응형 화면을 제공합니다.</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/default-setting/screen-rate">편집기 화면 비율 조절하기</a></td><td>화면 크기가 작은 경우, 라인 아이템 편집기가 한눈에 보기 어려울 수 있습니다. 이런 경우, 화면 비율 설정을 통해 편집기의 크기를 조절해 보세요.</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/default-setting/label-change">편집기 레이블 변경하기</a></td><td>편집기의 타이틀과 버튼 레이블을 원하는 레이블로 수정할 수 있습니다. 사용자 언어에 따라 번역이 필요한 경우,</td></tr></tbody></table>

### 개체 구성하기

빌더의 [개체 연결(Relate Objects)](https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/broken-reference/README.md) 단계에서 라인 아이템 편집기에서 사용할 개체들의 관계를 정의합니다.

<table data-header-hidden><thead><tr><th data-type="content-ref"></th><th></th></tr></thead><tbody><tr><td><a href="https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/broken-reference/README.md">https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/broken-reference/README.md</a></td><td>편집기의 상위 개체인 부모 개체를 설정합니다. 부모 개체는 라인 아이템 편집기의 기반이 되는 개체로, 해당 개체를 기준으로 편집기가 실행됩니다.</td></tr><tr><td><a href="https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/broken-reference/README.md">https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/broken-reference/README.md</a></td><td>라인 아이템 개체는 편집기에서 참조 데이터를 선택하고 추가 정보를 입력한 후 저장하는 역할을 합니다.</td></tr><tr><td><a href="https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/broken-reference/README.md">https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/broken-reference/README.md</a></td><td>조회 개체는 라인 아이템이 참조하는 개체로, 이 데이터를 기반으로 라인 아이템의 데이터를 편집 및 저장합니다.</td></tr></tbody></table>


# 빌더 셋업 절차

라인 아이템 편집기를 구현하기 위해서는 다음의 절차를 수행합니다.

{% stepper %}
{% step %}
**개체 연결하기**

빌더에서 설정해야 하는 가장 첫 번째 단계는 라인 아이템 편집기에서 사용할 개체들의 관계를 정의하는 것입니다. 이 관계는 반드시 Junction 관계 구조를 따라야 하며, **부모(Parent)**, **라인 아이템(Line Item)**, **조회(Lookup)** 개체를 설정해야 합니다.

[개체 연결 (Relate Objects) >](/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects)
{% endstep %}

{% step %}
**조회 선택기 설정**

라인 아이템을 등록하기 위해서는 먼저 제품과 같은 조회 개체를 검색하고 검색 결과 중 원하는 레코드를 선택하고 수량 등을 설정하여 라인 아이템을 등록합니다. 검색 설정은 조회 개체 검색 시 검색 결과 레이아웃을 설정하는 기능입니다.

[조회 선택기 설정 (Setup Lookup Selector) >](/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-lookup-selector)
{% endstep %}

{% step %}
**라인 아이템 편집기 설정**

라인 아이템 필드의 속성을 설정합니다. 앞서 선택 조회 레코드별로 가격, 할인율, 수량 등의 속성 필드를 정의합니다.

[라인 아이템 편집기 설정 (Setup Line Item Editor) >](/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor)
{% endstep %}

{% step %}
**미리보기**

빌더 설정을 완료한 후, 활성화하기 전에 반드시 미리보기를 통해 설정된 기능이 올바르게 작동하는지 확인하세요. 이를 통해 예상치 못한 오류나 불완전한 설정을 사전에 발견할 수 있습니다.
{% endstep %}

{% step %}
**빌더 활성화**

빌더 설정이 완료되면 활성화(Activate)를 진행합니다. 활성화를 통해 편집기 기능이 적용되며, 이후 편집기를 실행하는 버튼을 생성할 수 있습니다.
{% endstep %}

{% step %}
**버튼 생성하기**

설정을 완료한 후, 버튼을 생성하여 부모 개체의 페이지 레이아웃에 추가합니다. 버튼을 추가하면 사용자는 해당 버튼을 클릭하여 편집기를 실행할 수 있습니다.
{% endstep %}
{% endstepper %}


# 빌더 실행하기

### 빌더 실행하기

1. App Launcher( ![](https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fw3MtKmNbcCJqBL1WpQYC%2Fapp_launcher_icon.png?alt=media\&token=c94ecd0f-a34e-4df9-908b-6dabbc8b4acf) )에서 **SmallBuilder Line Items**를 찾아 이동합니다.
2. 라인 아이템 편집기 탭으로 이동 후 \[새로 만들기]를 눌러 빌더를 실행합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-7affc97c177437738c9d66b30a3808ab96b7acc8%2FApp%20%EA%B2%80%EC%83%89.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-2f2e17feba622065d110760b8ec5fd3d0f635747%2F%EB%B9%8C%EB%8D%94%20%EC%8B%A4%ED%96%89%20%EB%B0%A9%EB%B2%95.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### 빌더 구성

빌더의 상단에는 저장, 삭제 및 버튼 생성 등의 기능을 제공하는 버튼들이 있습니다. 왼쪽 사이드 패널에서는 빌더의 기본 설정을 관리하고 일부 레이블을 변경할 수 있으며, 오른쪽 패널에서는 단계별 설정 기능을 제공합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-9a919577b02422b85a439edd8f0db51a1e362633%2F%EB%B9%8C%EB%8D%94%20%EA%B5%AC%EC%84%B1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

1. 좌측 상단 타이틀 옆에 활성화 여부를 알 수 있으며 미리 보기, 버튼 추가, 저장 및 삭제 등 버튼이 모여있습니다.
   * **미리보기**\
     최종 저장된 빌더 설정 기반으로 구성기를 미리 볼 수 있습니다.
   * **버튼 추가**\
     활성화된 빌더 설정 기반으로 구성기의 버튼을 생성합니다. 지정한 부모 개체 기반으로 원하는 페이지 레이아웃에 버튼을 추가할 수 있습니다.
   * **활성화**\
     빌더를 구성기로 사용하기 위해 활성화를 반드시 해주어야 합니다. 비활성화 상태인 경우 구성기를 사용할 수 없습니다.
   * **저장**\
     빌더를 저장합니다.
   * **복제**\
     최종적으로 저장된 빌더 기반으로 복제합니다. 복제 버튼을 누른 후 '저장' 버튼을 눌러야 복제가 완료됩니다.
   * **초기화**\
     편집 과정에서 원래 설정으로 복구하고 싶은 경우, Reset 버튼을 누르면 최종적으로 저장된 설정으로 복구됩니다.
   * **도움말**\
     SmallBuilder Line Items의 헬프 문서로 이동합니다.
2. 설정 단계를 표시합니다. 단계는 3가지로 구성되어 있으며 각 설정을 누르면 <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FaPN5tyNh20xb5GIdIzrH%2Fimage.png?alt=media&amp;token=4a8821bb-a68f-46e2-9f47-1c461372e349" alt="" data-size="line">번 영역이 해당 패널로 전환이 됩니다.
   * **개체 연결**

     라인 아이템 편집기는 크게 부모, 조회, 라인 아이템으로 구성되어 있습니다. 이 단계에서는 부모, 조회, 라인 아이템에 어떠한 개체를 사용하지 지정합니다. 그리고 해당 구성들에 설정하려는 개체들은 서로 Junction 관계로 맺어져 있어야 하고 개체는 스탠다드, 커스텀 모두 지원합니다.
   * **조회 선택기 설정**\
     조회로 지정된 개체에 대하여 필드를 추가하고 라인 아이템 편집기 구성 시 컬럼 값 정렬 및 너비 등을 설정하는 단계입니다.
   * **라인 아이템 편집기 설정**\
     라인 아이템으로 지정된 개체에 대하여 필드를 추가하고 라인 아이템 편집기 구성 시 컬럼 값 정렬, 너비, 각 컬럼의 속성(숫자, 조회 필드 등)에 따른 고급 설정을 하는 단계입니다.\\
3. 빌더의 기본 설정을 하는 패널입니다. 빌더의 이름, 화면 비율, 장치에 따른 화면 UX 등을 설정합니다.
4. <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FMee5xyu8SCjmkBXU5WQa%2Fimage.png?alt=media&amp;token=db182ad9-4c21-44b4-8e2c-796376c75886" alt="" data-size="line">번의 단계에 따라 해당 설정 패널로 전환됩니다.


# 기본 설정

**빌더의 Side Panel에서 Line-item Configurator의 Name, Device 정보 등 기본 정보를 관리합니다.**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FHvXvw88gm8MbCL9MHLQx%2Fimage.png?alt=media&amp;token=38674501-292e-4d0d-bd56-1538a37ad62b" alt="" width="375"><figcaption></figcaption></figure>

### 설정

* [**기본 정보**](#undefined-1)

  Configurator의 이름, 설명 등 기본적인 설정을 합니다.
* [**Lookup Options**](#lookup-options)

  Lookup 검색 및 데이터 목록에 대한 기본적인 설정을 합니다.
* [**Line-Item Options**](#line-item-options)

  Line-Item 편집기에 대한 기본적인 설정을 합니다.

***

### 기본 정보

Configurator의 이름, 설명 등 기본적인 설정을 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FrHffm6VOIL0E3xwO9Xrm%2Fimage.png?alt=media&amp;token=1bbe920e-3021-4a60-964e-464708f1b5e5" alt="" width="293"><figcaption></figcaption></figure>

<table><thead><tr><th width="81">번호</th><th width="157">필드명</th><th width="355">설명</th><th>필수</th></tr></thead><tbody><tr><td>1</td><td>Name</td><td>Configurator의 이름을 지정합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>2</td><td>Device</td><td><p>데스크톱 또는 모바일용으로 화면을 구성할 수 있습니다.</p><ul><li>Responsive - 기기에 따라 화면이 자동으로 구성됩니다.</li><li>Desktop - 데스크톱에 맞춰진 화면으로 구성됩니다.</li><li>Mobile - 모바일에 맞춰진 화면으로 구성됩니다.</li></ul><p>기본값 : Responsive</p></td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>3</td><td>Description</td><td>Configurator에 대한 설명을 기재합니다.</td><td></td></tr><tr><td>4</td><td>Screen Ratio</td><td><p>Configurator 화면 크기에 대한 비율을 선택합니다.</p><p>화면에 보이는 Lookup 또는 Line-Item의 필드가 많을 때 비율을 낮춰 한눈에 보기 위함입니다.</p><ul><li>100%</li><li>90%</li><li>80%</li></ul><p>기본값 : 100%</p></td><td></td></tr></tbody></table>

{% hint style="info" %}
**Device에 따른 화면 구성**

* **Desktop**

  <div align="left"><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F2d7EXJzWI7vKBZO1uVuv%2Fimage.png?alt=media&amp;token=ee4bc08d-8103-483f-b77a-d99385f2e6d4" alt=""><figcaption><p>Lookup Selector</p></figcaption></figure></div>

  <div align="left"><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FJ7pG6H67sPxSIUqUSOgU%2Fimage.png?alt=media&amp;token=f88d7247-7693-400e-af83-957e3e20f786" alt=""><figcaption><p>Line-Item Editor</p></figcaption></figure></div>
* **Mobile**\
  모바일 화면에서는 데스크톱과 같은 필터를 제공하지 않습니다.

  <div align="left"><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F7A2xIIi3iMnFkjnOGhRZ%2Fimage.png?alt=media&amp;token=e151c0c5-76e5-42a7-a860-f6482c3445d7" alt="" width="375"><figcaption><p>Lookup Selector</p></figcaption></figure></div>

  <div align="left"><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FwIiqzyC6gioPVivgNpFN%2Fimage.png?alt=media&amp;token=25d9e39c-e5c4-4703-9014-776b080bae13" alt="" width="375"><figcaption><p>Line-Item Editor</p></figcaption></figure></div>

{% endhint %}

### Lookup Options

Lookup 검색 및 데이터 목록에 대한 기본적인 설정을 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FJYzfNVSb2MV0hh7FxeMI%2Fimage.png?alt=media&amp;token=a9c8331f-b481-4142-bb9f-2f0b105bf872" alt="" width="291"><figcaption></figcaption></figure>

<table><thead><tr><th width="79">번호</th><th width="241">필드명</th><th>설명</th></tr></thead><tbody><tr><td>1</td><td>List All Item</td><td><p>Lookup Selector 화면 로드 시 전체 검색이 되도록 활성화합니다.</p><p>기본값 : 활성화됨</p></td></tr><tr><td>2</td><td>Allow Select Duplicate Item</td><td>Lookup Selector에서 레코드를 중복으로 선택할 수 있도록 허용합니다.</td></tr><tr><td>3</td><td>Records By Page</td><td><p>한 페이지 당 표시할 레코드 수를 지정합니다.</p><p>기본값 : 50</p></td></tr></tbody></table>

### Line-Item Options

Line-Item 편집기에 대한 기본적인 설정을 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FL76yLpZZZsJsReCRtAOZ%2Fimage.png?alt=media&amp;token=ddcb257b-a88d-4129-a6e0-f6ec36105458" alt="" width="256"><figcaption></figcaption></figure>

<table><thead><tr><th width="92">번호</th><th width="180">필드명</th><th>설명</th></tr></thead><tbody><tr><td>1</td><td>View Summary</td><td>Line-Item Editor 화면 하단에 Summary로 지정된 필드들을 보여줍니다.</td></tr></tbody></table>

### **Field API Name Finder**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FWNRBozPR1kWmJSbcN97h%2Fimage.png?alt=media&amp;token=e27d56f3-cfa6-46c3-be82-25ef81ba4802" alt="" width="291"><figcaption></figcaption></figure>

<table><thead><tr><th width="92">번호</th><th width="180">필드명 및 영역</th><th>설명</th></tr></thead><tbody><tr><td>1</td><td>Relate Objects 정보</td><td>Parent, Lookup, Line-Item이 어떠한 개체로 지정되었는지 보여줍니다.</td></tr><tr><td>2</td><td>Target</td><td>어떠한 개체의 필드를 찾고 싶은지 선택합니다.</td></tr><tr><td>3</td><td>Select Field</td><td>찾으려는 필드를 선택합니다.</td></tr><tr><td>4</td><td>API Name</td><td>선택한 필드의 API Name이 보입니다.</td></tr></tbody></table>


# 1. 개체 연결

**Line-item Configurator를 구현하기 위해서는 먼저 Parent 개체, Line-item 개체, Lookup 개체를 지정합니다.**

{% hint style="info" %}
참고로 기회에서 제품 Line-item Configurator를 구현하는 경우 Parent Object는 기회 개체로 Line-item 개체는 기회 제품으로 설정하며 제품(Product)을 Lookup 개체로 설정합니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FFfASOhmy7vbqFTwWfzBj%2Fimage.png?alt=media&amp;token=5906231f-ff35-4463-a4c8-ab522e16245f" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="197">항목</th><th width="453">설명</th><th>필수</th></tr></thead><tbody><tr><td>Parent Object</td><td>기회, 견적, 출장 등 Line-item Configurator를 추가할 개체를 의미합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Line-item Object</td><td>기회 제품, 견적 행아이템, 출장 목적지 등 Parent Object의 자식 개체를 의미합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Lookup Object</td><td>제품, 거래처 등 Line-item이 참조하는 개체를 의미합니다.<br><br>💡 <strong>Tip</strong><br>Line-Item Editor만 사용하고 싶은 경우 <strong>Block adding items</strong>를 선택하시면 됩니다.<br>조건에 따라 제어하려면 바로 아래에 보이는 입력란에 Parent 필드의 API 명을 기재하면 됩니다. (필드값은 <code>true</code> 또는 <code>false</code>여야 합니다.)</td><td><mark style="color:red;">✔️</mark></td></tr></tbody></table>

### Line-item Object Advanced Setting

Line-Item Editor에서 저장된 레코드 불러올 시 정렬 지정 및 삭제 제어 등 설정합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FyKRKIIFZraua3I0nSLjI%2Fimage.png?alt=media&amp;token=6af9fce6-ae26-4e6b-b899-7cfe2f72d572" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="202">항목</th><th>설명</th></tr></thead><tbody><tr><td>Order By</td><td><p>저장된 Line-Item의 레코드를 불러올 시 정렬을 설정합니다.</p><p>SOQL의 <code>ORDER BY</code> 절을 기재합니다.<br><br>예를 들어 최근에 생성된 날짜(<em>필드: CreatedDate</em>) 순으로 내림차순 정렬하고 싶은 경우 <code>CreatedDate DESC</code>로 기재하면 됩니다.</p></td></tr><tr><td>Delete Controller Field</td><td>지정한 필드 값에 따라 Line-Item 레코드 삭제를 제어합니다. Line-Item 필드여야 하고, 해당 필드값은 <code>true</code> 또는 <code>false</code> 여야 합니다.<br><br>예를 들어 Parent 또는 Lookup의 상태 값에 따라 Line-Item 레코드 삭제를 제어하고 싶은 경우, Line-Item 개체에 Boolean형 수식 필드를 만들어 활용할 수 있습니다.</td></tr></tbody></table>

### Lookup Object Filter

Lookup Selector 검색 시 키워드 매칭 방법 및 필터 등 설정합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FFCNLZTqa9aB1eXB2S007%2Fimage.png?alt=media&amp;token=ea9cc4d1-74b8-4d9e-bfea-a684b8faf68f" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="205">항목</th><th width="445">설명</th><th>필수</th></tr></thead><tbody><tr><td>Keyword Field</td><td>Lookup 레코드 검색 키워드로 사용할 필드를 선택합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Match Condition</td><td><p>키워드 검색 방식을 선택합니다.</p><ul><li>Contains - 키워드가 포함된 값을 검색합니다.</li><li>Start with - 키워드로 시작하는 값을 검색합니다.</li></ul><p>기본값 : Contains</p></td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Order By</td><td><p>Lookup 검색 시 정렬을 설정합니다.</p><p>SOQL의 <code>ORDER BY</code> 절을 기재합니다.<br><br>예를 들어 제품 코드(<em>필드: ProductCode</em>) 순으로 오름차순 검색하고 싶은 경우 <code>ProductCode ASC</code>로 기재하면 됩니다.</p></td><td></td></tr><tr><td>Advanced Condition</td><td>검색 조건을 미리 지정합니다.<br>SOQL의 <code>WHERE</code> 절을 기재합니다.<br><br>예를 들어 활성화(<em>필드: IsActive</em>)된 레코드만 조회하고 싶은 경우<br><code>IsActive = true</code>로 기재하면 됩니다.<br><br>💡 <strong>Tip</strong><br>Parent의 필드값을 조건문에 지정하고 싶은 경우 <code>{$Parent.필드명}</code>를 이용해 바인딩할 수 있습니다.<br>예) Lookup Selector 검색 시 기준을 Parent의 통화와 일치한 레코드만 조회하고 싶은 경우 아래와 같이 작성합니다.<br><code>CurrencyIsoCode = {$Parent.CurrencyIsoCode}</code></td><td></td></tr></tbody></table>


# 2. 조회 선택기 설정

**Line-item을 등록하기 위해서는 먼저 제품과 같은 Lookup 개체를 검색하고 검색 결과 중 원하는 레코드를 선택하고 수량 등을 설정하여 Line-item을 등록합니다. 검색 설정은 Lookup 개체 검색 시 검색 결과 Layout을 설정하는 기능입니다.**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FFx8MLHtjZu045UADMtpO%2Fimage.png?alt=media&amp;token=c3d23392-ebc8-4e8e-9e39-81d5c319c37e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
기회를 예를 들면 기회 제품과 Lookup 관계인 제품을 검색하고 선택한 제품을 Line-item으로 등록합니다. 검색 설정에서는 Lookup 개체 검색 결과 layout을 설정합니다.
{% endhint %}

### 설정

* [**컬럼 설정**](#undefined-1)

  선택한 Lookup 개체의 모든 필드 중에서 검색 결과에 표시될 필드를 선택하고 각 필드의 Display 속성을 설정합니다.
* [**Virtual**](#virtual)

  데이터소스에서 가져온 데이터를 보여주기 위해 임시로 값을 담을 수 있는 가상의 컬럼을 생성합니다.
* [**Add data sources**](#add-data-sources)

  각 필드에 세일즈포스내 다른 개체 또는 외부 시스템의 데이터를 연동하고자 하는 경우 Data Source를 설정합니다.

***

### 컬럼 설정

선택한 Lookup 개체의 모든 필드 중에서 검색 결과에 표시될 필드를 선택하고 각 필드의 Display 속성을 설정합니다.

<table><thead><tr><th width="180">항목</th><th width="469">설명</th><th>필수</th></tr></thead><tbody><tr><td>Order</td><td>컬럼의 보이는 순서입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>API Name</td><td>대상 개체의 필드 API 이름입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Label</td><td>화면에 표시되는 컬럼의 라벨입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Width(px)</td><td>컬럼의 너비를 지정합니다. 단위는 픽셀(px)입니다.</td><td></td></tr><tr><td>Text Align</td><td><p>컬럼 값의 정렬을 지정합니다.</p><ul><li>Left - 왼쪽으로 정렬합니다.</li><li>Center - 가운데로 정렬합니다.</li><li>Right - 오른쪽으로 정렬합니다.</li></ul><p>기본값 : Left</p></td><td></td></tr><tr><td>Hidden</td><td>컬럼을 숨김 처리 합니다.</td><td></td></tr><tr><td>Image</td><td>컬럼이 이미지인 경우 체크합니다. 컬럼의 값은 이미지 URL이어야 합니다.</td><td></td></tr><tr><td>Image Width(px)</td><td>컬럼이 이미지인 경우 이미지의 너비를 지정합니다. 단위는 픽셀(px)입니다.</td><td></td></tr><tr><td>Image Height(px)</td><td>컬럼이 이미지인 경우 이미지의 높이를 지정합니다. 단위는 픽셀(px)입니다.</td><td></td></tr></tbody></table>

### Virtual

데이터소스에서 가져온 데이터를 보여주기 위해 임시로 값을 담을 수 있는 가상의 컬럼을 생성합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FnbakEhT3G74AdVlxY1Aq%2Fimage.png?alt=media&amp;token=1d394f60-d4b7-40fd-bdde-200ac570b3f6" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="99.33333333333331">번호</th><th width="544">설명</th><th>필수</th></tr></thead><tbody><tr><td>1</td><td><p>컬럼의 유형을 선택합니다.</p><ul><li>Text</li><li>Number</li><li>Currency</li></ul></td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>2</td><td>화면에 표시할 라벨을 입력합니다.</td><td><mark style="color:red;">✔️</mark></td></tr></tbody></table>

### Add data sources

각 필드에 세일즈포스내 다른 개체 또는 외부 시스템의 데이터를 연동하고자 하는 경우 Data Source를 설정합니다.

{% content-ref url="/pages/CXNKAKrz675bkNjaAa4O" %}
[데이터소스 설정](/ko/smallbuilder-line-items/builder/setup/datasource)
{% endcontent-ref %}


# 3. 라인 아이템 편집기 설정

**Line-item 필드의 속성을 설정합니다. 앞서 선택 Lookup 레코드별로 가격, 할인율, 수량 등의 속성 필드를 정의합니다.**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F7UFxe3f8CDCIWPlpd3Fb%2Fimage.png?alt=media&amp;token=23aff4b9-7267-4d2a-8491-9cb4722e1660" alt=""><figcaption></figcaption></figure>

### 설정

* [**컬럼 설정**](#undefined-1)

  Line-item 개체의 모든 필드 중에서 편집 시 사용할 필드를 선택하고 각 필드의 기본값 및 속성을 설정합니다.
* [**고급 설정**](#undefined-2)

  각 필드 유형에 따라 추가적인 속성을 설정합니다. 숫자 최솟값 및 최댓값, 계산 수식, 이미지 설정 등 제공합니다.
* [**Add data sources**](#add-data-sources)

  각 필드에 세일즈포스내 다른 개체 또는 외부 시스템의 데이터를 연동하고자 하는 경우 Data Source를 설정합니다.

***

### 컬럼 설정

Line-item 개체의 모든 필드 중에서 편집 시 사용할 필드를 선택하고 각 필드의 기본값 및 속성을 설정합니다.

<table><thead><tr><th width="201">항목</th><th width="449">설명</th><th>필수</th></tr></thead><tbody><tr><td>Order</td><td>컬럼의 보이는 순서입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>API Name</td><td>대상 개체의 필드 API 이름입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Label</td><td>화면에 표시되는 칼럼의 라벨입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Default Value</td><td>최초 레코드 추가 시 컬럼의 기본값을 설정합니다.</td><td></td></tr><tr><td>Source Field</td><td>최초 레코드 추가 시 Parent 또는 Lookup의 필드 값으로 미리 설정합니다.</td><td></td></tr><tr><td>Width (px)</td><td>컬럼의 너비를 지정합니다. 단위는 픽셀(px)입니다.</td><td></td></tr><tr><td>Text Align</td><td><p>컬럼 값의 정렬을 지정합니다.</p><ul><li>Left - 왼쪽으로 정렬합니다.</li><li>Center - 가운데로 정렬합니다.</li><li>Right - 오른쪽으로 정렬합니다.</li></ul><p>기본값 : Left</p></td><td></td></tr><tr><td>Read Only</td><td>컬럼을 읽기 전용으로 설정합니다.</td><td></td></tr><tr><td>Required</td><td>컬럼을 필수로 지정합니다.</td><td></td></tr><tr><td>Summary</td><td>컬럼의 값을 요약합니다. 요약한 값은 하단 우측에 표시됩니다.<br>(<a href="/ko/smallbuilder-line-items/builder/setup/basicinfo#line-item-options">View Summary</a>가 활성화 되어 있어야 합니다.)</td><td></td></tr><tr><td>Hidden</td><td>컬럼을 숨김 처리 합니다.</td><td></td></tr><tr><td>Don't Save</td><td>컬럼의 값을 저장하지 않습니다.</td><td></td></tr></tbody></table>

### 고급 설정

각 필드 유형에 따라 추가적인 속성을 설정합니다. 숫자 최솟값 및 최댓값, 계산 수식, 이미지 설정 등 제공합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Flev6Z0tjdl5sHs5czItU%2Fimage.png?alt=media&amp;token=489455f7-94f6-4829-ac3f-2bbdea9d2057" alt="" width="563"><figcaption></figcaption></figure>

<table data-full-width="false"><thead><tr><th width="209.33333333333331">Setting</th><th width="234">속성</th><th>설명</th></tr></thead><tbody><tr><td>Number</td><td>Min</td><td>컬럼의 유형이 숫자인 경우 최솟값을 설정합니다.</td></tr><tr><td></td><td>Max</td><td>컬럼의 유형이 숫자인 경우 최댓값을 설정합니다.</td></tr><tr><td>Calculation</td><td>Order</td><td>컬럼의 계산 순서를 지정합니다.</td></tr><tr><td></td><td>Operator</td><td>컬럼의 계산 식을 설정합니다.<br>각 컬럼의 값을 이용해 계산하는 경우 컬럼의 필드 API 이름으로 작성해야 합니다.</td></tr><tr><td>Discount Calcuration</td><td>Apply Discount Calculator</td><td>할인율 계산을 적용합니다.</td></tr><tr><td></td><td>Original Price Field</td><td>할인율을 계산하기 위한 대상 필드를 지정합니다.</td></tr><tr><td></td><td>Discount Rate Field</td><td>할인율을 저장할 필드를 지정합니다. (선택사항)</td></tr><tr><td></td><td>Rounding method</td><td><p>반올림 방식을 선택합니다.</p><ul><li>Round - 반올림 처리합니다.</li><li>Round Up - 올림 처리합니다.</li><li>Round Down - 내림 처리합니다.</li></ul></td></tr><tr><td></td><td>Level of Precision</td><td><p>반올림 처리 할 단위를 설정합니다.</p><ul><li>0.00 - 소수점 두 번째 자리까지 처리합니다.</li><li>0.0 - 소수점 첫 번째 자리까지 처리합니다.</li><li>0 - 소수점 없이 처리합니다.</li><li>10 - 10단위로 처리합니다.</li><li>100 - 100단위로 처리합니다.</li><li>1000 - 1000단위로 처리합니다.</li></ul></td></tr><tr><td>Image</td><td>Image</td><td>컬럼이 이미지인 경우 체크합니다. 컬럼의 값은 이미지 URL이어야 합니다.</td></tr><tr><td></td><td>Width</td><td>컬럼이 이미지인 경우 이미지의 넓이를 지정합니다. 단위는 픽셀(px)입니다.</td></tr><tr><td></td><td>Height</td><td>컬럼이 이미지인 경우 이미지의 높이를 지정합니다. 단위는 픽셀(px)입니다.</td></tr><tr><td>Reference</td><td>Keyword Field</td><td>조회 필드값 검색 시 키워드로 사용할 조회 개체의 필드를 지정합니다. 기본값은 Name 필드입니다.</td></tr><tr><td></td><td>Filter</td><td>컬럼이 조회 필드인 경우 필드값 조회 시 필터를 지정합니다.<br>SOQL의 <code>WHERE</code> 절을 기재합니다.</td></tr><tr><td>ETC</td><td>Read Only Controller Field</td><td>지정한 필드 값에 따라 해당 컬럼을 읽기 전용으로 제어합니다. Lookup 필드여야 하고, 해당 필드값은 <code>true</code> 또는 <code>false</code> 여야 합니다.</td></tr></tbody></table>

### Add data sources

각 필드에 세일즈포스 내 다른 개체 또는 외부 시스템의 데이터를 연동하고자 하는 경우 Data Source를 설정합니다.

{% content-ref url="/pages/CXNKAKrz675bkNjaAa4O" %}
[데이터소스 설정](/ko/smallbuilder-line-items/builder/setup/datasource)
{% endcontent-ref %}


# 데이터소스 설정

**Lookup 또는 Line-Item 데이터에 부가적으로 관련 개체나 외부 데이터를 표현해주고 싶을 때 사용됩니다.**

### Builder에서 데이터 소스 추가

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FjsuSWEnCdrARJNZfZGGN%2Fimage.png?alt=media&amp;token=4b59f11a-9cd1-4aaf-b8df-66b2231f2fda" alt=""><figcaption></figcaption></figure>

1. Lookup에 Data Source를 설정하는 경우: 검색 설정(Setup Lookup Selector) 단계로 이동합니다.\
   Line-Item의 Data Source를 설정하는 경우: 편집기 설정(Setup Line-Item Editor) 단계로 이동합니다.
2. Add data sources 버튼을 눌러 Data Source 편집 레이아웃을 열어줍니다.

{% hint style="warning" %}
Line-Item 편집기는 Evaluation Event를 필수로 설정해주어야 합니다.\
Evaluation Event는 아래와 같이 제공됩니다.

* On Initialization : Line-Item 레코드가 새로 추가되었을 때 실행됩니다.
* On Loading : Line-Item 화면이 로드될 때마다 실행됩니다.
* Before Save : Line-Item 레코드들이 저장되기 전 실행됩니다.

<img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FDcpiGR94hJTMA5tq5BFW%2Fimage.png?alt=media&amp;token=41bae25d-c432-4699-97d9-9aabf1b3fa45" alt="" data-size="original">
{% endhint %}

### 데이터소스 유형

### [Internal](/ko/smallbuilder-line-items/builder/setup/datasource/internal)

Salesforce 내 관련 개체를 조회하여 데이터를 같이 표현하고 싶을 때 사용됩니다.

예를 들어 Lookup이 Product2로 지정된 경우 PricebookEntry에 있는 단가를 같이 표시하고 싶을 때 내부 데이터소스를 이용해 조건에 맞는 PricebookEntry를 조회하여 제품과 단가를 같이 표현할 수 있습니다.

### [External](/ko/smallbuilder-line-items/builder/setup/datasource/external)

주로 외부 서버에서 데이터를 조회하여 같이 표현해주고 싶을 때 사용됩니다. 사용자가 작성한 Apex Class를 이용해 데이터소스를 가져오기 때문에 내부 데이터소스에 비해 자유롭게 데이터를 가져올 수 있는 장점이 있습니다.

예를 들어 외부 서버에서 실시간 재고를 가져와 화면에 같이 표시하고 싶은 경우 Apex Class에서 Rest API 코드를 작성하여 외부 데이터소스에 지정하면 Line-Item Configurator에서 해당 데이터를 보실 수 있습니다.


# 기본

**Salesforce 내 관련 개체를 조회하여 데이터를 같이 표현하고 싶을 때 사용됩니다.**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FLczqhReHXi1Q5HK9p0bX%2FDataSource%20-%20Internal%20(LineItem).png?alt=media&amp;token=0be1a6f8-a5f3-4d2f-9ec7-1819050b5fdd" alt=""><figcaption></figcaption></figure>

예를 들어 Lookup이 Product2로 지정된 경우 PricebookEntry에 있는 단가를 같이 표시하고 싶을 때 내부 데이터소스를 이용해 조건에 맞는 PricebookEntry를 조회하여 제품과 단가를 같이 표현할 수 있습니다.

* [**속성**](#undefined)

  Internal 데이터소스를 사용하기 위한 각 속성입니다.
* [**Action**](#action)

  Internal Data Source를 통해 가져온 데이터를 Lookup 또는 Line-Item에 매핑하기 위한 작업입니다.
* [**예시**](#undefined-1)

***

### 속성

Internal 데이터소스를 사용하기 위한 각 속성입니다.

<table><thead><tr><th width="192">항목</th><th width="605.3333333333333">설명</th><th>필수</th></tr></thead><tbody><tr><td>Source Object</td><td>Lookup 또는 Line-Item의 데이터와 매핑할 세일즈포스 내부 개체를 지정합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Query</td><td>Wizard 버튼을 눌러 Query 작성 레이아웃을 엽니다. Query Wizard를 이용해 조건문에 사용할 필드를 검색하여 쉽게 작성할 수 있습니다.</td><td></td></tr><tr><td>Active</td><td>Data Source를 사용하려면 활성화해야 합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Evaluation Event</td><td><p>Line-Item 편집기는 Evaluation Event를 필수로 설정해주어야 합니다.</p><ul><li>On Initialization : Line-Item 레코드가 새로 추가되었을 때 실행됩니다.</li><li>On Loading : Line-Item 화면이 로드될 때마다 실행됩니다.</li><li>Before Save : Line-Item 레코드들이 저장되기 전 실행됩니다.</li></ul></td><td></td></tr><tr><td><a href="#action"><strong>Actions</strong></a></td><td>Internal Data Source를 통해 가져온 데이터를 Lookup 또는 Line-Item에 매핑하기 위한 작업입니다.</td><td><mark style="color:red;">✔️</mark></td></tr></tbody></table>

### Action

Internal Data Source를 통해 가져온 데이터를 Lookup 또는 Line-Item에 매핑하기 위한 작업입니다.

<table><thead><tr><th width="183">항목</th><th width="466.33333333333326">설명</th><th>필수</th></tr></thead><tbody><tr><td>Action Order</td><td>매핑 순서를 지정합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Source Field</td><td>Internal Data Source 개체에서 매핑할 필드를 지정합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Target Field</td><td>Lookup 또는 Line-Item 개체에 매핑할 필드를 지정합니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Key</td><td><p>Lookup 또는 Line-Item과 데이터소스 간 데이터 매칭 시 사용할 Action을 지정합니다.</p><p>예를 들어 Lookup이 Product2로 지정되어 있고 데이터소스로 PricebookEntry를 가져오는 경우 PricebookEntry의 Product2Id(Source Field)와 Product2의 Id 필드(Target Field)로 데이터를 결합하여 표현합니다.</p></td><td><mark style="color:red;">✔️</mark></td></tr></tbody></table>

### 예시

Lookup Selector 개체를 Product로 지정하여 제품 목록을 검색하려고 합니다. 해당 목록에 PricebookEntry 개체에 있는 단가를 함께 표시하려고 합니다.

1. 데이터소스에서 Source Object를 PricebookEntry로 지정합니다.
2. (선택) Query Wizard를 눌러 데이터 조회 조건을 작성합니다. (SOQL `Where`문과 동일)
3. Product에 맞는 PricebookEntry 데이터를 결합하기 위해 아래와 같이 설정합니다.
   * Source Field : Product2Id
   * Target Field : Id
   * Key : true
4. 단가를 Product 데이터와 같이 표시하기 위해 Action을 추가하여 Lookup Column을 지정합니다.
   * Source Field : UnitPrice
   * Target Field : SBLDVirtual1 ([Lookup Virtual Column 참고](/ko/smallbuilder-line-items/builder/setup/setup-lookup-selector#virtual-column))

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fy42Eb3vBwQdZSCx1sZxn%2Fimage.png?alt=media&amp;token=0e29ed48-8342-40e3-86b2-b4573863a4f5" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FusYuuLH3Z8WaIZ5HroCt%2Fimage.png?alt=media&amp;token=3d9846cb-c445-45d6-9641-6ac0ebaff938" alt=""><figcaption></figcaption></figure>


# 고급

**주로 외부 서버에서 데이터를 조회하여 같이 표현해주고 싶을 때 사용됩니다. 사용자가 작성한 Apex Class를 이용해 데이터소스를 가져오기 때문에 내부 데이터소스에 비해 자유롭게 데이터를 가져올 수 있는 장점이 있습니다.**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FC2iCYVpTQU1Z5zcAgGcE%2FLineItemExternal.png?alt=media&amp;token=f1336534-50d5-467c-8823-28b29c54d568" alt=""><figcaption></figcaption></figure>

예를 들어 외부 서버에서 실시간 재고를 가져와 화면에 같이 표시하고 싶은 경우 Apex Class에서 Rest API 코드를 작성하여 외부 데이터소스에 지정하면 Line-Item Configurator에서 해당 데이터를 보실 수 있습니다.

* [**속성**](#undefined)

  External 데이터소스를 사용하기 위한 각 속성입니다.
* [**Apex Class 작성**](#apex-class)

  External 데이터소스를 사용하기 전 Apex Class를 먼저 작성해야 합니다. Package에서 제공하는 `SBLD.DataSourceService.Fetchable` 인터페이스를 작성하려는 Apex Class에 `implements` 하여 구현합니다.
* [**예시**](#undefined-1)

  준비중입니다.

***

### 속성

External 데이터소스를 사용하기 위한 각 속성입니다.

<table><thead><tr><th width="261">항목</th><th width="388">설명</th><th>필수</th></tr></thead><tbody><tr><td>Apex Class Name</td><td>외부데이터를 가져올 때 사용하는 클래스의 이름입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Key Field</td><td>DataSource를 통해 가져온 데이터를 매핑시키기 위한 field API 이름을 나타냅니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Parent Field Parameters</td><td>DataSource의 Type이 External일 경우 Parent Object의 Field 중 Parameter로 넘겨줄 Field를 나타냅니다.</td><td></td></tr><tr><td>Lookup Field Parameters</td><td>DataSource의 Type이 External일 경우 Lookup Object의 Field 중 Parameter로 넘겨줄 Field를 나타냅니다.</td><td></td></tr><tr><td>Active</td><td>DataSource의 활성, 비활성 여부입니다.</td><td><mark style="color:red;">✔️</mark></td></tr></tbody></table>

### Apex Class 작성

External 데이터소스를 사용하기 전 Apex Class를 먼저 작성해야 합니다. Package에서 제공하는 `SBLD.DataSourceService.Fetchable` 인터페이스를 작성하려는 Apex Class에 `implements` 하여 구현합니다.

`SBLD.DataSourceService.Fetchable` 클래스를 `implements` 하여 `execute()` 메서드를 구현합니다.

{% code title="DataSourceServiceMock.cls" lineNumbers="true" %}

```apex
global with sharing class DataSourceServiceMock implements SBLD.DataSourceService.Fetchable {
    /***
     * @description SBLD.DataSourceService.Fetchable execute() 정의
     * @param param SBLD.DataSourceService.Parameter형 파라미터
     *              DataSource에서 설정한 
     * @return Map<Object, SObject>
     ****/
    global SBLD.DataSourceService.Result execute(SBLD.DataSourceService.Parameter param) {
        SBLD.DataSourceService.Result result = new SBLD.DataSourceService.Result();
        /**
         *  @method DataSourceService.Parameter gets()
         *  @param  String 형 Parent, Lookup 중 선택 (대소문자 구분 없음)
         *  @return List<SObject>
         **/
        SObject parentRecord = null;
        List<SObject> lookupRecords = new List<SObject>();
        // Parent 관련 파라미터를 가져옵니다.
        if(param.gets('parent')<>null && !param.gets('parent').isEmpty()) {
            parentRecord = param.gets('parent')[0];
        }
        // Lookup 관련 파라미터를 가져옵니다.
        if(param.gets('lookup')<>null && !param.gets('lookup').isEmpty()) {
            listLookupParameters = param.gets('lookup');
        }
        /**
         * 성공 시, External 결과값을 설정합니다.
         **/
        for(SObject sobj : lookupRecords) {
            /**
             * Internal의 Action과 동일하게 DataSource의 값을 
             * Lookup 또는 Line-Item 필드에 매핑하는 작업을 
             **/
            SBLD.DataSourceServiceAction action = new SBLD.DataSourceServiceAction();
            // 1. External에 설정한 External Key 값
            action.setKeyValue(sobj.get('Id')); // Product Code
            // 2. External에서 가져온 값을 Lookup 또는 Junction 필드에 매핑합니다.
            Map<String, Object> mapPopulatedField = sobj.getPopulatedFieldsAsMap();
            for(String fieldName : mapPopulatedField.keySet()) {
                action.putSourceToTargetField(mapPopulatedField.get(fieldName), fieldName);
            }
            // 3. DataSourceService.Result에 Action을 추가합니다.
            result.addAction(action);
        }
        return result;
    }
}
```

{% endcode %}

`SBLD.DataSourceService.Parameter`에서 `gets()` 메서드를 통해 Line-Item Configurator의 Parent 또는 Lookup 정보를 가져올 수 있습니다.

{% code lineNumbers="true" %}

```apex
global SBLD.DataSourceService.Result execute(SBLD.DataSourceService.Parameter param) {
    SObject parentRecord = null;
    List<SObject> lookupRecords = new List<SObject>();
    // Parent 관련 파라미터를 가져옵니다.
    if(param.gets('parent')<>null && !param.gets('parent').isEmpty()) {
        parentRecord = param.gets('parent')[0];
    }
    // Lookup 관련 파라미터를 가져옵니다.
    if(param.gets('lookup')<>null && !param.gets('lookup').isEmpty()) {
        listLookupParameters = param.gets('lookup');
    }
    ...
}
```

{% endcode %}

Line-Item Configurator로 결과값을 전달하기 위해 아래 클래스를 이용합니다.

### **SBLD.DataSourceServiceAction Class**

대상(Lookup 또는 Line-Item)의 행마다 Action을 지정합니다. Action은 데이터소스 값을 Lookup 또는 Line-Item 필드에 매핑하는 작업입니다.

* **setKeyValue(Object keyValue)**\
  Lookup 또는 Line-Item의 대상 레코드를 찾기 위한 Key값을 설정합니다.
* **putSourceToTargetField(Object sourceValue, String targetField)**\
  데이터소스 값을 Lookup 또는 Line-Item 필드에 할당합니다.

### **SBLD.DataSourceService.Result Class**

매핑이 완료된 Action을 리턴 값에 추가하는 작업입니다.

* **addAction(SBLD.DataSourceServiceAction action)**\
  SBLD.DataSourceService.Result 인스턴스에 Action을 추가합니다.

{% code lineNumbers="true" %}

```apex
...
SBLD.DataSourceService.Result result = new SBLD.DataSourceService.Result();
for(Object objResponse : listResponses) {
    Map<String, Object> mapResponse = (Map<String, Object>)objResponse;

    SBLD.DataSourceServiceAction action = new SBLD.DataSourceServiceAction();
    // 데이터소스에서 설정한 Key 필드에 알맞는 값
    action.setKeyValue(mapResponse.get('Id')); // Product Code
    // 데이터소스에서 가져온 값을 Lookup 또는 Line-Item 필드에 넣기
    action.putSourceToTargetField(mapResponse.get('inventory'), 'Inventory__c');
    // SBLD.DataSourceService.Result에 Action을 추가한다.
    result.addAction(action);
}
return result;
```

{% endcode %}

### 예시

준비중입니다.


# 적용

**셋업이 완료되면 저장 후 빌더상단의 Active 기능 Configuration이 활성화되어야 실제 사용할 준비가 완료됩니다.**

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fcgn2zN6Rm0kkJeumwrkC%2Fimage.png?alt=media&amp;token=97110c41-fff6-4cdd-ae8d-2dc924087a8d" alt=""><figcaption></figcaption></figure>

### Preview

빌더 상단의 Preview 기능을 활용하며 구현된 Line-item configurator를 실행하여 볼 수 있습니다.

### Add Button

빌더 상담의 Add Button 기능을 활용하여 구현된 Line-Item Configurator를 원 클릭으로 Parent 개체의 Page Layout에 추가할 수 있습니다.

### Component 직접 생성

버튼 이외에 다른 곳에서 Line-Item Configurator를 호출하고 싶은 경우 아래와 같이 `<SBLD:LineItemConfigurator />`를 삽입해주면 됩니다.

{% hint style="warning" %}
현재는 Aura Component만 제공됩니다.
{% endhint %}

```html
<aura:component implements="force:lightningQuickActionWithoutHeader,force:hasRecordId" >   
    <SBLD:LineItemConfigurator 
        recordId="{!v.recordId}" 
        builderId="XXX..." />
</aura:component>
```

#### **Attributes**

<table><thead><tr><th width="131">항목</th><th width="496.33333333333326">설명</th><th>필수</th></tr></thead><tbody><tr><td>recordId</td><td>Line-Item Configurator에서 설정한 Parent의 레코드 ID 입니다.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>builderId</td><td>Line-Item Configurator의 레코드 ID 입니다.</td><td><mark style="color:red;">✔️</mark></td></tr></tbody></table>


# 빌더 시작하기

### 빌더 실행하기

1. App Launcher( ![](https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fw3MtKmNbcCJqBL1WpQYC%2Fapp_launcher_icon.png?alt=media\&token=c94ecd0f-a34e-4df9-908b-6dabbc8b4acf) )에서 **SmallBuilder Line Items**를 찾아 이동합니다.
2. **라인 아이템 편집기 탭**으로 이동 후 **새로 만들기**를 눌러 빌더를 실행합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-d8b3cd0cc6cdf9f20857f2b57af53ccb66ee5732%2F%EC%95%B1%EA%B2%80%EC%83%89.jpg?alt=media" alt=""><figcaption><p>1. SmallBuilder Line Items 앱 이동</p></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-90d941239dbcbbef6da29d69410f7b7b24240fbd%2F%EB%B9%8C%EB%8D%94_%ED%83%AD%EC%9D%B4%EB%8F%99.jpg?alt=media" alt=""><figcaption><p>2. 라인 아이템 편집기 탭으로 이동</p></figcaption></figure>

### 빌더 레이아웃

빌더의 상단에는 저장, 삭제 및 버튼 생성 등의 기능을 제공하는 버튼들이 있습니다. 왼쪽 사이드 패널에서는 빌더의 기본 설정을 관리하고 일부 레이블을 변경할 수 있으며, 오른쪽 패널에서는 단계별 설정 기능을 제공합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-f5458351b11c9959cdcf1d8887dda6084817469e%2F%EB%B9%8C%EB%8D%94_%EA%B5%AC%EC%84%B1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="70"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td><p>좌측 상단 타이틀 옆에 활성화 여부를 알 수 있으며 미리 보기, 버튼 추가, 저장 및 삭제 등 버튼이 모여있습니다.</p><ul><li><strong>버튼 추가:</strong> 활성화된 빌더 설정 기반으로 구성기의 버튼을 생성합니다. 지정한 부모 개체 기반으로 원하는 페이지 레이아웃에 버튼을 추가할 수 있습니다.</li><li><strong>활성화:</strong> 빌더를 구성기로 사용하기 위해 활성화를 반드시 해주어야 합니다. 비활성화 상태인 경우 구성기를 사용할 수 없습니다.</li><li><strong>저장:</strong> 빌더를 저장합니다.</li><li><strong>복제:</strong> 최종적으로 저장된 빌더 기반으로 복제합니다. 복제 버튼을 누른 후 '저장' 버튼을 눌러야 복제가 완료됩니다.</li><li><strong>초기화:</strong> 편집 과정에서 원래 설정으로 복구하고 싶은 경우, Reset 버튼을 누르면 최종적으로 저장된 설정으로 복구됩니다.</li><li><strong>도움말:</strong> SmallBuilder Line Items의 헬프 문서로 이동합니다.</li></ul></td></tr><tr><td><strong>2</strong></td><td><p>설정 단계를 표시합니다. 단계는 3가지로 구성되어 있으며 각 설정을 누르면 <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FaPN5tyNh20xb5GIdIzrH%2Fimage.png?alt=media&amp;token=4a8821bb-a68f-46e2-9f47-1c461372e349" alt="" data-size="line">번 영역이 해당 패널로 전환이 됩니다.</p><ul><li><strong>개체 연결:</strong> 라인 아이템 편집기는 크게 부모, 조회, 라인 아이템으로 구성되어 있습니다. 이 단계에서는 부모, 조회, 라인 아이템에 어떠한 개체를 사용하지 지정합니다. 그리고 해당 구성들에 설정하려는 개체들은 서로 Junction 관계로 맺어져 있어야 하고 개체는 스탠다드, 커스텀 모두 지원합니다.</li><li><strong>조회 선택기 설정:</strong> 조회로 지정된 개체에 대하여 필드를 추가하고 라인 아이템 편집기 구성 시 컬럼 값 정렬 및 너비 등을 설정하는 단계입니다.</li><li><strong>라인 아이템 편집기 설정:</strong> 라인 아이템으로 지정된 개체에 대하여 필드를 추가하고 라인 아이템 편집기 구성 시 컬럼 값 정렬, 너비, 각 컬럼의 속성(숫자, 조회 필드 등)에 따른 고급 설정을 하는 단계입니다.</li></ul></td></tr><tr><td><strong>3</strong></td><td>빌더의 기본 설정을 하는 패널입니다. 빌더의 이름, 화면 비율, 장치에 따른 화면 UX 등을 설정합니다.</td></tr><tr><td><strong>4</strong></td><td><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FMee5xyu8SCjmkBXU5WQa%2Fimage.png?alt=media&amp;token=db182ad9-4c21-44b4-8e2c-796376c75886" alt="" data-size="line">번의 단계에 따라 해당 설정 패널로 전환됩니다.</td></tr></tbody></table>


# 기본 설정 (Default Setting)

빌더 이름, 설명 등 가장 기본적인 설정과 함께, 조회 선택기에서 데이터를 바로 보여줄지 여부, 라인 아이템 편집기에서 요약을 표시할지 여부 등 기본적인 기능 설정을 수행합니다.

이러한 기본 설정들은 빌더의 **사이드 패널에서 설정**합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-630efefe1dccd236c5bc2ba4c13be17b06f16133%2F%EC%82%AC%EC%9D%B4%EB%93%9C%ED%8C%A8%EB%84%90.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### 사이드 패널에서 제공하는 설정

#### 기본 설정

#### [디바이스에 맞게 반응형 UI 설정](/ko/smallbuilder-line-items/builder/default-setting/device)

디바이스 유형(데스크톱, 태블릿, 모바일)에 따라 반응형 UI를 제공합니다. 디스플레이 환경에 맞춰 편집기의 크기와 구성을 조정하여 최적의 사용자 경험을 제공합니다. 데스크톱에서는 더 많은 정보를 표시하고, 모바일에서는 간소화된 UI를 제공하고 있습니다.

모든 디바이스에서 간소화된 UI로 보이기를 원한다면, 장치를 모바일로 설정하세요. 이를 통해 디바이스 상관 없이 간단하고 일관된 UI를 제공합니다.

#### [화면 비율 조정](/ko/smallbuilder-line-items/builder/default-setting/screen-rate)

사이드 패널에서는 아래와 같은 기능을 설정을 제공합니다:

편집기의 크기 비율을 조절할 수 있습니다. 예를 들어, 디스플레이가 작은 경우 UI가 화면을 가득 차지하여 불편함을 줄 수 있습니다. 이런 경우, 화면 비율을 낮게 설정하여 편집기 UI의 크기를 줄여보세요.

#### [조회 선택기 관련 설정](/ko/smallbuilder-line-items/builder/default-setting/lookup-option)

조회 선택기와 관련된 설정입니다. 레코드 선택 방식 및 검색 기능을 구성할 수 있습니다.

#### [라인 아이템 편집기 관련 설정](/ko/smallbuilder-line-items/builder/default-setting/lline-item-editor-settings)

라인 아이템 편집기와 관련된 설정입니다. 하단에 요약을 표시하거나 첫 번째 열을 고정하는 기능을 설정할 수 있습니다.

***

#### 레이블 설정

#### [편집기 타이틀 및 버튼 레이블 설정](/ko/smallbuilder-line-items/builder/default-setting/label-change)

편집기 화면의 타이틀과 일부 버튼 레이블을 변경할 수 있습니다. 필요에 따라 커스텀 라벨을 삽입하면 사용자 언어에 맞게 자동으로 번역이 적용되어 다양한 언어 환경에서 사용성을 향상시킬 수 있습니다.


# 장치에 맞게 반응형 화면 설정하기

디바이스 유형(데스크톱, 모바일)에 따라 반응형 화면을 제공합니다. 디스플레이 환경에 맞춰 편집기의 크기와 구성을 조정하여 최적의 사용자 경험을 제공합니다. 데스크톱에서는 더 많은 정보를 표시하고, 모바일에서는 간소화된 화면을 제공하고 있습니다.

모든 디바이스에서 간소화된 화면으로 보이기를 원한다면, 장치를 모바일로 설정하세요. 이를 통해 디바이스 상관 없이 간단하고 일관된 화면을 제공합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-03936c928b2f9eff0b3612675688d802c6b213e9%2F%EC%9E%A5%EC%B9%98_%EC%84%A4%EC%A0%95.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="168"></th><th></th></tr></thead><tbody><tr><td><strong>반응형</strong></td><td>디바이스 환경에 맞춰 자동으로 최적화된 화면을 제공합니다.</td></tr><tr><td><strong>데스크톱</strong></td><td>디바이스에 상관없이 데스크톱 모드의 화면으로 고정됩니다.</td></tr><tr><td><strong>모바일</strong></td><td>디바이스에 상관없이 모바일 모드의 화면으로 고정됩니다.</td></tr></tbody></table>

{% hint style="warning" %}
모바일 화면에서는 아래와 같은 일부 기능이 지원되지 않습니다:

* 조회 선택기에서 필터하는 기능
* 제품 옵션 기능
* 라인 아이템 편집기에서 다중 삭제 기능
  {% endhint %}

### 데스크톱 화면

<div><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FQNYGKxWXr7e0CCs9lpd7%2FDesktop%20-%20Lookup%20Selector.png?alt=media&amp;token=19b32ae3-8015-4a70-a8b9-b4b7f8660d80" alt=""><figcaption><p>조회 선택기</p></figcaption></figure> <figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FOHFZfs4YtNoNE4QkqDpo%2FDesktop%20-%20Line%20Item%20Editor.png?alt=media&amp;token=d73f7b6a-18ce-4adb-8cc6-562c094db459" alt=""><figcaption><p>라인 아이템 편집기</p></figcaption></figure></div>

### 모바일 화면

<div><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FsQhcUcrMJCSWuyrGt35S%2FMobile%20-%20Lookup%20Selector.png?alt=media&amp;token=d7a1bd4d-7ad8-4ba6-acd7-f0dee2a6d925" alt="" width="563"><figcaption><p>조회 선택기</p></figcaption></figure> <figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FBvMFD5sYf3D8q8l1L9wy%2FMobile%20-%20Line%20Item%20Editor.png?alt=media&amp;token=e093ca62-a093-4be5-9b69-d796d55ba75a" alt="" width="563"><figcaption><p>라인 아이템 편집기</p></figcaption></figure></div>


# 편집기 화면 비율 조절하기

화면 비율은 100%, 90%, 80%를 지원하며, 기본값은 100%로 설정되어 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a91953baa4fd731d574b288b4079978da76b2fdb%2F%ED%99%94%EB%A9%B4%EB%B9%84%EC%9C%A8_%EC%84%A4%EC%A0%95.jpg?alt=media" alt=""><figcaption><p>사이드 패널에서 기본 설정 메뉴 화면입니다.</p></figcaption></figure>

#### 화면 비율을 100% 설정했을 때

일반적인 편집기 화면이 표시됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1a66f613f82024b6f9a34e455119665ddb72c9a3%2F%ED%99%94%EB%A9%B4%EB%B9%84%EC%9C%A8_100.jpg?alt=media" alt=""><figcaption><p>화면 비율 100%</p></figcaption></figure>

#### 화면 비율을 80% 설정했을 때

편집기에 표시되는 열이 많은 경우, 화면 비율을 낮추면 한 화면에서 더 많은 열을 확인할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-554b2cb4f844510209bbb06ad777acb416cf26e4%2F%ED%99%94%EB%A9%B4%EB%B9%84%EC%9C%A8_80.jpg?alt=media" alt=""><figcaption><p>화면 비율 80%</p></figcaption></figure>


# 편집기 레이블 변경하기

**편집기 실행 시** 조회 선택기와 라인 아이템 편집기의 **타이틀**을 사용자가 원하는 레이블로 변경할 수 있습니다.

예를 들어, 동일한 개체에 대해 여러 편집기를 사용하더라도, 편집기의 용도에 따라 **타이틀을 다르게 표시**하고 싶다면 레이블을 수정할 수 있습니다. 또한, 라인 아이템 편집기에서 **조회 선택기로 이동하는 버튼 레이블**도 변경 가능합니다.

해당 레이블 변경은 **사이드 패널**에서 **레이블 메뉴**를 클릭하여 간단히 설정할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-8baa3e3a262ba8912df00c660c210ce569a777b0%2F%EB%A0%88%EC%9D%B4%EB%B8%94_%EB%A9%94%EB%89%B4%20(1).jpg?alt=media" alt=""><figcaption></figcaption></figure>

### 타이틀 변경하기

조회 선택기와 라인 아이템 편집기의 각각의 **타이틀 레이블**을 변경할 수 있습니다. 또한, **입력 란 옆의 아이콘(** <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-3a6c153b1baefbe32266d4338931d6cc652311a7%2F%EC%BB%A4%EC%8A%A4%ED%85%80%EB%9D%BC%EB%B2%A8_%EC%95%84%EC%9D%B4%EC%BD%98.jpg?alt=media" alt="" data-size="line"> **)**&#xC744; 클릭하여 [커스텀 라벨을 삽입](/ko/smallbuilder-line-items/builder/inserting-custom-labels)하면, 사용자의 언어 설정에 따라 번역된 레이블이 표시되도록 설정할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-64c40abc5ac59d6cfaf83f8e17005a1525b6ba28%2F%EC%A1%B0%ED%9A%8C_%ED%83%80%EC%9D%B4%ED%8B%80.jpg?alt=media" alt=""><figcaption><p>조회 선택기 타이틀</p></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-cab74a2fca1146c03f0b0e19b9287a971d4184e2%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C_%ED%83%80%EC%9D%B4%ED%8B%80.jpg?alt=media" alt=""><figcaption><p>라인 아이템 편집기 타이틀</p></figcaption></figure>

### 버튼 레이블 변경하기

라인 아이템 편집기에서 조회 선택기로 이동하는 버튼 레이블도 변경할 수 있습니다. 타이틀과 마찬가지로 우측 아이콘 버튼( <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-3a6c153b1baefbe32266d4338931d6cc652311a7%2F%EC%BB%A4%EC%8A%A4%ED%85%80%EB%9D%BC%EB%B2%A8_%EC%95%84%EC%9D%B4%EC%BD%98.jpg?alt=media" alt="" data-size="line"> )을 클릭하여 커스텀 라벨을 삽입하면, 사용자의 언어 설정에 따라 번역된 레이블을 표시할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-82fa492f046bfe03d3f5b87a7dc0c7c0e618accd%2F%EB%B2%84%ED%8A%BC_%EB%A0%88%EC%9D%B4%EB%B8%94.jpg?alt=media" alt=""><figcaption><p>라인 아이템 편집기 화면에서 버튼 레이블 변경하기</p></figcaption></figure>

### 커스텀 라벨 적용하기

커스텀 라벨 적용 예시를 확인하고 싶은 경우, [레이블에 커스텀 라벨 삽입하기](/ko/smallbuilder-line-items/builder/inserting-custom-labels) 메뉴를 참고하세요. 이 메뉴에서는 커스텀 라벨을 사용하는 구체적인 방법과 예시를 제공합니다.


# 조회 선택기 설정

조회 선택기와 관련된 설정입니다. 레코드 선택 방식 및 검색 기능을 구성할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-3292f4b50e0f7673353145080aa12b810a869516%2F%EC%A1%B0%ED%9A%8C%EA%B8%B0%EB%B3%B8%EC%98%B5%EC%85%98_%EA%B0%9C%EC%9A%94.png?alt=media" alt=""><figcaption></figcaption></figure>

* [**로드 시 전체 검색**](/ko/smallbuilder-line-items/builder/default-setting/lookup-option/search-all-on-load)\
  조회 선택기 화면 로드 시, 데이터가 자동으로 조회되도록 설정됩니다. 이 설정은 기본적으로 활성화되어 있습니다.
* [**필터 기본 펼치기**](/ko/smallbuilder-line-items/builder/default-setting/lookup-option/expand-filters-by-default)\
  필터 검색을 기본으로 펼쳐 표시합니다. 필터를 자주 사용하는 경우, 이 기능을 활성화하세요.
* [**중복 선택 허용**](/ko/smallbuilder-line-items/builder/default-setting/lookup-option/allow-select-duplicate-item)\
  동일한 레코드를 여러 개 중복 선택할 수 있도록 허용합니다.
* [**성능 향상을 위한 캐싱**](/ko/smallbuilder-line-items/builder/default-setting/lookup-option/caching-to-improve-performance)\
  캐싱을 통해 데이터를 빠르게 조회하고 안정적인 환경을 제공합니다. 다만, 데이터에 변경 사항이 있는 경우 최신 상태로 조회되지 않을 수 있습니다.
* [**페이지별 레코드 수**](/ko/smallbuilder-line-items/builder/default-setting/lookup-option/records-per-page)\
  한 페이지(스크롤)에 표시할 레코드 수를 지정합니다. 기본 설정은 페이지(스크롤)당 50개입니다.


# 로드 시 전체 검색

조회 선택기 화면 로드 시, 데이터가 자동으로 조회되도록 설정됩니다. 이 설정은 기본적으로 활성화되어 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-7faba4c53f20bc18a1a4c49e84779dabb2b23648%2F%EB%A1%9C%EB%93%9C%EC%8B%9C%EC%A0%84%EC%B2%B4%EA%B2%80%EC%83%89%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 예시: 로드 시 전체 검색이 비활성화된 경우

로드 시 데이터가 자동으로 조회되지 않으며, **키워드 검색을 통해서만 데이터를 조회**할 수 있습니다. 이는 데이터 조회가 느리거나, 데이터소스 고급 설정에 복잡한 작업 또는 시간이 오래 걸리는 작업이 포함된 경우 해당 기능을 비활성화합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-fa6470bd966be793683c8bef13827d3a75bb9366%2F%EC%A0%84%EC%B2%B4%EA%B2%80%EC%83%89%EB%B9%84%ED%99%9C%EC%84%B1%ED%99%94.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 필터 기본 펼치기

필터 검색을 기본으로 펼쳐 표시합니다. 필터를 자주 사용하는 경우, 이 기능을 활성화하세요.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-6458cbf5f214a5221c57a7c754bae7f2fe4985a1%2F%ED%95%84%ED%84%B0%EA%B8%B0%EB%B3%B8%ED%8E%BC%EC%B9%98%EA%B8%B0%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 예시: 필터 기본 펼치기가 활성화된 경우

조회 선택기 로드 시, 필터 검색 레이아웃이 기본으로 펼쳐져 표시됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-de7f14404f96f091495465236b2319a29ed1a591%2F%ED%95%84%ED%84%B0%EA%B8%B0%EB%B3%B8%ED%8E%BC%EC%B9%98%EA%B8%B0_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>


# 레코드 중복 선택 허용

동일한 레코드를 여러 개 중복 선택할 수 있도록 허용합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a0d097c841c9cebe6726866900ed70e62db24b28%2F%EB%A0%88%EC%BD%94%EB%93%9C%EC%A4%91%EB%B3%B5%EC%84%A0%ED%83%9D%ED%97%88%EC%9A%A9.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 예시: 일반 선택과 중복 선택의 차이

**일반 선택**

일반적으로 레코드를 선택하면 선택되거나 해제됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1a66d5a01399ee023135a203676f1cb3f9796340%2F%EC%A1%B0%ED%9A%8C%EC%84%A0%ED%83%9D%EA%B8%B0_%EB%8B%A8%EC%9D%BC%EC%84%A0%ED%83%9D_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

**중복 선택**

중복 선택의 경우, 동일한 레코드를 여러 번 선택하면 선택한 횟수만큼 라인 아이템에 추가됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-435b334eb9f13514cb960af4f09976625baeb944%2F%EC%A4%91%EB%B3%B5%EC%84%A0%ED%83%9D_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>


# 성능 향상을 위한 캐싱

캐싱을 통해 데이터를 빠르게 조회하고 안정적인 환경을 제공합니다. 다만, 데이터에 변경 사항이 있는 경우 최신 상태로 조회되지 않을 수 있습니다.

{% hint style="warning" %}
데이터가 최신 상태로 반영되지 않는 문제가 발생하면, 캐싱 설정을 비활성화해 보세요.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-34a6cbae015865cdf26643d5f4dc515a22b555d0%2F%EC%84%B1%EB%8A%A5%ED%96%A5%EC%83%81%EC%9D%84%EC%9C%84%ED%95%9C%EC%BA%90%EC%8B%B1.png?alt=media" alt=""><figcaption></figcaption></figure>


# 페이지별 레코드 수 설정하기

한 페이지(스크롤 다운 시) 조회할 레코드 수를 지정합니다. 기본 설정은 페이지(스크롤)당 50개입니다.

{% hint style="info" %}
한 번에 선택해야 할 레코드 수가 많다면, ‘**페이지별 레코드 수**’를 늘려보세요.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-ddd302e8c0f259e4d136c2c414ffb1312f5e7281%2F%ED%8E%98%EC%9D%B4%EC%A7%80%EB%B3%84%EB%A0%88%EC%BD%94%EB%93%9C%EC%88%98.png?alt=media" alt=""><figcaption></figcaption></figure>


# 라인 아이템 편집기 설정

라인 아이템 편집기 기능에 대한 기본 설정입니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-667ffcd93ace04b07a5e39ac6258f0b2cf5093ae%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C%EA%B8%B0%EB%B3%B8%EC%84%A4%EC%A0%95_%EA%B0%9C%EC%9A%94.png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="154"></th><th></th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/builder/default-setting/lline-item-editor-settings/show-summary">요약 표시</a></td><td>라인 아이템 편집기 하단에 요약 정보를 표시합니다.</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/default-setting/lline-item-editor-settings/freeze-first-column">첫 번째 열 고정</a></td><td>라인 아이템 편집기에서 가로 스크롤 시, 첫 번째 열을 고정합니다. 표시할 열이 많은 경우, 첫 번째 행을 고정해보세요.</td></tr></tbody></table>


# 요약 표시하기

라인 아이템 편집기 하단에 요약 정보를 표시합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-0b97ebc1c6d39bccb182e0c41b4e03a80a9f52fe%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C%EC%9A%94%EC%95%BD%ED%91%9C%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

### 예시: 라인 아이템 총액 필드 값의 합계 표시하기

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

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

라인 아이템 편집기에서 추가된 모든 데이터의 총액(`TotalPrice`) 필드(열) 값을 합산하여 하단에 합계를 표시하려고 합니다.

#### 설정 방법

1. 기본 설정의 라인 아이템 옵션에서 '요약 표시'를 활성화합니다.
2. 라인 아이템 편집기 설정 단계에서 총액(`TotalPrice`) 필드(열)의 요약 속성을 활성화합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5a097d72c813c874ecadfc6d833a0e9494f501aa%2F%EC%9A%94%EC%95%BD_%EC%84%A4%EC%A0%95_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 결과

라인 아이템 편집기를 실행하면, 추가된 데이터의 총액 합계가 하단에 표시되는 것을 확인할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-d85b294723c342cf3cd11f90583272d68f9e1980%2F%EC%9A%94%EC%95%BD_%EA%B2%B0%EA%B3%BC.png?alt=media" alt=""><figcaption></figcaption></figure>


# 첫 번째 열 고정하기

라인 아이템 편집기에서 가로 스크롤 시, 첫 번째 열을 고정합니다. 표시할 열이 많은 경우, 첫 번째 행을 고정해보세요.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-19860f41fa2d7a214576aa64c094d585b6bbce1d%2F%EC%B2%AB%EB%B2%88%EC%A7%B8%EC%97%B4%EA%B3%A0%EC%A0%95.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 일반

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-3e63ce51ca8b9fc7994e9ba580962d74280ea7d7%2F%EC%97%B4%EA%B3%A0%EC%A0%95%EB%B9%84%ED%99%9C%EC%84%B1%ED%99%94.gif?alt=media" alt=""><figcaption></figcaption></figure>

#### 첫 번째 열 고정이 활성화된 경우

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-cfcfb4ce7f20fd948eb3ff89c1efb71d27428afa%2F%EC%97%B4%EA%B3%A0%EC%A0%95%ED%99%9C%EC%84%B1%ED%99%94%EC%98%88%EC%8B%9C.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 빌더 셋업 절차

라인 아이템 편집기를 구현하기 위해서는 다음의 절차를 수행합니다:

{% stepper %}
{% step %}
[**개체 연결하기**](/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects)

빌더에서 설정해야 하는 가장 첫 번째 단계는 라인 아이템 편집기에서 사용할 개체들의 관계를 정의하는 것입니다. 이 관계는 반드시 Junction 관계 구조를 따라야 하며, **부모(Parent)**, **라인 아이템(Line Item)**, **조회(Lookup)** 개체를 설정해야 합니다.
{% endstep %}

{% step %}
[**조회 선택기 설정**](/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-lookup-selector)

라인 아이템을 등록하기 위해서는 먼저 제품과 같은 조회 개체를 검색하고 검색 결과 중 원하는 레코드를 선택하고 수량 등을 설정하여 라인 아이템을 등록합니다. 검색 설정은 조회 개체 검색 시 검색 결과 레이아웃을 설정하는 기능입니다.
{% endstep %}

{% step %}
[**라인 아이템 편집기 설정**](/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor)

라인 아이템 필드의 속성을 설정합니다. 앞서 선택 조회 레코드별로 가격, 할인율, 수량 등의 속성 필드를 정의합니다.
{% endstep %}

{% step %}
[**미리보기**](/ko/smallbuilder-line-items/builder/builder-setup-steps/preview)

빌더 설정을 완료한 후, 활성화하기 전에 반드시 미리보기를 통해 설정된 기능이 올바르게 작동하는지 확인하세요. 이를 통해 예상치 못한 오류나 불완전한 설정을 사전에 발견할 수 있습니다.
{% endstep %}

{% step %}
[**활성화**](/ko/smallbuilder-line-items/builder/builder-setup-steps/activate)

빌더 설정이 완료되면 활성화(Activate)를 진행합니다. 활성화를 통해 편집기 기능이 적용되며, 이후 편집기를 실행하는 버튼을 생성할 수 있습니다.
{% endstep %}

{% step %}
[**버튼 생성하기**](/ko/smallbuilder-line-items/builder/builder-setup-steps/create-button)

설정을 완료한 후, 버튼을 생성하여 부모 개체의 페이지 레이아웃에 추가합니다. 버튼을 추가하면 사용자는 해당 버튼을 클릭하여 편집기를 실행할 수 있습니다.
{% endstep %}
{% endstepper %}


# 개체 연결 (Relate Objects)

빌더에서 설정해야 하는 가장 첫 번째 단계는 라인 아이템 편집기에서 사용할 개체들의 관계를 정의하는 것입니다. 이 관계는 반드시 [Junction 관계 구조](/ko/smallbuilder-line-items/introduction#junction-object)를 따라야 하며, **부모(Parent)**, **라인 아이템(Line Item)**, **조회(Lookup)** 개체를 설정해야 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-9bb3da88f31ffaf2167421ee47ea24d918a6479a%2F%EA%B0%9C%EC%B2%B4%EC%97%B0%EA%B2%B0_%ED%99%94%EB%A9%B4.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### 설정 단계

{% stepper %}
{% step %}
**부모 개체**

부모 개체는 라인 아이템 개체의 **상위 개체**로, **Master-Detail** 또는 **Lookup** 관계를 가집니다. 라인 아이템 편집기는 부모 개체의 레코드 페이지에서 실행됩니다.

[부모 개체 설정하기 >](/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/parent-object)
{% endstep %}

{% step %}
**라인 아이템 개체**

**라인 아이템 개체**는 참조 데이터를 선택하여 추가 정보를 입력하고 저장하는 역할을 하는 개체입니다.

[라인 아이템 개체 설정하기 >](/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/line-item-object)
{% endstep %}

{% step %}
**조회 개체**

조회 개체는 라인 아이템 개체에서 참조하는 개체로, 사용자는 조회 레코드를 선택하여 이를 기반으로 라인 아이템 레코드를 생성합니다.

[조회 개체 설정하기 >](/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/lookup-object)
{% endstep %}
{% endstepper %}

### 예시: 기회 제품 편집 화면 재구성하기

기회(`Opportunity`)를 기준으로 여러 제품을 관리하기 위해 기회 제품(`OpportunityLineItem`)이라는 개체가 사용됩니다. 기회 제품은 가격 목록 항목(`PricebookEntry`)을 참조하여 제품 및 가격 정보를 가져옵니다. 이러한 스탠다드 기회 제품 등록 화면을 SmallBuilder Line Items를 사용하여 재구성하려고 합니다.

* **부모 개체:&#x20;**<mark style="color:orange;">**기회**</mark>

  여러 제품을 연결하는 **상위 개체**로, 기회 제품과 Master-Detail 관계를 가집니다.
* **라인 아이템 개체:&#x20;**<mark style="color:orange;">**기회 제품**</mark>

  판매 가격, 수량, 총 금액 등 **제품 관련 데이터를 저장**하며, 기회와 연결됩니다.
* **조회 개체:&#x20;**<mark style="color:orange;">**가격 목록 항목**</mark>

  제품 이름과 가격 정보를 가져오는 **참조 개체**로, 기회 제품에서 Lookup 관계를 가집니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-655fdd57398a3695fee90109b6f6e55257d821e1%2F%EA%B8%B0%ED%9A%8C%EC%A0%9C%ED%92%88_ERD.jpg?alt=media" alt=""><figcaption><p>기회 제품은 Junction 개체로, 기회와 가격 목록 항목을 연결하여 특정 기회의 제품 정보를 관리합니다.</p></figcaption></figure>


# 부모 개체 (Parent Object)

부모 개체는 라인 아이템 개체의 **상위 개체**로, **Master-Detail** 또는 **Lookup** 관계를 가집니다. 라인 아이템 편집기는 부모 개체의 레코드 페이지에서 실행됩니다. 빌더에서 부모 개체를 검색할 때, 하위 개체를 가지고 있는 개체만 검색이 가능합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-6a73b8acfefd5b7e266f1318c719e061240e075c%2F%EB%B6%80%EB%AA%A8%EA%B0%9C%EC%B2%B4.jpg?alt=media" alt=""><figcaption><p>빌더 - 개체 연결 단계</p></figcaption></figure>

부모 개체의 레코드 페이지에서 라인 아이템 편집기를 실행합니다.

{% hint style="info" %}
[라인 아이템 편집기 버튼](https://github.com/Windmillsoft/smallbuilder-help-kr/blob/main/smallbuilder-line-items/builder/undefined/relate-objects/broken-reference/README.md)은 빌더에서 생성할 수 있으며, 원하는 페이지 레이아웃에 추가할 수 있습니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-284db012b8cd7cab5b75bcbb097dd869efa2d682%2F%EB%B6%80%EB%AA%A8%EA%B0%9C%EC%B2%B4_%ED%8E%B8%EC%A7%91%EA%B8%B0%EB%B2%84%ED%8A%BC.jpg?alt=media" alt=""><figcaption><p>기회 제품에 대한 라인아이템 편집기를 구현하여 기회 레코드 페이지에서 실행합니다.</p></figcaption></figure>


# 라인 아이템 개체 (Line Item Object)

**라인 아이템 개체**는 참조 데이터를 선택하여 추가 정보를 입력하고 저장하는 역할을 하는 개체입니다. 이 개체는 부모 개체의 하위 개체여야 하며, 빌더에서 부모 개체를 선택하면 해당 부모 개체와 연관된 하위 개체를 검색할 수 있습니다. 해당 단계에서는 필터, 정렬, 자동 번호 등의 설정들을 제공하고 있습니다.

<div data-full-width="false"><figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-44d11adbfdf374352c27f8e3acd7ecdb28beec99%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C_%EC%A0%84%EC%B2%B4_%EC%84%A4%EC%A0%95.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

<table data-header-hidden data-full-width="false"><thead><tr><th width="56"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/line-item-object/configuration">개체 및 부모 참조 필드 설정하기</a><br>라인 아이템으로 사용될 개체를 선택하고, 해당 개체를 부모 개체와 연결할 필드를 지정합니다. 스탠다드 개체를 사용하는 경우, 자동 설정 옵션을 통해 필요한 설정을 간편하게 구성할 수 있습니다.</td></tr><tr><td><strong>2</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/line-item-object/filter-sort">저장된 라인 아이템의 필터와 정렬 순서 설정하기</a><br>라인 아이템 편집기에서 실행 시 조건에 맞는 저장된 라인 아이템을 불러오고 싶다면, 필터와 정렬 순서를 설정해보세요. 이를 통해 원하는 데이터만 표시하고, 불러오는 순서를 제어할 수 있습니다.</td></tr><tr><td><strong>3</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/line-item-object/deletion-control">라인 아이템 삭제 제어하기</a><br>라인 아이템을 삭제할 때 특정 조건에 따라 제어하려면, 조건의 결과값(<code>true</code> 또는 <code>false</code>)을 저장하는 필드를 지정하세요. 이 필드는 삭제 가능 여부를 결정하는 데 사용됩니다.</td></tr><tr><td><strong>4</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/line-item-object/auto-number">자동 번호 설정하기</a><br>라인 아이템 저장 시 자동 번호를 설정할 수 있습니다. 이 기능은 특히 제품 옵션을 사용하는 경우 각 라인 아이템을 구분하고 관리하기에 유용합니다.</td></tr></tbody></table>


# 설정 방법

### 부모 개체에 따라 설정 방법 제공

빌더는 스탠다드 기회(`Opportunity`), 견적(`Quote`), 주문(`Order`)에 한해 자동 설정을 지원합니다. 따라서 부모 개체를 기회, 견적, 주문 중 하나로 지정할 경우, 아래 두 가지 설정 방법 중 선택할 수 있습니다:

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-9f970e2a4307f98d88807d96e156830f99553c79%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C_%EC%84%A4%EC%A0%95_%EC%98%B5%EC%85%98.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="64"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td><a href="#undefined-1"><strong>스탠다드: 자동 설정하기</strong></a><br>스탠다드 설정은 부모 개체를 기반으로 라인 아이템과 조회 개체에 필요한 설정을 자동으로 구성합니다. 이를 통해 편집기를 빠르고 간편하게 설정할 수 있습니다.</td></tr><tr><td><strong>2</strong></td><td><a href="#undefined-3"><strong>직접 선택: 맞춤형 라인 아이템 설정하기</strong></a><br>사용자 정의 개체를 사용하여 편집기를 구성하려면 직접 선택을 선택해야 합니다. 이 옵션을 통해 부모 개체, 라인 아이템 개체, 조회 개체를 수동으로 정의하여 편집기를 유연하게 설계할 수 있습니다.</td></tr></tbody></table>

### 스탠다드: 자동 설정하기

스탠다드 설정은 부모 개체를 기반으로 라인 아이템과 조회 개체에 필요한 설정을 자동으로 구성합니다. 이를 통해 편집기를 빠르고 간편하게 설정할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-59517a029c13136ccc8aabed3ae203fb32a90cbb%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C_%EC%8A%A4%ED%83%A0%EB%8B%A4%EB%93%9C_%EC%84%A4%EC%A0%95_%EC%84%A0%ED%83%9D.jpg?alt=media" alt=""><figcaption></figcaption></figure>

예를 들어, 기회(`Opportunity`)에 대해 스탠다드 설정을 적용하면 다음과 같이 자동 구성됩니다:

* **라인 아이템 개체(Line Item Object):**
  * 기회 제품(`OpportunityLineItem`)으로 설정됩니다.
  * 단가, 수량, 총 금액 등 필수 필드가 자동으로 추가됩니다.
* **조회 개체(Lookup Object):**
  * 가격 목록 항목(`PricebookEntry`)으로 설정됩니다.
  * 조회 시 필요한 필드(예: 제품명, 단가) 및 필터 조건(예: Pricebook2Id)이 자동으로 구성됩니다.

#### 스탠다드 대상 개체

<table><thead><tr><th width="93">대상 개체</th><th width="153">부모 개체</th><th width="224">라인 아이템 개체</th><th width="280">조회 개체</th></tr></thead><tbody><tr><td><strong>기회</strong></td><td><p>기회</p><p><code>Opportunity</code></p></td><td><p>기회 제품</p><p><code>OpportunityLineItem</code></p></td><td><p>가격 목록 항목</p><p><code>PricebookEntry</code></p></td></tr><tr><td><strong>견적</strong></td><td><p>견적</p><p><code>Quote</code></p></td><td><p>견적서 행 아이템</p><p><code>QuoteLineItem</code></p></td><td><p>가격 목록 항목</p><p><code>PricebookEntry</code></p></td></tr><tr><td><strong>주문</strong></td><td><p>주문</p><p><code>Order</code></p></td><td><p>주문 제품</p><p><code>OrderItem</code></p></td><td><p>가격 목록 항목</p><p><code>PricebookEntry</code></p></td></tr></tbody></table>

### 직접 선택: 맞춤형 라인 아이템 설정하기

사용자 정의 개체를 사용하여 편집기를 구성하려면 직접 설정을 선택해야 합니다. 이 옵션을 통해 부모 개체, 라인 아이템 개체, 조회 개체를 수동으로 정의하여 편집기를 유연하게 설계할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-f7aac4580fe8e0ffce626a22c4ff720638217e12%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C_%EC%BB%A4%EC%8A%A4%ED%85%80_%EC%84%A4%EC%A0%95.jpg?alt=media" alt=""><figcaption></figcaption></figure>

직접 선택 옵션을 선택하거나, 부모 개체가 사용자 정의 개체(Custom Object)인 경우, 아래와 같은 설정 옵션이 제공됩니다:

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-35ef0d065ca65cfbcfcdb55573c901a9adb1fd67%2F%EA%B0%9C%EC%B2%B4_%ED%95%84%EB%93%9C_%EC%84%A4%EC%A0%95.jpg?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="100"></th><th width="215"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td><strong>개체 (Object)</strong></td><td>라인 아이템으로 사용할 부모의 하위 개체를 선택합니다. 이 단계는 부모 개체와 연결된 하위 개체 중에서 라인 아이템으로 사용할 적절한 개체를 지정하는 과정입니다.</td></tr><tr><td><strong>2</strong></td><td><strong>부모 참조 필드 (Parent Reference Field)</strong></td><td>선택한 라인 아이템 개체에서 부모 개체를 참조하는 필드를 지정합니다. 이 필드는 라인 아이템 저장 시 부모 개체를 자동으로 할당하는 데 사용됩니다.</td></tr></tbody></table>


# 저장된 라인 아이템의 필터 및 정렬 순서 설정하기

라인 아이템 편집기에서 실행 시 조건에 맞는 저장된 라인 아이템을 불러오고 싶다면, 필터와 정렬 순서를 설정해보세요. 이를 통해 원하는 데이터만 표시하고, 불러오는 순서를 제어할 수 있습니다.

### 필터 설정하기

편집기 실행 시, 저장된 라인 아이템 데이터를 필터링하여 원하는 조건에 맞는 데이터만 표시할 수 있습니다. 필터 설정 방식은 **SOQL**의 **WHERE**절과 동일합니다.

예를 들어, 기회에서 기회 제품을 일반 제품과 구독 제품으로 나눠서 편집기를 사용하려는 경우, 각 편집기에 필터를 적용합니다. 구독형 기회 제품에 대한 편집기의 경우, 구분을 위해 만든 필드인 유형(`Type__c`)이 ‘구독’인 기회 제품 레코드만 편집 대상으로 하려면, 필터를 아래와 같이 작성하면 됩니다:

```sql
Type__c = '구독'
```

또한, 직접 작성하지 않고 [쿼리 마법사(Query Wizard)](/ko/smallbuilder-line-items/builder/query-wizard)를 이용해 필터를 자동으로 생성할 수도 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-33c382b1b6bb5b3306384b79536e83ac8efbc759%2F%ED%95%84%ED%84%B0.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### 정렬 설정하기

편집기 실행 시, 저장된 라인 아이템 데이터를 원하는 순서로 정렬할 수 있습니다. 정렬 설정 방식은 **SOQL**의 **ORDER BY**절과 동일합니다.

예를 들어, 라인 아이템을 최근 생성된 순서로 정렬하고 싶다면 `CreatedDate DESC`로 작성하면 됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-6f3a613b40985fc622f6b53225910c927c5119e5%2F%EC%A0%95%EB%A0%AC.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 조건에 따라 라인 아이템 삭제 제어하기

저장된 라인 아이템의 상태에 따라 삭제를 제어하고 싶다면, Boolean 유형의 필드를 지정하여 삭제 가능 여부를 설정할 수 있습니다. 지정된 필드 값이 `true`(참)인 경우, 해당 라인 아이템에 대해 삭제 버튼을 비활성화할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-c53a7ecf015ebc76562d1d0eea1fb998eca35db8%2F%EC%82%AD%EC%A0%9C%EC%A0%9C%EC%96%B4%ED%95%84%EB%93%9C.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
삭제 제어는 라인 아이템 편집기 화면에서만 작동하며, Salesforce 내부 트랜잭션(예: API, 데이터 로더, 또는 수동 삭제)에서는 제어되지 않습니다.
{% endhint %}

### 예시: 승인된 상태의 기회 제품 삭제 불가 설정

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

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

기회의 라인 아이템인 기회 제품이 승인된 경우, 삭제가 불가능하도록 설정하려고 합니다. 이를 위해 승인됨(`Approved__c`) 필드를 사용하여 삭제 제어를 구성하였습니다.

#### 빌더 설정

삭제 제어 필드에 승인됨(`Approved__c`) 필드 API명을 입력합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-63cf06268717a1e7ef2e6520fa53302815bbf0a0%2F%EC%82%AD%EC%A0%9C%EC%A0%9C%EC%96%B4%ED%95%84%EB%93%9C_%EC%97%90%EC%8B%9C1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

#### 결과

승인됨(`Approved__c`) 필드값이 `true`인 경우에만 삭제 버튼이 노출되지 않는 것을 확인하실 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1468d8758c6d1f21e39a8952278089a442d6e7f9%2F%EC%82%AD%EC%A0%9C%EC%A0%9C%EC%96%B4%ED%95%84%EB%93%9C_%EC%98%88%EC%8B%9C.jpg?alt=media" alt=""><figcaption></figcaption></figure>


# 자동 번호 설정하기

라인 아이템 저장 시 자동 번호를 설정할 수 있습니다. 이 기능은 특히 제품 옵션을 사용하는 경우, 각 라인 아이템을 구분하고 관리하기에 유용합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-8f8f0dfc7c9aed0a07588dc39a7fe8d0dcb6b939%2F%EC%9E%90%EB%8F%99%EB%B2%88%ED%98%B8.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
자동 번호는 라인 아이템 편집기 화면에서 저장하는 경우에만 해당되며, Salesforce 내부 트랜잭션(예: API, 데이터 로더, 또는 수동 삭제)에서는 자동으로 번호가 할당되지 않습니다.
{% endhint %}

### 예시: 제품 옵션과 함께 등록된 기회 제품에 자동 번호 할당하기

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

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

기회 상세 페이지에서 라인 아이템 편집기를 사용해 기회 제품을 저장하고, 기회에서 견적을 생성한 뒤, 수정된 내용을 다시 기회에 동기화(Sync)하는 과정을 진행한다고 가정해 보겠습니다.

그러나 순서 정렬(`SortOrder`) 필드값을 올바르게 저장하지 않으면, 제품 옵션에 대한 라인 아이템들이 잘못된 순서로 정렬되어 사용자에게 혼란을 줄 수 있습니다. 이를 해결하기 위해 순서 정렬(`SortOrder`) 필드에 자동 번호를 할당하여, 동기화(Sync) 시 순서가 올바르게 정렬되도록 설정합니다.

#### 빌더 설정

1. 빌더에서 [개체 연결](/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects) 단계에서 자동 번호 필드에 순서 정렬 필드의 API명(`SortOrder`)를 입력합니다.
2. 정렬 순서를 표시하기 위해 [라인 아이템 편집기 설정](/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor) 단계에서 정렬 순서(`SortOrder`)를 추가합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-b6bae7df16bbc8692d7ceb75f8ccdfd2cb77235c%2F%EC%9E%90%EB%8F%99%EB%B2%88%ED%98%B8_%EC%98%88%EC%8B%9C_%EB%B9%8C%EB%8D%94.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 결과

라인 아이템 편집기를 실행하면, 정렬 순서(`SortOrder`) 컬럼에 자동 번호가 할당된 것을 보실 수 있습니다.

{% hint style="info" %}
라인 아이템의 **자동 번호**는 기본적으로 100, 200, 300과 같이 **100 단위**로 순번이 매겨집니다. 구성 제품의 **옵션 라인 아이템**은 주 라인 아이템의 번호를 기준으로 **101, 102와 같이 하위 번호**가 할당됩니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a61aeba1645740061990db8be96e57fe5a8da823%2F%EC%9E%90%EB%8F%99%EB%B2%88%ED%98%B8_%EC%98%88%EC%8B%9C_%EA%B2%B0%EA%B3%BC.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**옵션 라인 아이템**의 경우, 편집기에서는 **아래 필드 정보만 노출**됩니다:

* 제품명
* 정가
* 단가
* 수량
* 총액
* 할인율/할인액
  {% endhint %}


# 조회 개체 (Lookup Object)

조회 개체는 라인 아이템 개체에서 참조하는 개체로, 사용자는 조회 레코드를 선택하여 이를 기반으로 라인 아이템 레코드를 생성합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-e77260e3120bf02a080049a4a720135dce44c2b7%2F%EC%A1%B0%ED%9A%8C%EA%B0%9C%EC%B2%B4_%EC%84%A4%EC%A0%95.png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="54"></th><th width="249"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/lookup-object/select-lookup-reference-field">조회 참조 필드 선택하기</a></td><td>라인 아이템 개체에서 조회 개체를 참조하는 필드를 설정합니다.</td></tr><tr><td><strong>2</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/lookup-object/keyword-setting">키워드 검색 설정하기</a></td><td>조회 레코드를 검색할 때, 어떤 필드값을 기준으로 검색할지를 설정할 수 있습니다. 기본적으로 조회 개체의 Name 필드가 검색 기준으로 설정됩니다.</td></tr><tr><td><strong>3</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/lookup-object/block-lookup-selector">조회 선택기 차단하기</a></td><td>라인 아이템 편집기에서 조회 선택기를 사용하지 않고, 라인 아이템 편집만 원하는 경우, 조회 선택기를 차단하도록 설정할 수 있습니다. 또한, 조건에 따라 조회 선택기를 차단하거나 활성화할 수도 있습니다.</td></tr><tr><td><strong>4</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/relate-objects/lookup-object/filter-sort">필터 및 정렬 순서 설정하기</a></td><td>필터를 사용하여 필요한 데이터만 조회하고, 조회된 데이터에 대해 원하는 정렬 순서를 설정할 수 있습니다.</td></tr></tbody></table>


# 설정 방법

부모 개체에서 시작하여 하위 개체인 라인 아이템을 선택하고, 라인 아이템이 참조하고 있는 조회 개체를 설정합니다. 조회 개체를 지정할 때는, 라인 아이템에서 조회 개체를 참조하는 필드를 선택해야 합니다.

기회(`Opportunity`)에 대한 기회 제품(`OpportunityLineItem`)을 기반으로 빌더를 설정한다고 가정해 보겠습니다. 아래 개체 구조 이미지와 같이 기회 제품은 두 가지 주요 관계를 가집니다:

* **기회(**`Opportunity`**)**

  기회 제품의 상위 개체로 **기회 ID(**`OpportunityId`**)** 필드로 참조됩니다.
* **가격 목록 항목(**`PricebookEntry`**)**

  기회 제품이 참조하고 있는 개체로 **가격 목록 항목 ID(**`PricebookEntryId`**)** 필드로 참조됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-f350fa4d90f7769eaa3631d24725d7a43eb1c8ea%2F%EC%B0%B8%EC%A1%B0_%ED%95%84%EB%93%9C_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

**부모 개체**는 기회(`Opportunity`)로 선택합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FJfWg9UKY5KHUHnI12CPC%2Fimage.png?alt=media&amp;token=2bfe2a39-8cf6-46c0-88dc-1c39ad28f1ed" alt=""><figcaption></figcaption></figure>

**라인 아이템 개체**는 기회 제품(`OpportunityLineItem`)으로 선택합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FHfEcUDrAKdcR1jZMg7Om%2Fimage.png?alt=media&amp;token=8f900c8d-ea03-4018-bc12-5ea596a33d2b" alt=""><figcaption></figcaption></figure>

기회 제품(`OpportunityLineItem`)은 가격 목록 항목(`PricebookEntry`)을 참조하여 생성되기 때문에, 조회 참조 필드로 기회 제품의 가격 목록 항목 ID(`PricebookEntryId`) 필드를 선택해야 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-0bcd470a04b2458c542f5bcb2f56e412a5c69309%2F%EC%A1%B0%ED%9A%8C%EC%B0%B8%EC%A1%B0%ED%95%84%EB%93%9C_%EC%84%A0%ED%83%9D.png?alt=media" alt=""><figcaption></figcaption></figure>


# 키워드 검색 설정하기

조회 레코드를 검색할 때 검색할 키워드의 대상 필드값을 설정합니다. 기본적으로 **이름 필드**가 검색 대상으로 지정되며, 일치 조건은 **포함(Contains)**&#xC785;니다.

### 예시

키워드 검색 필드는 **가격 목록 항목(**`PricebookEntry`**)** 개체의 **제품 이름(**`Name`**)** 필드로 설정되어 있습니다. 검색 조건은 **포함(Contains)**&#xC774;며, 입력한 검색 키워드가 제품 이름 필드 값에 포함된 경우 조회됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1cb078ab6b0b21381df5042b365ca1fe4a9f3b71%2F%ED%82%A4%EC%9B%8C%EB%93%9C%EC%84%A4%EC%A0%95.png?alt=media" alt=""><figcaption></figcaption></figure>

편집기에서 조회 선택기 화면에 ‘Gen’을 입력하면, 제품 이름에 ‘Gen’이 포함된 항목만 검색되는 것을 확인할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-02a5fdcd94fd6a63afca173dc73957736b56b65a%2F%ED%82%A4%EC%9B%8C%EB%93%9C%EA%B2%80%EC%83%89%EA%B2%B0%EA%B3%BC.png?alt=media" alt=""><figcaption></figcaption></figure>


# 조회 선택기 차단하기

조회 선택기를 건너뛰고 바로 라인 아이템 편집기로 전환하고 싶은 경우, 조회 선택기 차단 기능을 활성화하세요. 또한, 특정 조건에 따라 조회 선택기를 차단할 수도 있습니다.

**차단 조건을 설정**하려는 경우, 부모 개체의 특정 필드를 기반으로 제어됩니다. 해당 필드는 **Boolean 유형**이어야 하며, 값이 `true`인 경우 조회 선택기가 차단됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a81378ccb53c5054ecc9869b65bf0f5749f2103a%2F%EC%A1%B0%ED%9A%8C%EC%84%A0%ED%83%9D%EA%B8%B0_%EC%B0%A8%EB%8B%A8_%EC%84%A4%EC%A0%95.png?alt=media" alt=""><figcaption></figcaption></figure>

### 예시: 갱신된 기회에서 제품 추가 차단하기

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

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

라인 아이템 편집기에서 갱신된 기회인 경우 제품 추가(라인 아이템 추가)를 차단하려고 합니다. 예시에서는 기회의 갱신됨(`IsRenewal__c`) 필드를 사용하여 차단 조건을 설정합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-d0fd8e1db3c94b924f04c50c30df8af2acd617b0%2F%EC%A1%B0%ED%9A%8C%EC%B0%A8%EB%8B%A8%EC%98%88%EC%8B%9C1.png?alt=media" alt=""><figcaption></figcaption></figure>

**갱신됨**(`IsRenewal__c`)이 `true`일 때 편집기에서 **조회 선택기 화면으로 전환하는 버튼이 표시되지 않는 것**을 확인할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a17ea64c028859219f0306eed3d890e000c1131f%2F%EC%A1%B0%ED%9A%8C%EC%84%A0%ED%83%9D%EA%B8%B0%EC%B0%A8%EB%8B%A8_%EA%B2%B0%EA%B3%BC.png?alt=media" alt=""><figcaption></figcaption></figure>


# 조회 레코드의 필터 및 정렬 순서 설정하기

조회 선택기 화면이 로드될 때 조건에 맞는 조회 개체의 레코드를 불러오려면 필터를 설정하고, 원하는 레코드 순서를 지정하려면 정렬을 설정하세요.

### 필터 설정하기

조회 선택기 로드 시 원하는 조건에 맞는 데이터만 조회됩니다. 필터 설정 방식은 SOQL의 `WHERE`절과 동일합니다.

예를 들어, 활성화된 가격 목록 항목만 조회하려면 `IsActive = true`로 작성하면 됩니다. 또한, 직접 작성하지 않고 [쿼리 마법사(Query Wizard)](/ko/smallbuilder-line-items/builder/query-wizard)를 이용해 필터를 자동으로 생성할 수도 있습니다.

{% hint style="info" %}
필터에서 부모 개체의 필드 값을 지정하려면 `{$Parent.FieldName}` 구문을 사용하여 바인딩할 수 있습니다. 예를 들어, 사용자가 부모 개체의 통화와 일치하는 레코드만 조회할 수 있도록 하려면, 필터를 아래와 같이 작성할 수 있습니다:

`CurrencyIsoCode = {$Parent.CurrencyIsoCode}`

이렇게 하면 필터가 부모 개체의 통화 필드를 동적으로 참조하여 상황에 맞는 조회 결과를 제공합니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-89fb92a751b47c2e2d0951c2fd1bc7ae61e22bf9%2F%EC%A1%B0%ED%9A%8C%EC%84%A0%ED%83%9D%EA%B8%B0_%ED%95%84%ED%84%B0_%EC%84%A4%EC%A0%95.png?alt=media" alt=""><figcaption></figcaption></figure>

### 정렬 설정하기

조회 선택기 로드 시 데이터가 원하는 순서로 정렬되도록 미리 정의할 수 있습니다. 정렬 설정 방식은 SOQL의 `ORDER BY`절과 동일합니다.

예를 들어, 가격 목록 항목의 이름을 오름차순으로 정렬하고 싶다면 `Name ASC`로 작성하면 됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-456dff6dc81f1c8110a8aac82b42c3960b0466ec%2F%EC%A1%B0%ED%9A%8C_%EC%A0%95%EB%A0%AC%EC%88%9C%EC%84%9C.png?alt=media" alt=""><figcaption></figcaption></figure>


# 조회 선택기 설정 (Setup Lookup Selector)

라인 아이템을 등록하기 위해서는 먼저 제품과 같은 조회 개체를 검색하고 검색 결과 중 원하는 레코드를 선택하고 수량 등을 설정하여 라인 아이템을 등록합니다. 검색 설정은 조회 개체 검색 시 검색 결과 레이아웃을 설정하는 기능입니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-536f39e785d12aea1c53829ad1aafa3810920014%2F%EC%A1%B0%ED%9A%8C%EC%84%A0%ED%83%9D%EA%B8%B0%EC%84%A4%EC%A0%95_%EA%B0%9C%EC%9A%94.png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="54"></th><th width="153"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-lookup-selector/add-columns">조회 필드 설정</a></td><td><p>조회 선택기에서 검색 결과에 표시할 필드(열)를 추가하고, 각 필드(열)의 속성을 설정할 수 있습니다.</p><p>또한, 데이터 소스에서 가져온 데이터를 표시하기 위해 가상 열을 추가할 수도 있습니다.</p></td></tr><tr><td><strong>2</strong></td><td><a href="/ko/smallbuilder-line-items/builder/datasource">데이터소스</a></td><td><p>조회 개체 레코드 외에 추가 데이터를 표시하고 싶은 경우 데이터소스를 활용하여 다른 개체를 조회하거나 가져온 데이터를 표시할 수 있습니다.</p><p>또한, Apex Class를 사용하면 복잡한 로직이나 외부 인터페이스를 통해 데이터를 가져와 조회 선택기에서 표시하는 것도 가능합니다.</p></td></tr></tbody></table>


# 열 추가하기

조회 선택기에 표시할 필드(열)을 설정합니다. 또한, [데이터소스](/ko/smallbuilder-line-items/builder/datasource)에서 가져온 데이터를 표시하기 위해 가상 열을 추가할 수 있습니다.

{% hint style="danger" %}
현재 **필드 보안 수준(Field-Level Security)에 따라 필드가 제어되지 않습니다.** 사용자가 해당 필드에 대한 권한이 없을 경우, 오류가 발생합니다. 추후에 개선될 예정입니다.
{% endhint %}

### 설정 방법

조회 선택기 설정 단계에서 **열 추가** 버튼을 클릭하여 조회 선택기에 표시할 필드를 선택합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-26acce6bccea511239cc50e56438249ee101e316%2F%EC%97%B4%EC%B6%94%EA%B0%80.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 열 추가 예시

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a154888f59185bc11d6b5f41e71955ef289fd3b0%2F%EC%A1%B0%ED%9A%8C_%EC%97%B4_%EC%B6%94%EA%B0%80.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 열 순서 변경하기

추가된 열은 Drag & Drop을 사용하여 순서를 변경할 수 있습니다.

### 열 순서 변경 방법

1. 원하는 열의 맨 좌측 아이콘(<img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-cfdb4c7243950a10d35f3ebf424dcdacd0b9b11e%2F%EB%93%9C%EB%9E%98%EA%B7%B8_%EC%95%84%EC%9D%B4%EC%BD%98.png?alt=media" alt="" data-size="line">)을 마우스로 클릭한 상태로 유지합니다.
2. 마우스를 클릭한 상태에서 열을 원하는 위치로 Drag & Drop 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-85a70205bf2dcb3aad95036187027be6f25c6df9%2F%EC%97%B4%EC%88%9C%EC%84%9C%EB%B3%80%EA%B2%BD_%EC%98%88%EC%8B%9C1.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 열 정렬 예시

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a02446cbde38a8a0eaf725a46c98a7941d2082d9%2F%EC%97%B4%EC%88%9C%EC%84%9C%EB%B3%80%EA%B2%BD_%EC%98%88%EC%8B%9C2.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 레이블 변경하기

조회 선택기의 데이터 테이블에 표시할 열 레이블을 변경할 수 있습니다. **기본적으로 선택된 필드의 레이블**이 표시되며, 레이블 입력란에 값을 입력하면 해당 값이 표시됩니다. 또한, **입력란 옆의 아이콘(** <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-3a6c153b1baefbe32266d4338931d6cc652311a7%2F%EC%BB%A4%EC%8A%A4%ED%85%80%EB%9D%BC%EB%B2%A8_%EC%95%84%EC%9D%B4%EC%BD%98.jpg?alt=media" alt="" data-size="line"> **)**&#xC744; 클릭하여 [커스텀 라벨을 삽입](/ko/smallbuilder-line-items/builder/inserting-custom-labels)하면 사용자 언어 설정에 따라 번역된 레이블이 표시됩니다.

{% hint style="info" %}
레이블을 별도로 설정하지 않은 경우, 기본적으로 표시되는 필드 레이블은 사용자 언어에 따라 번역됩니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1f713055e9a473a9d190310431ad900aa42cf6cf%2F%EB%A0%88%EC%9D%B4%EB%B8%94_%EB%B3%80%EA%B2%BD%ED%95%98%EA%B8%B0.png?alt=media" alt=""><figcaption></figcaption></figure>


# 열 너비 설정하기

열 너비를 고정할 수 있습니다. **단위**는 **픽셀(pixel)**&#xC785;니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1ef9e07537b9ea26869920d697459f613e12b325%2F%EC%97%B4%EB%84%88%EB%B9%84_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>


# 텍스트 정렬 변경하기

열 값의 정렬을 설정할 수 있습니다. 정렬 옵션은 **왼쪽, 오른쪽, 가운데** 세 가지가 있으며, **기본값은 왼쪽** 정렬입니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-e7ce892c9afe631c18663cb4e7b06c568a1e6cb6%2F%ED%85%8D%EC%8A%A4%ED%8A%B8%EC%A0%95%EB%A0%AC%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-6ca333ab1c24f366b550110f96e044172114cb1c%2F%ED%85%8D%EC%8A%A4%ED%8A%B8%EC%A0%95%EB%A0%AC_%EA%B2%B0%EA%B3%BC.png?alt=media" alt=""><figcaption></figcaption></figure>


# 이미지 URL을 이미지로 보여주기

준비중입니다.


# 데이터소스를 위한 가상 열 추가하기

**데이터소스에서 가져온 데이터를 표시하기 위해 임시 값**을 담을 수 있는 가상 열을 생성합니다. 가상 열은 **가상 열 추가** 버튼을 클릭하여 추가할 수 있으며, **값 유형**으로 **텍스트, 숫자, 통화**를 지원합니다.

{% hint style="warning" %}
가상 열은 데이터소스 용도로 사용되므로, 자세한 내용은 데이터소스 문서를 참고하세요.

[데이터소스(DataSource)에 사용된 예시 >](/ko/smallbuilder-line-items/builder/datasource/object#undefined-2)
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-f612368aab45076b20eab540b8110945b4f84285%2F%EA%B0%80%EC%83%81%EC%97%B4_%EA%B0%9C%EC%9A%94.png?alt=media" alt=""><figcaption></figcaption></figure>


# 라인 아이템 편집기 설정 (Setup Line Item Editor)

라인 아이템 필드의 속성을 설정합니다. 앞서 선택 조회 레코드별로 가격, 할인율, 수량 등의 속성 필드를 정의합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-95ac06789b4d4c2cf5c5565fabf9f832148ae228%2F%EB%9D%BC%EC%9D%B8%EC%95%84%EC%9D%B4%ED%85%9C%ED%8E%B8%EC%A7%91%EA%B8%B0%EC%84%A4%EC%A0%95_%EA%B0%9C%EC%9A%94.png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="93"></th><th width="187"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor/add-columns">라인 아이템 필드 설정</a></td><td>Line-item 개체의 모든 필드 중에서 편집 시 사용할 필드를 선택하고 각 필드의 기본값 및 속성을 설정합니다.</td></tr><tr><td><strong>2</strong></td><td><a href="/ko/smallbuilder-line-items/builder/datasource">데이터소스</a></td><td><p>조회 개체 레코드 외에 추가 데이터를 표시하고 싶은 경우 데이터소스를 활용하여 다른 개체를 조회하거나 가져온 데이터를 표시할 수 있습니다.</p><p>또한, Apex Class를 사용하면 복잡한 로직이나 외부 인터페이스를 통해 데이터를 가져와 조회 선택기에서 표시하는 것도 가능합니다.</p></td></tr></tbody></table>


# 열 추가하기

라인 아이템 편집기에 표시 및 작업할 필드(열)을 설정합니다.

{% hint style="warning" %}
미리 추가된 **조회 참조 필드는 삭제할 수 없습니다.** 라인 아이템 편집기에서 해당 필드를 표시하지 않으려면, **숨김 설정**을 체크하세요.

<img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-a062942a9f85ab93aa5ef3f258846be8fa022d3b%2F%EC%A1%B0%ED%9A%8C%EC%97%B4.png?alt=media" alt="" data-size="original">
{% endhint %}

{% hint style="danger" %}
현재 **필드 보안 수준(Field-Level Security)에 따라 필드가 제어되지 않습니다.** 사용자가 해당 필드에 대한 권한이 없을 경우, 오류가 발생합니다. 추후에 개선될 예정입니다.
{% endhint %}

### 설정 방법

라인 아이템 편집기 설정 단계에서 **\[열 추가]** 버튼을 클릭하여 라인 아이템 편집기에 작업할 필드를 선택합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-540bedbddba4a2418b93f6bccad63bb0f45bf521%2F%EC%97%B4%EC%B6%94%EA%B0%80%ED%95%98%EA%B8%B0.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 열 추가 예시

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5e94bf408c3d527949bec8f940b0c32ac76c60f2%2F%EC%97%B4%EC%B6%94%EA%B0%80%EA%B3%BC%EC%A0%95.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 가상 열 추가하기

가상 열은 [비즈니스 규칙(데이터소스)](/ko/smallbuilder-line-items/builder/datasource)을 통해 가져온 데이터나 단순 계산 결과를 화면에 표시하기 위해 사용됩니다.

{% hint style="info" %}
현재 가상 열은 비즈니스 규칙에서만 사용할 수 있으며, 추후 다양한 용도로 확장될 예정입니다.
{% endhint %}

### 설정 방법

1. 가상 열 추가 버튼을 클릭합니다.
2. 내부적으로 사용할 API명을 입력하고 표시할 데이터의 유형을 선택합니다.\
   (API명 중복은 허용되지 않습니다.)
3. 화면에 표시할 레이블을 입력합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-37ce4232dbb28779afffe9f83104e88dc6405a1a%2F%EA%B0%80%EC%83%81%EC%97%B4.png?alt=media" alt=""><figcaption></figcaption></figure>


# 열 순서 변경하기

추가된 열은 Drag & Drop을 사용하여 순서를 변경할 수 있습니다.

### 열 순서 변경 방법

1. 원하는 열의 맨 좌측 아이콘(<img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-cfdb4c7243950a10d35f3ebf424dcdacd0b9b11e%2F%EB%93%9C%EB%9E%98%EA%B7%B8_%EC%95%84%EC%9D%B4%EC%BD%98.png?alt=media" alt="" data-size="line">)을 마우스로 클릭한 상태로 유지합니다.
2. 마우스를 클릭한 상태에서 열을 원하는 위치로 Drag & Drop 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-56ea7744d7c8f67282a6837067d198fd595e6cf9%2F%EC%97%B4%EC%88%9C%EC%84%9C%EB%B3%80%EA%B2%BD.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 열 정렬 예시

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-204728fd7a9831906669217c6bb313ac77dedb95%2F%EC%97%B4%EC%88%9C%EC%84%9C%EB%B3%80%EA%B2%BD%EA%B3%BC%EC%A0%95.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 레이블 변경하기

라인 아이템 편집기에 표시되는 열 레이블을 변경할 수 있습니다. **기본적으로 선택된 필드의 레이블**이 표시되며, 레이블 입력란에 값을 입력하면 해당 값이 표시됩니다. 또한, **입력란 옆의 아이콘(** <img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-3a6c153b1baefbe32266d4338931d6cc652311a7%2F%EC%BB%A4%EC%8A%A4%ED%85%80%EB%9D%BC%EB%B2%A8_%EC%95%84%EC%9D%B4%EC%BD%98.jpg?alt=media" alt="" data-size="line"> **)**&#xC744; 클릭하여 [커스텀 라벨을 삽입](/ko/smallbuilder-line-items/builder/inserting-custom-labels)하면 사용자 언어 설정에 따라 번역된 레이블이 표시됩니다.

{% hint style="info" %}
레이블을 별도로 설정하지 않은 경우, 기본적으로 표시되는 필드 레이블은 사용자 언어에 따라 번역됩니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-9564d13cf1ca514b3e0cdfd9e6be93312fa1ae56%2F%EB%A0%88%EC%9D%B4%EB%B8%94%ED%8E%B8%EC%A7%91.png?alt=media" alt=""><figcaption></figcaption></figure>


# 기본값 설정하기

라인 아이템 추가 시 기본값을 할당할 수 있습니다. 기본값은 **텍스트** 또는 **숫자**만 설정 가능합니다.

{% hint style="warning" %}
기본값은 라인 아이템이 **최초 추가될 때**만 할당됩니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-cbf97a42b60ac706ce1773f39a96c03553034fe4%2F%EA%B8%B0%EB%B3%B8%EA%B0%92.png?alt=media" alt=""><figcaption></figcaption></figure>

### 예시: 수량의 기본값을 1로 설정하기

빌더에서 수량 필드(열)의 기본값을 1로 설정합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5069e1566e057ac0ec1a4732814b2979eafcd994%2F%EA%B8%B0%EB%B3%B8%EA%B0%92_%EC%98%88%EC%8B%9C1.png?alt=media" alt=""><figcaption></figcaption></figure>

라인 아이템 추가 시, 수량이 자동으로 1로 할당되는 것을 확인할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-fba32eb27c5a32e098a808db2ea4c63ad23ad3b3%2F%EA%B8%B0%EB%B3%B8%EA%B0%92_%EC%98%88%EC%8B%9C.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 소스 필드: 부모 또는 조회의 특정 필드 값을 기본값으로 할당하기

라인 아이템 추가 시, 부모 개체 또는 조회 개체의 특정 필드 값을 기본값으로 할당할 수 있습니다.

{% hint style="warning" %}
소스 필드 값은 라인 아이템이 최초 추가될 때만 할당됩니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5aa00c8065f0e1d98cc434be199257dc71658baa%2F%EC%86%8C%EC%8A%A4%ED%95%84%EB%93%9C_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

### 예시: 기회 제품의 단가를 가격 목록 항목의 단가로 기본값으로 할당하기

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

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

기회 제품 추가 시, 선택한 제품의 단가를 기회 제품의 단가 필드에 기본값으로 할당하려고 합니다.

라인 아이템에 정가(`ListPrice`)와 판매 가격(`UnitPrice`) 필드가 추가되어 있습니다. 해당 필드에 조회 개체인 가격 목록 항목(`PricebookEntry`)의 정가(`UnitPrice`) 필드 값을 기본값으로 설정하려고 합니다.

#### 설정 방법

1. 정가와 판매 가격의 소스 필드에서 첫 번째 옵션을 ‘**조회**’로 선택합니다.
2. 두 번째 옵션에서 ‘**정가**’를 선택합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-e5b0e6446cffbdfa3e7b6bcd98647a9981059245%2F%EC%86%8C%EC%8A%A4%ED%95%84%EB%93%9C_%EC%98%88%EC%8B%9C1.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 결과

선택한 제품들의 단가가 라인 아이템의 정가와 판매 가격 필드에 값으로 할당되는 것을 확인할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5b3378fa51a98d749b4480e531f418c4da159004%2F%EC%86%8C%EC%8A%A4%ED%95%84%EB%93%9C_%EC%98%88%EC%8B%9C2.png?alt=media" alt=""><figcaption><p>조회 선택기</p></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-001ea818f92715f38d0e2bda6c09da4e0776fcd2%2F%EC%86%8C%EC%8A%A4%ED%95%84%EB%93%9C_%EC%98%88%EC%8B%9C3.png?alt=media" alt=""><figcaption><p>라인 아이템 편집기</p></figcaption></figure>


# 열 너비 설정하기

열의 너비는 **픽셀(pixel) 단위**로 설정되며, 지정하지 않을 경우 기본 최소 너비는 150px로 자동 적용됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-62673a5b92b2659cf2d2ee6cad61c4a4ed8015c3%2F%EC%97%B4%EB%84%88%EB%B9%84%EC%84%A4%EC%A0%95.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 열 너비 예시

아래 이미지와 같이 대리점가, 총판가, 재고, 수량 등의 열은 데이터 및 입력란 크기에 비해 너비가 작거나 큽니다. 이러한 열의 너비를 고정하여 크기를 일정하게 맞추고자 합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-50c1a015615cbd10a2547d6d489ff66bd4a2aec8%2F%EC%97%B4%EB%84%88%EB%B9%84_%EC%98%88%EC%A0%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

빌더에서 각 열의 너비를 150\~200px 사이로 설정합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-344277c9258d929423dbfc5c5c9958d6700ee62d%2F%EC%97%B4%EB%84%88%EB%B9%84_%EC%98%88%EC%A0%9C2.png?alt=media" alt=""><figcaption></figcaption></figure>

이전보다 열 너비가 더 안정적으로 보이는 것을 확인할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-54bbaa76ebc46bcf9bbf07c3ee5db4e152d67d9a%2F%EC%97%B4%EB%84%88%EB%B9%84_%EC%98%88%EC%A0%9C3.png?alt=media" alt=""><figcaption></figcaption></figure>


# 텍스트 정렬 변경하기

열 값의 정렬을 설정할 수 있습니다. 정렬 옵션은 **왼쪽, 오른쪽, 가운데** 세 가지가 있으며, **기본값은 왼쪽** 정렬입니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-4000c1f28cf1b3fe1f4c952117590a097978efaf%2F%ED%85%8D%EC%8A%A4%ED%8A%B8%EC%A0%95%EB%A0%AC_%EC%98%88%EC%8B%9C1.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 텍스트 정렬 예시

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-4a635a76a8a631a3588534bc1bd97fb92fe341c4%2F%ED%85%8D%EC%8A%A4%ED%8A%B8%EC%A0%95%EB%A0%AC_%EC%98%88%EC%8B%9C2.png?alt=media" alt=""><figcaption></figcaption></figure>


# 읽기 전용으로 표시하기

기본적으로 라인 아이템 필드는 수식 필드를 제외하고 값을 입력받습니다. 그러나 데이터 표시 용도로 사용되는 필드는 읽기 전용으로 설정하세요.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-812dbde76fda6e2d60605902cce52f3fb36fe4ed%2F%EC%9D%BD%EA%B8%B0%EC%A0%84%EC%9A%A9.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 읽기 전용 설정 예시

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5525eef706315d88a12a7417b0ab953498090d76%2F%EC%9D%BD%EA%B8%B0%EC%A0%84%EC%9A%A9_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

### 조건에 따라 읽기 전용으로 표시하기

라인 아이템 필드(열)의 **고급 설정** 메뉴에서 ‘**읽기 전용 고급 설정**’을 통해 설정할 수 있습니다. 해당 기능에 대한 자세한 내용은 ‘[특정 조건에 따라 읽기 전용으로 설정하기](/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor/undefined-1/undefined-4)’ 매뉴얼을 참고하세요.


# 필수 입력으로 지정하기

라인 아이템 필드(열)의 입력을 필수로 처리합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-4b808c1afaeed52bd1cbfef71d26a0bd5af3b6d3%2F%ED%95%84%EC%88%98_%EC%84%A4%EC%A0%95_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

#### 필수 설정 예시

필수로 설정된 필드(열)은 입력란 왼쪽에 붉은 선으로 표시됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-4bd30b0e96b28058611f6040b3722df450b9ffff%2F%ED%95%84%EC%88%98_%EC%98%88%EC%8B%9C1.png?alt=media" alt=""><figcaption></figcaption></figure>

필수 필드(열) 값을 입력하지 않고 저장하는 경우, 아래와 같이 오류가 발생합니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-c72027fa9b3d5bb4a3eb77ea64adf1450b42c451%2F%ED%95%84%EC%88%98_%EC%98%88%EC%8B%9C2.png?alt=media" alt=""><figcaption></figcaption></figure>


# 합계 요약하기

라인 아이템 편집기 하단에 합계를 표시할 열을 설정합니다.

{% hint style="warning" %}
요약을 표시하기 전에, 기본 설정에서 ‘[요약 표시하기](/ko/smallbuilder-line-items/builder/default-setting/lline-item-editor-settings/show-summary)’ 옵션이 활성화되어 있어야 합니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-6ee182043dc685295b8ba6d326c2b95b4aaa6f72%2F%EC%9A%94%EC%95%BD%ED%91%9C%EC%8B%9C%ED%95%98%EA%B8%B0.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-4d4509bee21739f36e32d7db934fcd8301547f37%2F%EC%9A%94%EC%95%BD%ED%91%9C%EC%8B%9C%ED%95%98%EA%B8%B0_%EC%98%88%EC%A0%9C.png?alt=media" alt=""><figcaption></figcaption></figure>


# 이미지 URL을 이미지로 보여주기

준비중입니다.


# 값을 숨김 처리하여 내부적으로 계산 및 로직에 사용하기

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FbiMqMNDl0uSIs6vVs5FB%2FHidden.png?alt=media&amp;token=a1bdc631-bd4b-4c9c-aa09-abdf5b0a216d" alt=""><figcaption></figcaption></figure>

숨김 설정은 아래와 같은 경우에 주로 사용됩니다:

**계산식에 필요한 필드 값 처리**

고급 설정에서 계산식에 사용해야 하는 필드 값이 있는 경우, 해당 필드는 라인 아이템 열에 추가되어야 합니다. 하지만 사용자가 모든 필드를 화면에서 볼 필요는 없기 때문에, 필드를 숨김 처리하여 화면에 노출되지 않도록 설정합니다.

**수식 필드 오류 방지**

라인 아이템 개체의 수식 필드는 저장 시 모든 수식을 재계산합니다. 이때, 특정 수식에 필요한 필드 값이 Null이면 오류가 발생할 수 있습니다. 이를 방지하기 위해 숨김 처리를 사용하여 해당 필드를 열에 추가하고 필요한 값을 할당합니다.


# 일부 필드 값 저장 시 제외하기

기회 제품을 기반으로 설정한 경우, 편집기에서 단가와 총액을 모두 표시하려고 합니다. 기회 제품에서 단가와 총액은 편집 가능한 필드이지만, 동시에 저장할 수는 없습니다. 총액은 내부적으로 단가와 수량에 의해 자동 계산되어 저장됩니다.

이때, 총액을 읽기 전용으로 설정하면 충분하지 않을까 생각할 수 있습니다. 그러나 라인 아이템 편집기는 **빌더 설정에 의존**하기 때문에, 읽기 전용으로 표시되더라도 해당 필드가 **편집 가능한 필드로 설정**되어 있으면 내부적으로 **저장**이 이루어집니다.

따라서, 수식 필드와 같은 읽기 전용 필드를 제외하고, **저장하지 않아야 하는 필드**인 경우 반드시 ‘**저장 안 함**’ 설정을 활성화해야 합니다.

{% hint style="info" %}
스탠다드 개체인 기회, 견적, 주문에 대한 설정인 경우, 총액 필드를 추가하면 자동으로 ‘저장 안 함’이 활성화됩니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-3e916a6756757d431ad1c5130f9b1a8c67ff34e6%2F%EC%A0%80%EC%9E%A5%EC%95%88%ED%95%A8.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-d2fd27852798331d1ad6bb900d38e9000e3ab481%2F%EC%A0%80%EC%9E%A5%EC%95%88%ED%95%A8_%EC%98%88%EC%8B%9C.png?alt=media" alt=""><figcaption></figcaption></figure>


# 고급 설정

화면 좌측의 **확장 아이콘**(<img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FSpJsuREQ1Enht7gML3JO%2Fimage.png?alt=media&amp;token=3c8fcd56-ee09-4da2-951b-9d205eef13ac" alt="" data-size="line">)을 클릭하면 고급 설정 레이아웃이 펼쳐집니다. 고급 설정은 **필드 유형에 따라 다르게 구성**됩니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FiwdL0qeLcAzN9si07UoZ%2FAdvancedSettings.png?alt=media&amp;token=066f47e7-b660-405c-83ed-50d719a6bd67" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="192">고급 설정</th><th>설명</th><th width="100">유형</th></tr></thead><tbody><tr><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor/undefined-1/undefined"><strong>숫자 설정</strong></a></td><td>최소값/최대값을 설정할 수 있습니다.</td><td>숫자, 통화</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor/undefined-1/undefined-1"><strong>계산식 적용</strong></a></td><td>산식, 할인율, 기간 계산을 설정합니다.</td><td>숫자, 통화</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor/undefined-1/undefined-2"><strong>참조 필드 검색 설정</strong></a></td><td>조회 필드의 레코드 검색 시 필터링 및 검색 관련 기능을 설정합니다.</td><td>조회</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor/undefined-1/undefined-3"><strong>이미지 설정</strong></a></td><td>이미지 표시를 활성화한 경우, 너비와 높이를 설정합니다.</td><td>텍스트</td></tr><tr><td><a href="/ko/smallbuilder-line-items/builder/builder-setup-steps/setup-line-item-editor/undefined-1/undefined-4"><strong>읽기 전용 고급 설정</strong></a></td><td>조건에 따라 필드를 읽기 전용으로 설정합니다.</td><td>모두</td></tr></tbody></table>


# 숫자 설정

숫자 설정은 **숫자** 및 **통화** 유형의 필드에서만 지원됩니다. 이 설정을 통해 입력 값의 **최소값**과 **최대값**을 지정할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2F54R0ujG5kP6MzJerxwxC%2Fimage.png?alt=media&amp;token=4da4e748-d459-4027-baef-adc9132491a2" alt=""><figcaption></figcaption></figure>


# 계산식 적용

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2FeLbccJ74xB1jmLyFrf03%2FCalculationSettings.png?alt=media&amp;token=8fefe11e-6608-47e6-91ef-c26867b20a18" alt=""><figcaption></figcaption></figure>


# 참조 필드 검색 설정


# 이미지 설정


# 읽기 전용 고급 설정


# 도움말 텍스트 설정


# 미리보기

편집기를 실제로 사용하기 전에, 빌더에서 설정한 내용이 어떻게 편집기로 구현되는지 미리보기를 통해 확인합니다.

{% hint style="warning" %}
현재는 변경된 설정을 반드시 저장해야만, 미리보기를 통해 변경된 사항이 반영된 것을 확인할 수 있습니다.
{% endhint %}

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-849bd137a3792a589cd62360a28ada7c74500b60%2F%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-635055eef7d433db591efed5966541d4058f7757%2F%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0_%EC%98%88%EC%A0%9C.png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="86"></th><th width="141"></th><th></th></tr></thead><tbody><tr><td><strong>1</strong></td><td>장치</td><td>장치에 따라 편집기를 미리 볼 수 있습니다.</td></tr><tr><td><strong>2</strong></td><td>대상 레코드 선택</td><td>미리 보고 싶은 대상 레코드를 선택합니다. 선택할 레코드는 부모 개체의 레코드입니다.</td></tr></tbody></table>

#### 미리보기 예시

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-1c5f554759aae5570a82e4c018e67f3edf5b494e%2F%EB%AF%B8%EB%A6%AC%EB%B3%B4%EA%B8%B0_%EA%B2%B0%EA%B3%BC.gif?alt=media" alt=""><figcaption></figcaption></figure>


# 활성화

빌더 설정이 완료되고, 미리보기를 통해 정상적으로 동작하는 것을 확인한 후, 빌더를 활성화하여 편집기를 사용할 준비를 합니다.

빌더가 **활성화**되어야 **편집기를 사용**할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-5db075fcee7d07d3d268587a0520bbfd50707d5f%2F%ED%99%9C%EC%84%B1%ED%99%94.png?alt=media" alt=""><figcaption></figcaption></figure>

**활성화**를 해야 편집기 **버튼을 추가**할 수 있습니다.

<figure><img src="https://3985481653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA2fSsDo5KsIVkUoDIV1b%2Fuploads%2Fgit-blob-96834681640058a122ea1e34a7b363ca48426b34%2F%ED%99%9C%EC%84%B1%ED%99%94%ED%9B%84_%EB%B2%84%ED%8A%BC.png?alt=media" alt=""><figcaption></figcaption></figure>




---

[Next Page](/llms-full.txt/1)