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

라이선스 할당

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

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

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

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

4. 추가를 클릭합니다.

권한 집합 할당

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

• SmallBuilder {제품 이름} Manager

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

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

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

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

Step 1: 허용된 사용자 설정

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

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

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

4. 저장을 클릭합니다.

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

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

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

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

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

5. 저장을 클릭합니다.

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

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

2. 편집을 클릭합니다.

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

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

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

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

2. 편집을 클릭합니다.

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

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

패키지 설치

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

라이선스 및 권한 할당

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

라이선스 및 권한 할당

조직 통화 설정

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

조직 통화 설정

번역 활성화

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

번역 활성화

연결된 앱 설정

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

연결된 앱 설정

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

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

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

3. 활성을 체크합니다.

4. 저장을 클릭합니다.

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

패키지 설치

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

라이선스 및 권한 할당

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

라이선스 및 권한 할당 >

조직 통화 설정

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

조직 통화 설정 >

번역 활성화

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

번역 활성화 >

연결된 앱 설정

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

연결된 앱 설정 >

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

기회, 제품 및 가격 목록과 같이 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. 저장을 클릭합니다.

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

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번 단계를 반복합니다.

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

설정

• 기본 정보

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

• Lookup Options

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

• Line-Item Options

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

기본 정보

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

Lookup Options

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

Line-Item Options

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

Field API Name Finder

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

설정

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

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

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

컬럼 설정

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

Virtual

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

Add data sources

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

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

Builder에서 데이터 소스 추가

1. Lookup에 Data Source를 설정하는 경우: 검색 설정(Setup Lookup Selector) 단계로 이동합니다. Line-Item의 Data Source를 설정하는 경우: 편집기 설정(Setup Line-Item Editor) 단계로 이동합니다.

2. Add data sources 버튼을 눌러 Data Source 편집 레이아웃을 열어줍니다.

데이터소스 유형

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

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

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

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

주로 외부 서버에서 데이터를 조회하여 같이 표현해주고 싶을 때 사용됩니다. 사용자가 작성한 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() 메서드를 구현합니다.

SBLD.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. App Launcher( )에서 SmallBuilder Line Items를 찾아 이동합니다.

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

빌더 구성

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

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

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

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

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

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

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

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

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

2. • 개체 연결

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

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

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

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

Line-item Configurator를 구현하기 위해서는 다음의 절차를 수행합니다.

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

라인 아이템 추가 시

1. 기본값 설정

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

3. 데이터소스 적용

   1. 기본

   2. 고급

4. Calculation Formula 적용

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

6. 요약 계산

라인 아이템 값 변경 시

1. Calculation Formula 적용

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

3. 요약 계산

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

1. 안전한 수정 및 테스트

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

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

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

복제하기

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

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

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

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

설정

• 컬럼 설정

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

• 고급 설정

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

• Add data sources

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

컬럼 설정

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

고급 설정

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

Add data sources

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

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

Preview

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

Add Button

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

Component 직접 생성

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

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

Attributes

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

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

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

화면 비율 조정

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

화면 비율 설정하기 >

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

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

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

장치 설정하기 >

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

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

편집기 레이블 변경하기 >

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

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

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

데스크톱 화면

조회 선택기

라인 아이템 편집기

모바일 화면

조회 선택기

라인 아이템 편집기

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

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

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

타이틀 변경하기

버튼 레이블 변경하기

빌더 실행하기

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

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

빌더 구성

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

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

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

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

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

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

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

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

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

2. • 개체 연결

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

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

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

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

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

Line-item Object Advanced Setting

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

Lookup Object Filter

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

실무에서 많이 접하는 고급 사용자 요구사항을 구현한 예제입니다.

예제는 AppExchage에서 Test Drive를 통해 직접 보실 수 있습니다.

Data Source를 활용한 Promotion 가격 적용 예시

Data Source를 활용한 외부 시스템 연동 예시

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

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

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

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

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

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

개요

• Lookup Selector

• Line-Item Editor

• 빌더

Lookup Selector

Line-Item Editor

빌더

Document Template Builder는 왜 필요할까요?

Document Template이란 무엇인가요?

문서 템플릿은 문서를 작성할 때 사용하는 미리 정해진 형식이나 레이아웃입니다. 데이터를 기반으로 동적 문서가 만들어지며, 비즈니스 문서를 더욱 효율적으로 생성하고, 회사의 정책에 따라 수정할 수 있습니다.

예를 들어, 계약서, 견적서, 주문서 등의 비즈니스 문서를 자동으로 작성할 때 유용합니다. 템플릿 내에서 데이터 필드를 지정하고 데이터가 삽입될 위치를 정의할 수 있기 때문입니다. 자동으로 생성된 문서는 Salesforce 내에서 보기, 다운로드, 이메일로 보내기 등의 방법으로 문서의 공유 및 협업을 간편하게 할 수 있습니다.

커스텀 Document Template의 필요성

실제 Enterprise급 세일즈포스 구축 프로젝트를 수행할 때는 기본 견적서 템플릿을 대체하는 커스텀 견적서 템플릿을 개발하는 경우가 많습니다. 이는 제품 이미지의 배치 등 디자인적 인 요소와 부분 합계 등 기능적 요소가 추가로 필요한 경우가 있기 때문입니다.

이에 더하여 인보이스, 패킹 리스트, 계약서, 서비스 접수증 등 고객에게 제공하는 다양한 문서가 필요한 경우에도 커스텀 문서 템플릿을 개발합니다.

하지만, Salesforce 기본 템플릿 생성 기능은 이러한 특수한 요구 사항을 충족하지 못할 수 있습니다.

1. Easy Use SmallBuilder의 Document Template Builder는 세일즈포스 관리자가 개발자 도움 없이 직접 클릭만으로 문서 템플릿을 만들 수 있도록 지원하는 툴입니다. SmallBuilder를 도입하면 견적은 물론 Account, Opportunity, Contract, Order, Case, Work Order와 같은 Standard 객체는 물론 모든 커스텀 객체에서 문서 템플릿을 빠르게 구현할 수 있습니다.

1. 100% Native 다른 솔루션은 Salesforce와의 연동으로 데이터를 공유하고 트리거를 통해 템플릿이 생성됩니다. 하지만 SmallBuilder의 Document Template Builder는 Salesforce 내에 구축합니다. 이로써 모든 데이터를 내부에서 처리하고 외부 서버로 공유되지 않기 때문에 Salesforce의 보안 규칙을 따르며 데이터를 안전하게 관리합니다.

SmallBuilder는 문서를 더욱 다양한 형태로 구성할 수 있도록 디자인용 및 기능용 컴포넌트를 지속적으로 추가할 예정입니다. 지원이 필요한 새로운 컴포넌트가 있다면 담당 SmallBuilder Account 매니저와 상의하시기 바랍니다.

Document Template Builder 시작하기

새 템플릿을 추가하려면 Document Templates List에서 New 버튼을 클릭하세요.

다음은 템플릿 디자이너입니다. 워드 프로세서 스타일 편집기를 사용하는 다른 프로그램과 달리 SmallBuilder는 블록 스타일 편집기를 사용합니다. 이를 통해 템플릿 디자인과 레이아웃을 직관적으로 쉽게 제어할 수 있습니다.

템플릿 디자이너는 두 가지 영역으로 구성됩니다.

1. Component 탭 : 템플릿에 추가할 수 있는 컴포넌트 요소와 요소의 속성을 설정
2. Setting 탭 : 템플릿 속성을 설정