Salesforce 외부 서버의 데이터를 조회하여 함께 표현하고자 할 때 고급 데이터 소스를 활용할 수 있습니다. 사용자가 작성한 Apex Class 또는 플로를 통해 데이터를 가져오기 때문에, 내부 데이터 소스에 비해 더 유연하고 다양한 데이터 접근이 가능합니다. 이를 통해 Salesforce 내부 데이터와 외부 시스템의 데이터를 통합하여 LIst View에서 확인할 수 있으며, 복잡한 비즈니스 로직이나 데이터 변환도 구현할 수 있습니다.

예를 들어 외부 서버에서 실시간 재고를 가져와 화면에 같이 표시하고 싶을 때, Apex Class에서 Rest API 코드를 작성하여 고급 데이터 소스에 지정하면 해당 데이터를 List View에 표현할 수 있습니다.

2. 데이터 소스 대상 Apex Class를 검색 후 선택합니다.

3. 활성화 여부, 설명(Description), Key 필드(Key Field), 파라미터(Parameters)를 설정합니다.

2. 데이터 소스 대상 플로를 검색 후 선택합니다.

3. 활성화 여부, 설명(Description), Key 필드(Key Field), 파라미터(Parameters)를 설정합니다.

데이터 소스에서 가져온 정보를 리스트와 통합하기 위해 필드 매핑 작업을 수행합니다. 이 과정에서 데이터 소스와 리스트 레코드 간 공통된 값을 가진 필드를 키(key)로 설정하여 정확한 데이터 결합을 보장합니다. 이러한 매핑 과정을 통해 다양한 소스의 데이터를 효과적으로 통합하고 관리할 수 있습니다.

작업 추가 및 설정 방법

1. 작업(Actions) 탭의 Key 행에 있는 편집 아이콘을 클릭합니다.

2. 공통된 값을 가진 데이터 소스 필드와 리스트 필드를 선택하고 저장(Save) 버튼을 클릭합니다.

3. 설정한 Key가 올바르게 적용됐는지 확인하고, 작업 추가(Add Action) 버튼을 클릭합니다.

4. 데이터를 가져올 데이터 소스 필드를 선택하고 이를 저장할 리스트 필드 또는 가상 필드를 선택한 후, 저장(Save) 버튼을 클릭합니다.

리스트의 개체를 Product2로 지정하여 제품 목록을 검색하려고 합니다. 해당 목록에 PricebookEntry 개체에 있는 단가를 함께 표시하려고 합니다.

1. 버튼을 눌러 'PricebookEntry'를 검색 후 선택합니다.

2. (선택) Condition 란에 Product2Id IN {$Current.Id}를 입력합니다. (SOQL Where문과 동일)

3. Product에 맞는 PricebookEntry 데이터를 결합하기 위해 Key 행의 가장 우측에 있는 편집 버튼을 누릅니다.

4. 열린 팝업창에서 아래와 같이 선택 후 저장합니다.

   • DataSource Field : Product2Id

   • Lists Field : Id

5. PricebookEntry의 단가를 리스트 컬럼에 표시하기 위해 작업 추가(Add Action)을 누릅니다. (작업하기 전 데이터 테이블 설정에서 가상 열을 생성합니다.)

6. 열린 팝업창에서 아래와 같이 선택 후 저장합니다.

   • DataSource Field : UnitPrice

   • Virtual Field : SBLDVirtual1 (작업하기 전 생성한 가상 열)

Salesforce 내 관련 개체를 조회하여 데이터를 함께 표현할 때 기본 데이터 소스를 활용할 수 있습니다. 기본 데이터 소스를 활용하면 관련 개체 간 데이터 통합을 통해 여러 개체의 정보를 하나의 List View에서 확인할 수 있으며, 실시간 데이터 연동으로 연결된 개체의 데이터가 변경될 때 자동으로 반영되어 항상 최신 정보를 제공합니다. 이러한 기능들을 통해 사용자는 더 포괄적이고 통합된 데이터 뷰를 얻을 수 있어 정보에 기반한 의사결정을 더욱 효과적으로 수행할 수 있습니다.

예를 들어 리스트 구성기에 설정된 개체가 Product2이고 해당 제품의 PricebookEntry에 있는 단가를 같이 표시하고 싶을 때, 기본 데이터 소스를 이용해 조건에 맞는 PricebookEntry를 조회하여 제품과 단가를 같이 표현할 수 있습니다.

