소스 보기

page no.

해당 문서는 유효성 검사 API에 대해 다루고 있습니다. 해당 API는 제품의 릴리즈 버전에 따라 사양이 상이하니, 버전을 확인하시어 알맞는 API를 사용하세요.

지원 버전	API	기타
7.0.500.20241031-11 이전	Validate API
7.0.500.20241114-11 이후	ValidateEx API	기존 Validate API 는 자동 완성 및 API Document 에서 삭제되어 사용할 수 없습니다. 해당 API는 checkInputSetting의 기본값이 true 이며, 유효성 검사 실행 시 사용자가 UI를 통해서 설정한 유효성 검사를 수행합니다.

기능 설명
1. DataGrid에서 지원하는 유효성 검사 API의 parameter가 추가 혹은 변경되었습니다.
  1. Validate API가 변경되었습니다.
    - parameter : ignoreRowState(default = false), checkInputSetting(default = false)
  2. ValidateEx API가 추가되었습니다.
    - parameter : ignoreRowState(default = false), checkInputSetting(default = true)
2. 유효성 검사 API가 갖는 파라미터의 옵션은 다음과 같습니다.
  1. ignoreRowState(boolean) : DataRow의 RowState값이 null 이어도 validate 체크를 진행합니다.
  2. checkInputSetting(boolean) : 컬럼 키 유형(Not null, Primary key 등)에 따라 값이 null인지 체크하고 사용자가 설정한 유효성 검사의 validate를 검사할지 여부를 정합니다.
실행 경로
1. i- AUD 디자이너 > Script Editor 실행 > DataGrid의 Validate() API를 이용한 스크립트를 작성합니다.

사용 방법

적용 결과

Validate API

ignoreRowState 값이 true일 때 : 그리드의 첫번째 record의 RowState가 ' ' 이어도 validate 체크합니다.

/**************************************
 * 버튼 컨트롤이 클릭되는 시점에 발생합니다.
 * * arguments :  
 *      string Id (Readonly:False) : 컨트롤이름 
 *      string Text (Readonly:False) : 라벨 값 
**************************************/
 var OnButtonClick  = function(sender, args){
    Matrix.getObject("DataGrid").Validate(true)
 };

연구 개발 매뉴얼 > [i-AUD] DataGrid에서 지원하는 유효성 검사 API의 parameter가 추가 및 변경되었습니다. > image2024-11-26_14-30-22.png

checkInputSetting값이 true일 때 : 그리드 유효성 검사 설정에 부합되지 않은 값을 체크합니다.

/**************************************
 * 버튼 컨트롤이 클릭되는 시점에 발생합니다.
 * * arguments :  
 *      string Id (Readonly:False) : 컨트롤이름 
 *      string Text (Readonly:False) : 라벨 값 
**************************************/
 var OnButtonClick  = function(sender, args){
    Matrix.getObject("DataGrid").Validate(true,true)
 };

연구 개발 매뉴얼 > [i-AUD] DataGrid에서 지원하는 유효성 검사 API의 parameter가 추가 및 변경되었습니다. > image2024-11-26_14-50-32.png

ValidateEx API

ignoreRowState 값이 true일 때 : 그리드의 첫번째 record의 RowState가 '' 이어도 validate 체크합니다.

/**************************************
 * 버튼 컨트롤이 클릭되는 시점에 발생합니다.
 * * arguments :  
 *      string Id (Readonly:False) : 컨트롤이름 
 *      string Text (Readonly:False) : 라벨 값 
**************************************/
 var OnButtonClick  = function(sender, args){
    Matrix.getObject("DataGrid").ValidateEx(true)
 };

checkInputSetting값이 true일 때 : 그리드 유효성 검사 설정에 부합되지 않은 값을 체크합니다.

/**************************************
 * 버튼 컨트롤이 클릭되는 시점에 발생합니다.
 * * arguments :  
 *      string Id (Readonly:False) : 컨트롤이름 
 *      string Text (Readonly:False) : 라벨 값 
**************************************/
 var OnButtonClick  = function(sender, args){
    Matrix.getObject("DataGrid").ValidateEx(true,true)
 };

유효성 검사 팝업 창에 필드 별로 Validate API 실행 시 적용 여부를 설정할 수 있는 속성이 추가되었습니다.

연구 개발 매뉴얼 > [i-AUD] DataGrid에서 지원하는 유효성 검사 API의 parameter가 추가 및 변경되었습니다. > image2024-11-12_19-22-15.png

제한 방법이 "None"일 경우 해당 필드는 grid의 Validate API 실행 시 유효성 검사를 수행하지 않습니다.

기능 정보	API Open	UI Open	Read Only	Not Use	Hidden	Not Recommend	해당 없음
시작 버전 정보	Release No : 7.0.500.20241004-11 (Validate API) Release No : 7.0.500.20241114-11 (ValidateEx API)

(BCRMD3576) Excel File Upload 후, DataGrid Validate관련 문의드립니다.

(BCRM#E3604) [i-AUD]Grid유효성 검사에서 제한 방법에 "모든값"을 추가 요청합니다.