패키지 설치

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

라이선스 및 권한 할당

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

라이선스 및 권한 할당

조직 통화 설정

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

조직 통화 설정

번역 활성화

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

번역 활성화

연결된 앱 설정

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

연결된 앱 설정

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

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

Step 1: 허용된 사용자 설정

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

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

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

4. 저장을 클릭합니다.

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

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

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

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

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

5. 저장을 클릭합니다.

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

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

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

3. 활성을 체크합니다.

4. 저장을 클릭합니다.

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

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

라이선스 할당

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

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

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

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

4. 추가를 클릭합니다.

권한 집합 할당

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

• SmallBuilder {제품 이름} Manager

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

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

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

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

2. 편집을 클릭합니다.

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

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

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

v 1.17.5

Release Date

2024. 5. 24.

Fixed

빌더

v 1.17.3

2024. 5. 23.

빌더

v 1.16.0

2024. 4. 29.

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

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

개요

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

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

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

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

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

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

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

세일즈포스 스탠다드 화면

라인 아이템 편집기 화면

Junction Object란 무엇인가요?

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

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

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

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

• 기회: 부모

• 가격 목록 항목: 조회

• 기회 제품: 라인 아이템

주요 기능

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

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

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

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)

패키지 설치

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

라이선스 및 권한 할당

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

조직 통화 설정

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

번역 활성화

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

연결된 앱 설정

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

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

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

빌더 시작하기

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

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

개체 구성하기

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

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

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

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

3. 활성을 체크합니다.

4. 저장을 클릭합니다.

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

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

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

2. 편집을 클릭합니다.

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

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

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

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

2. 편집을 클릭합니다.

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

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

빌더 실행하기

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

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

빌더 레이아웃

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

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. 저장을 클릭합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

기본 설정

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

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

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

화면 비율 조정

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

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

조회 선택기 관련 설정

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

라인 아이템 편집기 관련 설정

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

레이블 설정

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

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

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

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

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

타이틀 변경하기

버튼 레이블 변경하기

커스텀 라벨 적용하기

커스텀 라벨 적용 예시를 확인하고 싶은 경우, 레이블에 커스텀 라벨 삽입하기 메뉴를 참고하세요. 이 메뉴에서는 커스텀 라벨을 사용하는 구체적인 방법과 예시를 제공합니다.

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

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

데스크톱 화면

모바일 화면

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

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

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

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

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

일반 선택

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

중복 선택

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

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

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

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

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

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

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

설정 방법

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

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

결과

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

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

준비중입니다.

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

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

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

일반

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

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

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

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

스탠다드: 자동 설정하기

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

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

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

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

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

• 조회 개체(Lookup Object):

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

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

스탠다드 대상 개체

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

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

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

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

설정 단계

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

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

• 부모 개체: 기회

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

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

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

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

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

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

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

필터 설정하기

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

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

Type__c = '구독'

또한, 직접 작성하지 않고 쿼리 마법사(Query Wizard)를 이용해 필터를 자동으로 생성할 수도 있습니다.

정렬 설정하기

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

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

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

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

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

빌더 설정

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

결과

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

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

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

• 기회(Opportunity)

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

• 가격 목록 항목(PricebookEntry)

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

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

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

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

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

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

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

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

빌더 설정

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

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

결과

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

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

설정 방법

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

열 추가 예시

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

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

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

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

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

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

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

필터 설정하기

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

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

정렬 설정하기

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

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

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

열 순서 변경 방법

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

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

열 정렬 예시

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

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

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

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

준비중입니다.

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

예시

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

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

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

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

열 순서 변경 방법

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

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

열 정렬 예시

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

설정 방법

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

열 추가 예시

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

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

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

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

설정 방법

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

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

결과

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

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

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

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

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

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

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

열 너비 예시

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

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

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

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

읽기 전용 설정 예시

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

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

텍스트 정렬 예시

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

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

필수 설정 예시

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

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

빌더가 활성화되면, 편집기를 실행할 버튼을 생성하여 부모 페이지 레이아웃에 추가합니다.

버튼 생성 및 페이지 레이아웃 할당

버튼의 Aura Component

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

편집기의 Aura Component 활용하기 >

