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

라이선스 할당

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

1. 설정에서 빠른 찾기 상자에 설치된 패키지를 입력한 후 설치된 패키지를 선택합니다.

2. SmallBuilder {제품 이름}을 찾아 라이센스 관리를 클릭합니다.

3. 사용자 추가를 눌러 원하는 사용자를 선택합니다.

4. 추가를 클릭합니다.

권한 집합 할당

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

• SmallBuilder {제품 이름} Manager

  SmallBuilder Manager 권한 집합은 제품의 전체 관리를 담당하는 사용자에게 할당됩니다. 주로 관리자에게 할당되며, 이 권한을 받은 관리자는 빌더 설정 구성, 라인 아이템에 버튼 추가, 리스트 제품에서 탭 생성 등 다양한 작업을 수행할 수 있습니다.

• SmallBuilder {제품 이름} User SmallBuilder User 권한 집합은 주로 영업 담당자나 프로젝트 매니저와 같은 사용자에게 할당됩니다. 이 권한 집합을 할당받은 사용자는 SmallBuilder로 구현된 리스트나 문서를 보고, 라인 아이템 및 스케줄에서 데이터를 추가 및 수정할 수 있습니다.

패키지 설치

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

라이선스 및 권한 할당

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

라이선스 및 권한 할당

조직 통화 설정

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

조직 통화 설정

번역 활성화

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

번역 활성화

연결된 앱 설정

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

연결된 앱 설정

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

1. 설정에서 빠른 찾기 상자에 번역을 입력한 후 번역 언어 설정을 선택합니다.

2. 한국어 편집을 클릭합니다.

3. 활성을 체크합니다.

4. 저장을 클릭합니다.

5. 영어에 대해서도 1~4번 단계를 반복합니다.

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

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

1. 설정에서 빠른 찾기 상자에 회사를 입력한 후 회사 정보를 선택합니다.

2. 편집을 클릭합니다.

3. 통화 설정에서 사용 통화가 제대로 선택되어 있는지 확인합니다.

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

v 1.26 - 복잡한 계산식 오류, 할인율 및 계산식 적용 방식 수정

개요

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

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

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

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

• 라인 아이템 추가 또는 편집 시 자동 계산, 외부 데이터 적용 등 최소한의 개발 및 포인트 & 클릭만으로 기능 확장이 가능합니다.

• 빌더를 이용하여 손쉽게 화면을 구현할 수 있어 시간을 절약할 수 있고 유지보수로서 기능 추가 및 수정을 하는데 어려움이 없습니다.

• 라인 아이템 편집기를 구현할 때 필요한 기본 설정은 개발이 필요하지 않아, 세일즈포스 기본 지식을 갖춘 어드민만으로도 화면을 구현할 수 있습니다.

세일즈포스 스탠다드 화면

라인 아이템 편집기 화면

Junction Object란 무엇인가요?

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

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

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

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

• 기회: 부모

• 가격 목록 항목: 조회

• 기회 제품: 라인 아이템

주요 기능

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

기회, 제품 및 가격 목록과 같이 3개 이상의 개체로 이루어지는 복잡한 Line-Item Configurator를 손쉽게 구현할 수 있는 빌더를 제공하고 있습니다.

외부 데이터의 실시간 연동이 필요한 경우 Line-item Configurator Builder는 연동을 담당하는 APEX Code를 호출하여 외부 데이터를 실시간으로 연동할 수 있도록 지원합니다.

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

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

Step 1: 허용된 사용자 설정

1. 설정에서 빠른 찾기 상자에 연결된 앱을 입력한 후 연결된 앱 관리를 선택합니다.

2. SmallBuilder Line Items OAuth 편집을 클릭합니다.

3. 허용된 사용자를 관리 승인 사용자가 미리 인증됨으로 선택합니다.

4. 저장을 클릭합니다.

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

1. 설정에서 빠른 찾기 상자에 연결된 앱을 입력한 후 연결된 앱 관리를 선택합니다.

2. SmallBuilder Line Items OAuth을 클릭합니다.

3. 하단에 프로필 관리 또는 권한 집합 관리를 클릭합니다.

