외부 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();
    ...
}

Method

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;

Method

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; // 최종 결과 반환

Method

setKeyValue(Object keyValue)

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

putSourceToTargetField(Object sourceValue, String targetFieldApiName)

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

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

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

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

데이터소스 설정

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

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

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

데이터소스 유형

기본 (Basic)

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

고급 (Advanced)

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

데이터소스 실행 순서

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

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

데이터소스 기본 설정

작업

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

예시: 제품의 단가 표시

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

설정

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

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

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

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

   • 소스 개체: Product2Id

   • 대상 개체: Id

   • Key: true

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

   • 소스 필드: UnitPrice

   • 대상 필드: SBLI_Virtual1

결과

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