조회 또는 라인 아이템과 관련된 개체나 외부 API 서버에서 필요한 데이터를 조회하거나, 복잡한 로직이나 계산식을 사용해 처리된 데이터를 함께 표시하거나 일부 필드에 기본값으로 설정할 때 사용합니다.

데이터소스 설정

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

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

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

데이터소스 유형

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

외부 API 서버에서 데이터를 조회하거나, 데이터 조회 및 결합 시 복잡한 로직이 요구되는 경우에 사용됩니다. 데이터소스 고급을 설정하려면 Apex 클래스를 작성해야 합니다. Apex 클래스를 사용해 구현하므로, 데이터소스 기본보다 데이터를 더 자유롭게 가져올 수 있다는 장점이 있습니다.

데이터소스 실행 순서

데이터소스는 기본(Basic)이 먼저 실행된 후, 고급(Advanced)이 실행됩니다.

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

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

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

수식 필드 오류 방지

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

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

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

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

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

미리보기 예시

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

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

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

외부 API 서버에서 데이터를 조회하거나, 데이터 조회 및 결합 시 복잡한 로직이 요구되는 경우에 사용됩니다. 데이터소스 고급을 설정하려면 Apex 클래스를 작성해야 합니다. Apex 클래스를 사용해 구현하므로, 데이터소스 기본보다 데이터를 더 자유롭게 가져올 수 있다는 장점이 있습니다.

설정 과정

STEP 1: 데이터소스에 사용할 Apex 클래스를 작성하기 위한 인터페이스 구현

데이터소스 고급 설정에서 사용할 Apex 클래스를 작성하려면 반드시 SBLI.DataSourceService.Fetchable 인터페이스를 구현해야 합니다.

이 인터페이스에는 execute 메서드가 포함되어 있으며, 해당 메서드에 데이터 처리를 위한 로직 구현 후 처리된 데이터와 조회 또는 라인 아이템 간의 매핑 정보를 담은 SBLI.DataSourceService.Result 객체를 반환해야 합니다.

예시 코드

해당 예시 코드는 외부 API를 호출하여 제품 코드별 재고 수량을 가져온 후, 조회 또는 라인 아이템의 재고 필드(Inventory__c)에 매핑한다고 가정하였습니다.

global class DataSourceInventory implements SBLI.DataSourceService.Fetchable {
    global SBLI.DataSourceService.Result execute(SBLI.DataSourceService.Parameter params) {
        // 부모 레코드 가져오기
        SObject parentRecord = params.getParentRecord();

        // 조회 개체 레코드 가져오기
        List<SObject> lookupRecords = params.getLookupRecords();
        
        // 외부 API를 호출하여 데이터소스 값 가져오기 (예: 재고 정보)
        // 키: 제품 코드, 값: 재고 수량
        Map<String, Integer> inventoryData = new Map<String, Integer>(); 
        inventoryData.put('Product001', 10);
        inventoryData.put('Product002', 20);

        // 결과 객체 생성
        SBLI.DataSourceService.Result result = new SBLI.DataSourceService.Result();

        // 조회/라인 아이템 개체와 데이터소스 매핑
        for (String productCode : inventoryData.keySet()) {
            SBLI.DataSourceService.Action action = new SBLI.DataSourceService.Action();
            action.setKeyValue(productCode); // 조회/라인 아이템 레코드와 매핑할 Key 값 설정
            action.putSourceToTargetField(
                inventoryData.get(productCode), // 데이터소스 값: 재고 정보
                'Inventory__c'                 // 조회/라인 아이템 필드 API명
            );
            result.addAction(action); // Action 추가
        }
        
        return result; // 결과 반환
    }
}

// 부모 레코드 가져오기
SObject parentRecord = params.getParentRecord();
// 조회 개체 레코드 가져오기
List<SObject> lookupRecords = params.getLookupRecords();

Map<String, Integer> inventoryData = new Map<String, Integer>(); 
inventoryData.put('Product001', 10);
inventoryData.put('Product002', 20);

// 결과 객체 생성
SBLI.DataSourceService.Result result = new SBLI.DataSourceService.Result();

// 조회/라인 아이템 개체와 데이터소스 매핑
for (String productCode : inventoryData.keySet()) {
    SBLI.DataSourceService.Action action = new SBLI.DataSourceService.Action();
    action.setKeyValue(productCode); // 조회/라인 아이템 레코드와 매핑할 Key 값 설정
    action.putSourceToTargetField(
        inventoryData.get(productCode), // 데이터소스 값: 재고 정보
        'Inventory__c'                 // 조회/라인 아이템 필드 API명
    );
    result.addAction(action); // Action 추가
}