4. 빌더 설정을 담당하는 프로필 또는 권한 집합을 선택합니다.

5. 저장을 클릭합니다.

패키지 설치

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

라이선스 및 권한 할당

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

조직 통화 설정

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

번역 활성화

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

연결된 앱 설정

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

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

빌더 시작하기

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

빌더 이름과 설명 등 기본 정보를 입력하여 라인 아이템 편집기 화면의 을 구성합니다.

개체 구성하기

빌더의 단계에서 라인 아이템 편집기에서 사용할 개체들의 관계를 정의합니다.

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

1. 설정에서 빠른 찾기 상자에 회사를 입력한 후 회사 정보를 선택합니다.

2. 편집을 클릭합니다.

3. 통화 설정에서 사용 통화가 제대로 선택되어 있는지 확인합니다.

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

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

라이선스 할당

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

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

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

데스크톱 화면

조회 선택기

라인 아이템 편집기

모바일 화면

조회 선택기

라인 아이템 편집기

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

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

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

화면 비율 조정

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

화면 비율 설정하기 >

디바이스에 맞게 반응형 UI 설정

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

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

장치 설정하기 >

편집기 타이틀 및 버튼 레이블 설정

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

편집기 레이블 변경하기 >

빌더 실행하기

1. App Launcher( )에서 SmallBuilder Line Items를 찾아 이동합니다.

2. 라인 아이템 편집기 탭으로 이동 후 새로 만들기를 눌러 빌더를 실행합니다.

빌더 구성

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

1. 좌측 상단 타이틀 옆에 활성화 여부를 알 수 있으며 미리 보기, 버튼 추가, 저장 및 삭제 등 버튼이 모여있습니다.

   • 미리보기 최종 저장된 빌더 설정 기반으로 구성기를 미리 볼 수 있습니다.

   • 버튼 추가 활성화된 빌더 설정 기반으로 구성기의 버튼을 생성합니다. 지정한 부모 개체 기반으로 원하는 페이지 레이아웃에 버튼을 추가할 수 있습니다.

   • 활성화 빌더를 구성기로 사용하기 위해 활성화를 반드시 해주어야 합니다. 비활성화 상태인 경우 구성기를 사용할 수 없습니다.

   • 저장 빌더를 저장합니다.

   • 복제 최종적으로 저장된 빌더 기반으로 복제합니다. 복제 버튼을 누른 후 '저장' 버튼을 눌러야 복제가 완료됩니다.

   • 초기화 편집 과정에서 원래 설정으로 복구하고 싶은 경우, Reset 버튼을 누르면 최종적으로 저장된 설정으로 복구됩니다.

   • 도움말 SmallBuilder Line Items의 헬프 문서로 이동합니다.

2. • 개체 연결

     라인 아이템 편집기는 크게 부모, 조회, 라인 아이템으로 구성되어 있습니다. 이 단계에서는 부모, 조회, 라인 아이템에 어떠한 개체를 사용하지 지정합니다. 그리고 해당 구성들에 설정하려는 개체들은 서로 Junction 관계로 맺어져 있어야 하고 개체는 스탠다드, 커스텀 모두 지원합니다.

   • 조회 선택기 설정 조회로 지정된 개체에 대하여 필드를 추가하고 라인 아이템 편집기 구성 시 컬럼 값 정렬 및 너비 등을 설정하는 단계입니다.

   • 라인 아이템 편집기 설정 라인 아이템으로 지정된 개체에 대하여 필드를 추가하고 라인 아이템 편집기 구성 시 컬럼 값 정렬, 너비, 각 컬럼의 속성(숫자, 조회 필드 등)에 따른 고급 설정을 하는 단계입니다.

3. 빌더의 기본 설정을 하는 패널입니다. 빌더의 이름, 화면 비율, 장치에 따른 화면 UX 등을 설정합니다.

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

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

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

v 1.27.0

2024. 8. 5.

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

• 할인율 계산 로직 누락

v 1.26.1

2024. 7. 22.

• Line Item Editor의 할인율과 계산식 중 하나만 적용 가능하도록 수정

