Apex Class 작성
데이터소스 고급 설정에서 사용할 Apex 클래스를 작성하려면 반드시 SBLS.DataSourceService.Fetchable 인터페이스를 구현해야 합니다.
이 인터페이스에는 execute 메서드가 포함되어 있으며, 해당 메서드에 데이터 처리를 위한 로직 구현 후 처리된 데이터와 리스트 간의 매핑 정보를 담은 SBLS.DataSourceService.Result 객체를 반환해야 합니다.
예시 코드
해당 예시 코드는 외부 API를 호출하여 제품 코드별 재고 수량을 가져온 후, 리스트에 가상 열로 생성한 재고 열(SBLS_Virtual01)에 매핑한다고 가정하였습니다.
SBLS.DataSourceService.Fetchable 인터페이스는 패키지에서 제공되는 인터페이스이므로, 패키지 외부에서 접근하려면 Apex 클래스와 제공되는 메서드 모두 global로 선언해야 합니다.
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_Virtual01' // 리스트 가상 열 API명
);
result.addAction(action); // Action 추가
}
return result; // 결과 반환
}
}
리스트에 검색된 레코드 가져오기
params.gets()를 사용하여 리스트의 검색된 레코드를 가져옵니다.
데이터소스 값 준비
외부 API 서버에서 데이터를 호출하여 재고 정보를 가져온다고 가정합니다.
예시에서는 제품 코드(ProductCode)를 기반으로 재고 정보를 매핑합니다.
<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_Virtual01' // 리스트 가상 열 API명
);
result.addAction(action); // Action 추가
}
반환
매핑된 결과를 담은 Result 객체를 반환하여, 리스트에 매핑 정보를 전달합니다.
SBLS.DataSourceService.Parameter
리스트의 정보를 가진 객체입니다. 빌더에서 선택한 필드의 값만 담겨있습니다.
예시 코드
global SBLS.DataSourceService.Result execute(SBLS.DataSourceService.Parameter params) {
List<SObject> records = params.gets();
...
}
Method
SBLS.DataSourceService.Result
리스트와 데이터소스 간의 매핑 정보를 담아 리스트로 반환하는 객체입니다. 매핑 정보는 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_Virtual01'
);
result.addAction(action); // 매핑 정보가 담긴 Action을 Result에 추가
}
return result;
Method
addAction(SBLS.DataSourceService.Action action)
매핑 정보가 담긴 Action 객체를 Result 객체에 추가합니다.
리스트와 데이터소스 값을 매핑한 정보를 담은 객체입니다.
SBLS.DataSourceService.Action
리스트와 데이터소스 값을 매핑한 정보를 담은 객체입니다.
예시 코드
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_Virtual01' // 가상 열 API명
);
result.addAction(action); // 매핑 정보 추가
}
return result; // 최종 결과 반환
Method
setKeyValue(Object keyValue)
리스트의 Key와 일치하는 데이터소스의 Key 값을 설정합니다.
putSourceToTargetField(Object sourceValue, String targetFieldApiName)
데이터소스 값을 원하는 리스트 필드 또는 가상 열에 할당합니다.
리스트의 필드 또는 가상 열의 API명입니다.