SBLI.DataSourceService.Parameter

빌더에서 설정한 부모와 조회 파라미터 정보를 가진 객체입니다.

예시 코드

global SBLI.DataSourceService.Result execute(SBLI.DataSourceService.Parameter params) {
    SObject parentRecord = params.getParentRecord();
    List<SObject> lookupRecords = params.getLookupRecords();
    ...
}

Methods

SObject getParentRecord()

부모 레코드를 반환합니다. 빌더에서 추가한 부모 파라미터가 없는 경우, 값은 비어 있습니다.

List<SObject> getLookupRecords()

조회 레코드를 반환합니다. 빌더에서 추가한 조회 파라미터가 없는 경우, 값은 비어 있습니다.

SBLI.DataSourceService.Result

조회 또는 라인 아이템과 데이터소스 간의 모든 매핑 정보를 담아 편집기로 반환하는 객체입니다. 매핑 정보는 SBLI.DataSourceService.Action 객체에 저장한 뒤, SBLI.DataSourceService.Result 객체에 추가하여 반환합니다.

예시 코드

SBLI.DataSourceService.Result result = new SBLI.DataSourceService.Result();
for(String productCode : inventoryData.keySet()) {
    // SBLI.DataSourceService.Action 객체에 매핑 정보 저장
    SBLI.DataSourceService.Action action = new SBLI.DataSourceService.Action();
    action.setKayValue(productCode);
    action.putSourceToTargetField(
        inventoryData.get(productCode),
        'Inventory__c'
    );
    result.addAction(action); // 매핑 정보가 담긴 Action을 Result에 추가
}
return result;

Methods

addAction(SBLI.DataSourceService.Action action)

매핑 정보가 담긴 Action 객체를 Result 객체에 추가합니다.

SBLI.DataSourceService.Action

조회 또는 라인 아이템과 데이터소스 값을 매핑한 정보를 담은 객체입니다.

예시 코드

SBLI.DataSourceService.Result result = new SBLI.DataSourceService.Result();
// 데이터소스에서 각 제품코드와 재고 정보를 반복 처리
for(String productCode : inventoryData.keySet()) {
    SBLI.DataSourceService.Action action = new SBLI.DataSourceService.Action();
    // 제품코드를 Key 값으로 설정하여 조회/라인 아이템과 매핑
    action.setKayValue(productCode);
    
    // 재고 정보를 조회/라인 아이템의 Inventory__c 필드에 매핑 
    action.putSourceToTargetField(
        inventoryData.get(productCode),    // 데이터소스 값: 재고
        'Inventory__c'                                // 필드 API명
    );
    result.addAction(action); // 매핑 정보 추가
}
return result; // 최종 결과 반환

Methods

setKeyValue(Object keyValue)

조회 또는 라인 아이템의 Key와 일치하는 데이터소스의 Key 값을 설정합니다.

putSourceToTargetField(Object sourceValue, String targetFieldApiName)

데이터소스 값을 원하는 조회 또는 라인 아이템 필드에 할당합니다.

STEP 2: 데이터소스 고급 설정

Apex 클래스를 선택한 후, 클래스에서 부모와 조회 정보가 필요한 경우 파라미터로 전달할 필드들을 선택합니다.

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

데이터소스 기본 설정

작업

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

예시: 제품의 단가 표시

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

설정

1. 데이터소스에서 소스 개체(Source Object)를 가격 목록 항목(PricebookEntry)로 지정합니다.

2. 쿼리 마법사를 눌러 조회 조건을 설정합니다.

   IsActive = true AND Pricebook2Id = {$Parent.Pricebook2Id}

3. 각 제품에 해당되는 가격 목록 항목 데이터를 결합하기 위해 다음과 같이 설정합니다:

   • 소스 개체: Product2Id

   • 대상 개체: Id

   • Key: true

4. 단가를 제품 데이터와 같이 표시하기 위해 작업(Action)을 추가하여 조회 필드(가상 열)을 지정합니다.

   • 소스 필드: UnitPrice

   • 대상 필드: SBLI_Virtual1

결과

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