• 할인율 관련 일부 레이블 변경

v 1.26.0

2024. 7. 19.

• Line Item의 레코드를 여러개 삭제할 수 있도록 기능 개선

• 제품 옵션 관련 일부 레이블 변경

v 1.25.0

2024. 7. 16.

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

• 라인 아이템 편집기의 조회 컬럼을 설정할 수 있도록 기능 추가

v 1.24.1

2024. 7. 10.

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

v 1.22.0

2024. 6. 19.

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

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)

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

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

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

타이틀 변경하기

버튼 레이블 변경하기

조회 선택기 기능에 대한 기본 설정입니다.

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

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

일반 선택

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

중복 선택

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

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

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

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

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

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

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

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

1. 설정에서 빠른 찾기 상자에 번역을 입력한 후 번역 언어 설정을 선택합니다.

2. 한국어 편집을 클릭합니다.

3. 활성을 체크합니다.

4. 저장을 클릭합니다.

5. 영어에 대해서도 1~4번 단계를 반복합니다.

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

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

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

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

일반

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

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

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

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

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

설정 방법

1. 기본 설정의 라인 아이템 옵션에서 '요약 표시'를 활성화합니다.

2. 라인 아이템 편집기 설정 단계에서 총액(TotalPrice) 필드(열)의 요약 속성을 활성화합니다.

결과

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

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

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

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

준비중입니다.

준비중입니다.

편집기의 Aura Component 활용하기

준비중입니다.

복제 기능은 두 가지 주요 목적으로 사용됩니다:

1. 안전한 수정 및 테스트

버전 관리 기능을 지원하지 않기 때문에, 현재 설정을 복제하여 안전하게 수정하고 테스트할 수 있습니다. 이를 통해 원래 설정에 영향을 주지 않고 변경 사항을 시도할 수 있습니다.

2. 비슷한 편집기 빠르게 구현

비슷한 라인 아이템 편집기를 추가로 구현할 필요가 있을 때, 복제 기능을 사용하면 새 편집기를 신속하게 생성하고 조정할 수 있습니다.

복제하기

1. 빌더 상단에 있는 복제 버튼을 클릭합니다.

2. 복제된 빌더 화면에서 필요한 추가 설정 및 변경을 합니다.

3. 저장을 눌러 복제 작업을 완료합니다.

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

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

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

빌더 설정

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

결과

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

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

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

• 기회(Opportunity)

  기회 제품의 상위 개체로 기회 ID(OpportunityId) 필드로 참조됩니다.

• 가격 목록 항목(PricebookEntry)

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

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

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

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

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

필터 설정하기

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

쿼리 마법사 (Query Wizard)

필터 입력란 아래에 있는 쿼리 마법사(Query Wizard) 버튼을 사용하면, 필터 조건을 보다 쉽게 구성하고 적용할 수 있습니다. 이를 통해 SOQL 문법을 몰라도 조건 설정이 가능합니다.

필터 모두 제거하기

필터 제거 버튼을 클릭하면 입력된 모든 필터 조건이 제거됩니다.

정렬 설정하기

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

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

예시

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

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

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

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

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

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

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

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

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

열 순서 변경 방법

1. 원하는 열의 맨 좌측 아이콘()을 마우스로 클릭한 상태로 유지합니다.

2. 마우스를 클릭한 상태에서 열을 원하는 위치로 Drag & Drop 합니다.

열 정렬 예시

조회 선택기의 데이터 테이블에 표시할 열 레이블을 변경할 수 있습니다. 기본적으로 선택된 필드의 레이블이 표시되며, 레이블 입력란에 값을 입력하면 해당 값이 표시됩니다. 또한, 입력란 옆의 아이콘( )을 클릭하여 커스텀 라벨을 삽입하면 사용자 언어 설정에 따라 번역된 레이블이 표시됩니다.

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

설정 방법

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

열 추가 예시

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

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

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

설정 방법

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

열 추가 예시

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

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

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

필터 설정하기

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

쿼리 마법사 (Query Wizard)

