onBeforeDataLoad (event)

서버를 호출하여 데이터가 시트에 로드되기 전 발생하는 이벤트 입니다.
doSearch, doSearchPaging, loadSearchData 함수를 통해 가져온 데이터가 시트 내부에서 파싱되기 전에 발생합니다.
파싱이 완료된 이후에는 onDataLoad이벤트가 발생합니다.

Syntax

    onBeforeDataLoad:function(paramObject) {

    }
or
    sheet.bind("onBeforeDataLoad" , function(paramObject) {});

Parameters

Name Type Description
sheet object 데이터를 로딩할 시트 객체
result string 1. 서버를 통한 조회 시(doSearch)
0 : 성공
-1 : 빈 URL (예: sheet.doSearch(""))
-3 : 400이상의 HTTP 상태 코드
-5 : 응답 없음
-6 : 연결 시간 초과
-7 : 잘못된 데이터 형식
이외: 사용자 정의 코드

2. 일반 데이터 조회 시(loadSearchData))
0 : 성공
-7 : 잘못된 데이터 형식
data object 시트에 로딩될 데이터
message string 조회 결과 json에 포함된 Message 내용
response object response 객체
type string 조회/엑셀 여부(Search, EXCEL)

Return

none

Example

// 조회 후 오류에 대한 예시
options.Events = {
    onBeforeDataLoad:function(evtParam){
        if (evtParam.row["result"] < 0) {
            alert("오류가 발생하였습니다\n"+evtParam.message);
        }
    }
}


// 조회된 내용에 대한 수정 예시
options.Events = {
    onBeforeDataLoad:function(evtParam){
        // 조회 결과 데이터
        var DATA = evtParam.data;
        // 조회된 데이터 일부를 수정한다.
        for(var i = 0; i < DATA.length; i++){
            var row = DATA[i];
            // AttrYn 컬럼에 값이 Y 인 경우 ConfirmFinish 컬럼에 "결정완료"를 설정하고
            // 해당 행의 Edit를 막는다. (수정된 데이터에 대한 별도 리턴은 필요 없음[CallByReference])
            if(row["AttrYn"] == "Y"){
                row["ConfirmFinish"] = "결정완료";
                row["CanEdit"] = 0;
            }
        }
    }
}
// 조회 결과 json 참고
{
    //IO,Result,Message 대소문자 주의!
    "IO":{"Result":100,"Message":"정상조회완료"},
    "Data":[ ... ]
}

Read More

Since

product version desc
core 8.0.0.0 기능 추가
core 8.0.0.26 type 추가