페이지 트리
메타 데이터의 끝으로 건너뛰기
메타 데이터의 시작으로 이동

page no.   79405864

Start Release No : 7.0.500.20241114-11 / Update Release No : 7.0.500.20241114-11

작성자 :  김민규 / 검수자 :  이승우

  

이전 버전 사용 안내

해당 문서는 유효성 검사 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. 기능 설명
    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를 검사할지 여부를 정합니다. 
       
  2. 실행 경로
    1. i- AUD 디자이너 > Script Editor 실행 > DataGrid의 Validate() API를 이용한 스크립트를 작성합니다.

  3. 사용 방법
    1. 적용 결과
      1. Validate API

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

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

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

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

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

          sample code
          /**************************************
           * 버튼 컨트롤이 클릭되는 시점에 발생합니다.
           * * arguments :  
           *      string Id (Readonly:False) : 컨트롤이름 
           *      string Text (Readonly:False) : 라벨 값 
          **************************************/
           var OnButtonClick  = function(sender, args){
              Matrix.getObject("DataGrid").ValidateEx(true)
           };
        2. checkInputSetting값이 true일 때 : 그리드 유효성 검사 설정에 부합되지 않은 값을 체크합니다.

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


(공통) 필드별 Validate API 실행 시 적용 여부 설정

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

제한 방법이 "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)