커스텀 라벨 적용이 가능한 곳에는 아이콘이 표시됩니다. 해당 아이콘을 클릭하면 커스텀 라벨을 선택할 수 있는 모달 창이 나타나며, 원하는 라벨을 선택하여 적용할 수 있습니다.

예시: 편집기에서 조회 선택기 버튼 레이블 변경하기

조회 개체 이름이 가격 목록 항목으로 설정되어 조회 선택기 버튼의 이름도 조회 개체 이름을 그대로 사용합니다. 하지만 이러한 버튼 이름은 사용자에게 어색하게 보일 수 있습니다. 세일즈포스 설정에서 개체 레이블을 변경하는 것은 비효율적입니다. 해당 개체는 여러 곳에서 다양하게 사용되므로, 다른 화면에도 영향을 미칠 가능성이 있기 때문입니다.

설정

1. 사이드 패널에서 레이블 메뉴로 이동합니다.

3. 미리 만들어 둔 커스텀 라벨 ‘제품 추가(SmallBuilder_AddProducts)’을 선택합니다.

4. 입력란에 커스텀 라벨({$CustomLabel.SmallBuilder_AddProducts})이 바인딩된 것을 확인합니다.

5. 편집기를 실행하여 조회 선택기 버튼이 제대로 변경되었는지 확인합니다.

결과

사용자의 언어 설정에 따라 커스텀 라벨이 번역되어 표시되는 것을 확인할 수 있습니다.

제품 추가(SmallBuilder_AddProducts) 레이블에 대한 번역

사용자의 언어가 한국어인 경우 버튼 레이블이 '제품 추가'로 보이는 것을 확인할 수 있습니다.

사용자의 언어가 영어인 경우 버튼 레이블이 'Add Products'로 보이는 것을 확인할 수 있습니다.

빌더 설정을 수정 중 저장하지 않은 상태에서, 변경 사항을 취소하고 설정을 원래 상태로 복원하고 싶다면 초기화 기능을 사용하세요.

라인 아이템에 하위 옵션 제품을 추가할 수 있는 기능으로 특정 제품의 구성 요소(예: 추가 서비스, 부가 제품)를 함께 등록하거나 관리하고자 할 때 사용됩니다.

제품 옵션 설정하기

제품 옵션을 사용하려면 먼저 빌더에서 제품 옵션 기능을 활성화하고, 필요한 설정과 데이터를 구성해야 합니다. 아래 참조 문서의 셋업 절차를 따라 설정을 진행하세요.

제품 옵션 셋업 절차 >

라인 아이템 옵션 값의 표시 및 저장 방식

옵션이 라인 아이템에 어떻게 표시되고 저장되는지 확인하세요.

표시 및 저장 방식 확인하기 >

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

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

로직 설정하기

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

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

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

1 AND 2 AND 3

로직 변경하기

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

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

1 OR 2 OR 3

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

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

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

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

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

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

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

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

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

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

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

복제 목적

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

1. 안전한 수정 및 테스트

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

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

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

복제하기

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

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

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

제품 추가 시 옵션 선택 건너뛰기, 선택할 수 있는 옵션 필터하기 등 기본적인 설정을 진행합니다.

기본 펼치기

라인 아이템 편집기를 로드하면, 기본적으로 구성 제품에 추가된 옵션들이 모두 표시되도록 옵션 라인 아이템 목록이 확장되어 있습니다.

만약 편집기 로드 시 옵션 목록을 숨기고 싶다면, ‘기본 펼치기’ 설정을 비활성화하세요.

기본 펼치기가 활성화 된 경우

기본 펼치기가 비활성화 된 경우

옵션 선택 건너뛰기

기본적으로 제품 옵션이 활성화되면, 조회 선택기에서 제품을 선택한 후 다음 버튼을 클릭하면 옵션 선택 단계가 나타납니다.

하지만, 제품을 추가할 때마다 옵션 선택 단계가 나타나는 것이 번거롭거나 불필요하다고 느낄 경우, ‘옵션 선택 건너뛰기’ 설정을 활성화하여 해당 단계를 건너뛸 수 있습니다.

옵션 선택을 건너뛰는 경우

옵션 선택을 건너뛰는 설정을 활성화하면, 아래 이미지와 같이 제품 선택 후 옵션 선택 단계가 생략됩니다. 옵션 선택 단계를 스킵하더라도 라인 아이템 편집기에서 옵션을 선택하거나 추가할 수 있습니다.

