1. doSave, getSaveJson, getSaveString시 유효성 검사를 할 수 있는 onValidation 이벤트 추가
doSave, getSaveJson, getSaveString 등 저장 api 호출시, 사용자가 저장할 값들에 관해 유효성 검사를 진행할 수 있도록 셀 별로 순회하며 발생하는 이벤트 입니다.
기본적인 필수입력 항목에 대한 확인이나 전체 입력 여부에 대한 확인은 저장 전에 시트가 내부적으로 확인하지만, 업무 로직에 따라 발생할 수 있는 각종 유효성 검사를 이 이벤트에서 처리합니다.
[사용 예시]
options.Events = {
onValidation
: function (evtParam) {
if (evtParam.col != "TextData") return false;
var prevCol = evtParam.sheet.getPrevCol(evtParam.col);
// TextData 컬럼의 이전 컬럼 값이 100보다 큰 경우 메세지창을 띄우고 저장을 중단합니다.
if (evtParam.sheet.getValue(evtParam.row, prevCol) >= 100) {
var index = evtParam.sheet.getRowIndex(evtParam.row);
evtParam.sheet.showMessageTime({
message: index + "행 정수(Int)컬럼 셀 값이 100보다 큽니다.",
time: 10000,
buttons: ["OK", "취소"],
})
return true;
}
}
}2. onBeforeSave 이벤트에 source.params(소문자) 추가
이벤트 내부 인자의 통일성을 위해 기존 Params에서 params 로 첫글자가 소문자로 변경되었습니다.
3. (Method)setValue 호출 시 이벤트 발생 여부를 제어할 수 있는 ignoreEvent 인자 추가
setValue 호출 시 ignoreEvent 설정을 통해 제어할 수 있는 각 이벤트의 사용방법은 아래와 같습니다.
인자로 Json 형태로 옵션 세팅이 가능하며, 이벤트 이름을 key 값으로 넣고, true 리턴 시 지정한 이벤트가 발생하지 않습니다.
| Name | Type | Required | Description |
|---|---|---|---|
| OnChange | Boolean | 선택 | setValue시 발생하는 OnChange 이벤트 발생 여부를 제어합니다. true 리턴시 해당 이벤트가 발생하지 않습니다. (default:0(false)) |
| OnSame | Boolean | 선택 | setValue시 발생하는 OnSame 이벤트 발생 여부를 제어합니다. true 리턴시 해당 이벤트가 발생하지 않습니다. (default:0(false)) |
onEndEdit | Boolean | 선택 | setValue시 발생하는 onEndEdit 이벤트 발생 여부를 제어합니다. true 리턴시 해당 이벤트가 발생하지 않습니다. (default:0(false)) |
[사용 예시]
var setRow = sheet.getRowById("AR5")
sheet.
setValue
({
row: setRow,
col: "sName",
val: "홍길동",
ignoreEvent : {
OnChange: true, // setValue 시 OnChange 발생x
OnSame: true // setValue 시 OnSame 발생x
}
})1. doFilter로 타임스탬프 값으로 필터링 시 NaN으로 표기 되는 문제 수정 .
2. Date타입의 열의 필터다이얼로그에서 구간 필터('20151201~20170101')가 동작하지 않던 문제 수정
Ver 8.2.0.19-20250206-14 이상의 css, locale 파일이 필요합니다.