2. 데이터 소스 대상 개체를 검색 후 선택합니다.

3. 활성화 여부, 설명(Description), 조건(Conditions), 작업(Actions)을 설정합니다.

다양한 데이터 소스를 연결하고 관리할 수 있는 기능을 제공합니다. 사용자는 내부 및 외부 데이터 손쉽게 통합하여, 필요한 데이터를 실시간으로 가져올 수 있습니다. 또한, 데이터 소스의 연결 상태를 모니터링하고, 필요한 경우 설정을 조정하여 최적의 성능을 유지할 수 있습니다.

데이터 소스 설정 방법

1. List Bilder의 우측 상단에 데이터 소스 설정(DataSource Setup) 버튼을 눌러 데이터 소스 설정 화면으로 이동합니다.

2. 기본 또는 고급 탭에서 데이터 소스 설정을 추가합니다.

• 기본(Basic) - 내부 데이터 사용 >

• 고급(Advanced) - 외부 데이터 또는 복잡한 로직 사용 >

3. 설정이 끝나면 우측 상단의 리스트 설정(Lists Setup) 버튼을 눌러 List Builder로 돌아옵니다.

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

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

예시 코드

해당 예시 코드는 외부 API를 호출하여 제품 코드별 재고 수량을 가져온 후, 리스트에 가상 열로 생성한 재고 열(SBLS_Virtual1)에 매핑한다고 가정하였습니다.

global class DataSourceInventory implements SBLS.DataSourceService.Fetchable {
    global SBLS.DataSourceService.Result execute(SBLS.DataSourceService.Parameter params) {
        // 리스트에 검색된 레코드
        List<SObject> records = params.gets();
    
        // 외부 API를 호출하여 데이터소스 값 가져오기 (예: 재고 정보)
        // 키: 제품 코드, 값: 재고 수량
        Map<String, Integer> inventoryData = new Map<String, Integer>(); 
        inventoryData.put('Product001', 10);
        inventoryData.put('Product002', 20);

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

        // 리스트 개체와 데이터소스 매핑
        for (String productCode : inventoryData.keySet()) {
            SBLS.DataSourceService.Action action = new SBLS.DataSourceService.Action();
            action.setKeyValue(productCode); // 리스트 레코드와 매핑할 Key 값 설정
            action.putSourceToTargetField(
                inventoryData.get(productCode), // 데이터소스 값: 재고 정보
                'SBLS_Virtual1'                 // 리스트 가상 열 API명
            );
            result.addAction(action); // Action 추가
        }
        
        return result; // 결과 반환
    }
}

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

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

// 리스트 개체와 데이터소스 매핑
for (String productCode : inventoryData.keySet()) {
    SBLS.DataSourceService.Action action = new SBLS.DataSourceService.Action();
    action.setKeyValue(productCode); // 리스트 레코드와 매핑할 Key 값 설정
    action.putSourceToTargetField(
        inventoryData.get(productCode), // 데이터소스 값: 재고 정보
        'SBLS_Virtual1'                 // 리스트 가상 열 API명
    );
    result.addAction(action); // Action 추가
}

리스트의 정보를 가진 객체입니다. 빌더에서 선택한 필드의 값만 담겨있습니다.

예시 코드

global SBLS.DataSourceService.Result execute(SBLS.DataSourceService.Parameter params) {
    List<SObject> records = params.gets();
    ...
}

Method

List<SObject> gets()

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

리스트와 데이터소스 간의 모든 매핑 정보를 담아 리스트로 반환하는 객체입니다. 매핑 정보는 SBLS.DataSourceService.Action 객체에 저장한 뒤, SBLS.DataSourceService.Result 객체에 추가하여 반환합니다.

예시 코드

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

Method

addAction(SBLS.DataSourceService.Action action)

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

리스트와 데이터소스 값을 매핑한 정보를 담은 객체입니다.

예시 코드

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

Method

setKeyValue(Object keyValue)

리스트의 Key와 일치하는 데이터소스의 Key 값을 설정합니다.

putSourceToTargetField(Object sourceValue, String targetFieldApiName)

데이터소스 값을 원하는 리스트 필드 또는 가상 열에 할당합니다.