Apex Class 작성

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

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

---

🔸 예시 코드

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

SBLS.DataSourceService.Fetchable 인터페이스는 패키지에서 제공되는 인터페이스이므로, 패키지 외부에서 접근하려면 Apex 클래스와 제공되는 메서드 모두 global로 선언해야 합니다.

DataSourceInventory.cls

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

1

리스트에 검색된 레코드 가져오기

params.gets()를 사용하여 리스트의 검색된 레코드를 가져옵니다.

2

데이터소스 값 준비

• 외부 API 서버에서 데이터를 호출하여 재고 정보를 가져온다고 가정합니다.

• 예시에서는 제품 코드(ProductCode)를 기반으로 재고 정보를 매핑합니다.

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

3

결과 생성

• SBLS.DataSourceService.Action 객체를 생성하여 데이터소스 값(재고 정보)을 가상 열 재고(SBLS_Virtual01)에 매핑합니다.
• 생성된 Action 객체를 SBLS.DataSourceService.Result에 추가합니다.

// 결과 객체 생성
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 추가
}

4

반환

매핑된 결과를 담은 Result 객체를 반환하여, 리스트에 매핑 정보를 전달합니다.

---

🔸 SBLS.DataSourceService.Parameter

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

예시 코드

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

Method

List<SObject> gets()

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

---

🔸 SBLS.DataSourceService.Result

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

예시 코드

DataSourceInventory.cls

...
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 객체에 추가합니다.

매개변수	유형	값
action	SBLS.DataSourceService.Action	리스트와 데이터소스 값을 매핑한 정보를 담은 객체입니다.

---

🔸 SBLS.DataSourceService.Action

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

예시 코드

DataSourceInventory.cls

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 값을 설정합니다.

매개변수	유형	값
keyValue	Object	데이터소스의 Key 값입니다.

putSourceToTargetField(Object sourceValue, String targetFieldApiName)

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

매개변수	유형	값
sourceValue	Object	데이터소스 값입니다.
targetFieldApiName	String	리스트의 필드 또는 가상 열의 API명입니다.