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

1. 기본 정보 및 옵션 설정 (Side Panel)

2. 개체 설정 (Relate Objects)

3. 검색 설정 (Setup Lookup Selector)

4. 편집기 설정 (Setup Line-item Editor)

5. 적용

빌더 실행하기

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

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

빌더 구성

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

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

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

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

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

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

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

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

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

2. • 개체 연결

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

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

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

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

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 편집 레이아웃을 열어줍니다.

데이터소스 유형

Internal

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

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

External

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

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

빌더의 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 개체의 모든 필드 중에서 편집 시 사용할 필드를 선택하고 각 필드의 기본값 및 속성을 설정합니다.

• 고급 설정

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

• Add data sources

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

컬럼 설정

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

고급 설정

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

Add data sources

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

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

Line-item Object Advanced Setting

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

Lookup Object Filter

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

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

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

• 속성

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

• Apex Class 작성

  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() 메서드를 구현합니다.

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

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

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

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

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

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

예시

준비중입니다.

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

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

• 속성

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

• Action

  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

   • Target Field : SBLDVirtual1 (Lookup Virtual Column 참고)

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

설정

• 컬럼 설정

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

• Virtual

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

• Add data sources

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

컬럼 설정

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

Virtual

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

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