옵션 필터

옵션은 선택한 제품과 부모(기회, 견적, 주문)의 가격 목록(Pricebook2Id)을 기반으로 조회됩니다.

추가적으로 옵션 조회 조건을 설정하고 싶은 경우, 옵션 필터를 설정하세요. 필터 작성 방식은 SOQL의 WHERE 절과 동일하며, 필터 기준이 되는 개체는 제품 옵션(SBLI__ProductOption__c)입니다.

예시

제품 옵션을 사용하려면 다음과 같은 셋업 절차를 진행해야 합니다:

제품 옵션을 사용하려면 빌더에서 제품 옵션 기능을 활성화해야 합니다. 해당 설정은 개체 연결 단계의 조회 개체 영역에서 활성화할 수 있습니다.

단, 제품 옵션 설정은 스탠다드 설정(기회, 견적, 주문)인 경우에만 가능합니다.

스탠다드 설정에서만 제품 옵션 제공

앞서 안내한 것처럼, 제품 옵션은 스탠다드 설정에서만 활성화할 수 있습니다.

제품 옵션은 가격 목록 항목(PricebookEntry)을 기준으로 제품과 단가 정보를 조회하기 때문에, 세일즈포스에서 가격 목록 항목과 유일하게 관계를 맺고 있는 기회(Opportunity), 견적(Quote), 주문(Order)에 한정하여 제공됩니다.

제품 옵션을 활성화하면 빌더 상단에 ‘제품 옵션 설정’ 단계가 추가됩니다. 해당 단계에서 제품 옵션 기능을 사용하기 위한 설정을 진행합니다.

제품 옵션 설정

제품 옵션 설정은 크게 기본 설정과 라인 아이템 설정으로 나뉩니다.

제품 옵션 데이터는 제품 구성(SBLI__ProductFeature__c)과 제품 옵션(SBLI__ProductOption__c) 개체로 구성됩니다. 두 개체는 제품(Product2)를 참조하며, 다음과 같은 역할을 합니다:

주요 데이터 구성은 제품 옵션을 중심으로 이루어지며, 제품 구성은 필요에 따라 추가로 설정됩니다.

제품 구성

제품 옵션을 카테고리별로 그룹화합니다.

개체 정보

필드 정보

제품 옵션

옵션의 주요 개체로, 옵션 제품과 관련 정보를 관리합니다.

개체 정보

필드 정보

구성 제품의 라인 아이템과 옵션 제품의 라인 아이템 간 연결할 필드를 설정하고 옵션 정보를 저장할 라인 아이템 필드를 매핑하는 작업을 수행합니다.

상위 라인 아이템 필드

구성 제품 라인 아이템과 해당 옵션 라인 아이템을 연결할 필드를 설정합니다. 이 필드는 Self-Relationship이여야 하며, Self-Relationship은 동일한 개체 내에서 레코드 간의 관계를 나타내는 구조로, 한 레코드가 같은 개체의 다른 레코드를 참조할 수 있도록 설정하는 관계입니다.

예시

상위 라인 아이템 필드를 Base Line Item for Option(SBLI__BaseLineItemForOption__c)로 설정했다고 가정하면, 아래 다이어그램과 같은 Self-Relationship 구조가 형성됩니다.

이 설정을 통해 옵션으로 생성된 기회 제품 레코드가 구성 제품의 기회 제품 레코드를 해당 필드를 통해 참조하게 됩니다.

라인 아이템 편집기 화면 예시

옵션 값을 라인 아이템 필드에 매핑

선택한 옵션 정보를 라인 아이템의 어느 필드에 매핑할지 설정합니다. 옵션에서는 다음과 같은 정보를 제공합니다:

예시

기회 제품에 옵션 값을 아래와 같이 매핑하였습니다:

라인 아이템 편집기 화면 예시

구성 제품인 Desktop PC Intel i3의 RAM 옵션으로 RAM 8GB를 선택합니다. 해당 옵션의 수량은 1이며, 정가와 단가는 동일하게 $45입니다.

선택한 후 추가된 라인 아이템을 확인하면, 앞서 매핑한 필드에 수량, 정가, 단가, 총액의 값이 할당된 것을 확인할 수 있습니다.