패키지 설치

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

라이선스 및 권한 할당

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

라이선스 및 권한 할당

조직 통화 설정

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

조직 통화 설정

번역 활성화

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

번역 활성화

연결된 앱 설정

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

연결된 앱 설정

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

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

2. 편집을 클릭합니다.

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

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

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

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

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

3. 활성을 체크합니다.

4. 저장을 클릭합니다.

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

v 1.17.5

2024. 5. 24.

빌더

v 1.17.3

2024. 5. 23.

빌더

v 1.16.0

2024. 4. 29.

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

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

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

라이선스 할당

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

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

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

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

4. 추가를 클릭합니다.

권한 집합 할당

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

• SmallBuilder {제품 이름} Manager

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

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

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

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

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

3. 활성을 체크합니다.

4. 저장을 클릭합니다.

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

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

Step 1: 허용된 사용자 설정

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

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

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

4. 저장을 클릭합니다.

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

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

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

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

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

5. 저장을 클릭합니다.

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

개요

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의 대안으로 활용 가능합니다.

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

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

2. 편집을 클릭합니다.

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

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

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

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

2. 편집을 클릭합니다.

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

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

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에 연결된 앱에 대한 추가 설정이 필요합니다.

연결된 앱 설정 >

빌더 실행하기

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

빌더 레이아웃

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

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

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

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

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

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

데스크톱 화면

모바일 화면

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

빌더 시작하기

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

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

개체 구성하기

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

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

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

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

기본 설정

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

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

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

화면 비율 조정

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

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

조회 선택기 관련 설정

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

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

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

레이블 설정

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

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

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

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

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

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

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

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

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

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

타이틀 변경하기

버튼 레이블 변경하기

커스텀 라벨 적용하기

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

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

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

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

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

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

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

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

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

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

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

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

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

일반 선택

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

중복 선택

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

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

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

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

설정 방법

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

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

결과

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

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

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

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

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

일반

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

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

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

설정 단계

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

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

• 부모 개체: 기회

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

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

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

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

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

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

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

스탠다드: 자동 설정하기

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

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

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

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

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

• 조회 개체(Lookup Object):

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

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

스탠다드 대상 개체

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

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

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

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

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

필터 설정하기

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

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

Type__c = '구독'

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

정렬 설정하기

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

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

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

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

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

빌더 설정

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

결과

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

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

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

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

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

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

빌더 설정

결과

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

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

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

• 기회(Opportunity)

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

• 가격 목록 항목(PricebookEntry)

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

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

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

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

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

필터 설정하기

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

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

정렬 설정하기

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

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

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

예시

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

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

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

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

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

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

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

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

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

설정 방법

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

열 추가 예시

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

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

열 순서 변경 방법

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

열 정렬 예시

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

준비중입니다.

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

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

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

설정 방법

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

열 추가 예시

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

열 순서 변경 방법

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

열 정렬 예시

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

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

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

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

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

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

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

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

설정 방법

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

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

결과

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

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

열 너비 예시

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

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

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

준비중입니다.

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

텍스트 정렬 예시

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

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

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

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

수식 필드 오류 방지

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

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

필수 설정 예시

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

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

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

읽기 전용 설정 예시

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

라인 아이템 필드(열)의 고급 설정 메뉴에서 ‘읽기 전용 고급 설정’을 통해 설정할 수 있습니다. 해당 기능에 대한 자세한 내용은 ‘특정 조건에 따라 읽기 전용으로 설정하기’ 매뉴얼을 참고하세요.