필터 입력란 아래에 있는 쿼리 마법사(Query Wizard) 버튼을 사용하면, 필터 조건을 보다 쉽게 구성하고 적용할 수 있습니다. 이를 통해 SOQL 문법을 몰라도 조건 설정이 가능합니다.

필터 모두 제거하기

필터 제거 버튼을 클릭하면 입력된 모든 필터 조건이 제거됩니다.

정렬 설정하기

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

열 너비를 고정할 수 있습니다. 단위는 픽셀(pixel)입니다.

열 너비 예시

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

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

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

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

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

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

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

설정 방법

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

2. 두 번째 옵션에서 ‘정가’를 선택합니다.

결과

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

라인 아이템 편집기에 표시되는 열 레이블을 변경할 수 있습니다. 기본적으로 선택된 필드의 레이블이 표시되며, 레이블 입력란에 값을 입력하면 해당 값이 표시됩니다. 또한, 입력란 옆의 아이콘( )을 클릭하여 하면 사용자 언어 설정에 따라 번역된 레이블이 표시됩니다.

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

열 순서 변경 방법

1. 원하는 열의 맨 좌측 아이콘()을 마우스로 클릭한 상태로 유지합니다.

2. 마우스를 클릭한 상태에서 열을 원하는 위치로 Drag & Drop 합니다.

열 정렬 예시

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

읽기 전용 설정 예시

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

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

텍스트 정렬 예시

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

필수 설정 예시

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

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

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

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

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

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

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

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

버튼 생성

페이지 레이아웃 할당

버튼의 Aura Component

빌더에서 라인 아이템 편집기 버튼을 생성하면, 아래와 같은 Aura Component가 생성됩니다. 버튼에 연결된 편집기를 더 커스터마이징하고 싶다면, 버튼이 호출하고 있는 Aura Component를 수정하면 됩니다.

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

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

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

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

속성

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

Apex Class 작성

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

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

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

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을 추가합니다.

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

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

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

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

속성

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

Action

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

예시

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

조회 또는 라인 아이템 데이터에 부가적으로 관련 개체나 외부 데이터를 표현해주고 싶을 때 사용됩니다.

빌더에서 데이터소스 추가

1. 조회 선택기에 데이터소스를 설정하는 경우: 조회 선택기 설정(Setup Lookup Selector) 단계로 이동합니다.

   라인 아이템의 데이터소스를 설정하는 경우: 라인 아이템 편집기 설정(Setup Line Item Editor) 단계로 이동합니다.

2. 데이터소스 추가 버튼을 눌러 데이터소스 편집 레이아웃을 열어줍니다.

데이터소스 유형

기본 (Basic)

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

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

고급 (Advanced)

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

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

Component 직접 생성

버튼 외의 다른 위치에서 라인 아이템 편집기를 호출하려면, Aura Component인 <SBLI:LineItemConfigurator />를 사용하면 됩니다.

빌더에서 라인 아이템 편집기 버튼을 생성하면, 아래와 같은 Aura Component가 생성됩니다. 버튼에 연결된 편집기를 더 커스터마이징하고 싶다면, 버튼이 호출하고 있는 Aura Component를 수정하면 됩니다.

Aura Component 속성

Line-item Configurator를 빠르게 이해할 수 있게 구성한 간단한 예제입니다.

기회의 기회 제품 Line-item Configurator 구현 예시

기존에 있는 기회 제품 등록 화면에서 수량 및 단가 변경 시 자동 계산이 안 되는 부분을 Line-Item Configurator를 이용해 할인율 적용, 총액 계산 및 하단에 요약까지 다시 재구현하였습니다.

비즈니스 출장 기능 구현 예시

Line-Item Configurator는 표준 개체뿐만 아니라 사용자 정의 개체를 이용해서 세일즈포스에 쉽게 Line-Item 입력을 할 수 있도록 제공합니다.

아래 영상에서는 사용자 정의 개체인 '비즈니스 출장'을 이용하여 Line-Item Configurator를 구현하였습니다. 기존에는 표준 화면을 이용 시 Line-Item 추가하려면 한 건씩 처리해야 하는 번거로움이 있습니다. 또한, 입력 화면의 필드들을 자유롭게 커스텀하는게 쉽지 않습니다. Configurator를 통해 어떻게 구현되었는지 영상을 통해 보여 드리겠습니다.

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

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

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

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

