New

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 리턴 시 지정한 이벤트가 발생하지 않습니다. 

NameTypeRequiredDescription
OnChangeBoolean선택setValue시 발생하는 OnChange 이벤트 발생 여부를 제어합니다. true 리턴시 해당 이벤트가 발생하지 않습니다. (default:0(false))
OnSameBoolean선택setValue시 발생하는 OnSame 이벤트 발생 여부를 제어합니다. true 리턴시 해당 이벤트가 발생하지 않습니다. (default:0(false))
onEndEditBoolean선택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
     }
})



Fixed

1. doFilter로 타임스탬프 값으로 필터링 시 NaN으로 표기 되는 문제 수정 .


2. Date타입의 열의 필터다이얼로그에서 구간 필터('20151201~20170101')가 동작하지 않던 문제 수정   

Ver 8.2.0.19-20250206-14 이상의 css, locale 파일이 필요합니다.


3. setAttributeButton 속성을 변경할 경우 기존에 설정된 이미지가 남아있는 현상 수정   


4. group행의 항목들 간 간격이 사라진 문제 수정  


5. SearchMode: 0에서 GroupSortMain을 설정할 경우 에러가 발생하던 문제 수정   


6. SelectingCells: 0 설정 시 선택된 행 단위로 복사 / 붙여넣기 동작이 이루어지도록 변경  


7. ChangeEdit:0, AddEdit:1가 설정 시 저장 후 편집불가 상태인 Enum열의 아이콘이 표시되던 현상 수정 


8. 열 이동 시 (Cell) Span의 값이 초기화되는 현상 수정 


9. default css를 불러오지 않을 경우 찾기 다이얼로그의 디자인이 깨지는 문제 수정