편집기를 실제로 사용하기 전에, 빌더에서 설정한 내용을 미리보기를 통해 확인합니다.

미리보기 예시

라인 아이템 추가 및 값 변경 시 계산 수식, 수식 필드, 데이터 소스 등 적용되는 순서입니다.

라인 아이템 추가 시

1. 기본값 설정

2. 부모 또는 조회 소스 필드 값 설정

3. 데이터소스 적용

   1. 기본

   2. 고급

4. Calculation Formula 적용

5. Line-Item의 수식 필드 재계산 Configurator의 Line-Item 컬럼에 수식 필드가 있는 경우에만 실행됩니다.

6. 요약 계산

라인 아이템 값 변경 시

1. Calculation Formula 적용

2. 라인 아이템의 수식 필드 재계산 라인 아이템 편집기 컬럼에 수식 필드가 있는 경우에만 실행됩니다.

3. 요약 계산

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

Step 1: 허용된 사용자 설정

1. 설정에서 빠른 찾기 상자에 연결된 앱을 입력한 후 연결된 앱 관리를 선택합니다.

2. SmallBuilder {제품 이름} OAuth 편집을 클릭합니다.

3. 허용된 사용자를 관리 승인 사용자가 미리 인증됨으로 선택합니다.

4. 저장을 클릭합니다.

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

1. 설정에서 빠른 찾기 상자에 연결된 앱을 입력한 후 연결된 앱 관리를 선택합니다.

2. SmallBuilder {제품 이름} OAuth을 클릭합니다.

3. 하단에 프로필 관리 또는 권한 집합 관리를 클릭합니다.

4. 빌더 설정을 담당하는 프로필 또는 권한 집합을 선택합니다.

5. 저장을 클릭합니다.

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

설정 단계

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

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

• 부모 개체: 기회

  여러 제품을 연결하는 상위 개체로, 기회 제품과 Master-Detail 관계를 가집니다.

• 라인 아이템 개체: 기회 제품

  판매 가격, 수량, 총 금액 등 제품 관련 데이터를 저장하며, 기회와 연결됩니다.

• 조회 개체: 가격 목록 항목

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

v 1.17.5

Release Date

2024. 5. 24.

Fixed

빌더

v 1.17.3

2024. 5. 23.

빌더

v 1.16.0

2024. 4. 29.

• 라인 아이템 채번 기능 추가

• 편집기에서 제품 옵션 추가 시 전체 선택 및 해제 기능 추가

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

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

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

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

빌더 설정

1. 빌더에서 개체 연결 단계에서 자동 번호 필드에 순서 정렬 필드의 API명(SortOrder)를 입력합니다.

2. 정렬 순서를 표시하기 위해 라인 아이템 편집기 설정 단계에서 정렬 순서(SortOrder)를 추가합니다.

결과

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

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

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

스탠다드: 자동 설정하기

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

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

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

  • 기회 제품(OpportunityLineItem)으로 설정됩니다.

  • 단가, 수량, 총 금액 등 필수 필드가 자동으로 추가됩니다.

• 조회 개체(Lookup Object):

  • 가격 목록 항목(PricebookEntry)으로 설정됩니다.

  • 조회 시 필요한 필드(예: 제품명, 단가) 및 필터 조건(예: Pricebook2Id)이 자동으로 구성됩니다.

스탠다드 대상 개체

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

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

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

1. 개체 (Object) 라인 아이템으로 사용할 부모의 하위 개체를 선택합니다. 이 단계는 부모 개체와 연결된 하위 개체 중에서 라인 아이템으로 사용할 적절한 개체를 지정하는 과정입니다.

2. 부모 참조 필드 (Parent Reference Field)

   선택한 라인 아이템 개체에서 부모 개체를 참조하는 필드를 지정합니다. 이 필드는 라인 아이템 저장 시 부모 개체를 자동으로 할당하는 데 사용됩니다.

열 너비를 고정할 수 있습니다. 단위는 픽셀(pixel)입니다.