페이지 트리

버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.
댓글: 버전에 따라 적용되는 API가 상이함을 명시하고, 가이드를 정비하였습니다.

page no.  

Showpageid

Start Release No : 7.0.

400

500.

20240104

20241114-11 / Update Release No : 7.0.500.

20241004

20241114-11

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


  

경고
title이전 버전 사용 안내

해당 문서는 유효성 검사 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)
        API 내에 ignoreRowState
        • , checkInputSetting
        파라미터가
        • (default = false)
      2. ValidateEx API가 추가되었습니다.
          
    사용 방법
    1. 구성
      1. DataGrid.Validate(ignoreRowState, checkInputSetting);
        ignoreRowState: boolean,
    2. 실행 경로 
      1. i- AUD 디자이너에서 Script Editor 실행 > DataGrid의 Validate() API를 이용한 스크립트를 작성합니다.
          
          • parameter : ignoreRowState(default = false), checkInputSetting(default = true)

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

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

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

          체크하는 화면 예제입니다
          1. 체크합니다.

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

            Image Added

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

          체크하는 화면의 예제입니다
          1. 체크합니다. 

          Image Removed 도움말title
          1. 코드 블럭
            languagejs
            titlesample code
            linenumberstrue
            /**************************************
             * 버튼 컨트롤이 클릭되는 시점에 발생합니다.
             * * arguments :  
             *      string Id (Readonly:False) : 컨트롤이름 
             *      string Text (Readonly:False) : 라벨 값 
            **************************************/
             var OnButtonClick  = function(sender, args){
                Matrix.getObject("DataGrid").Validate(true,true)
             };

            Image Added

                   

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

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


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

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



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

    유효성 검사 팝업 창에 필드 별로 Validate API 실행 시 적용 여부를 설정할 수 있는

    속성을 추가했습니다

    속성이 추가되었습니다.

    Image Removed

    해당 속성이 true일 경우, grid의 Validate API 실행 시 유효성 검사에 적용됩니다. 해당 속성이 false일 경우,

    Image Added

    제한 방법이 "None"일 경우 해당 필드는 grid의 Validate API 실행 시 유효성

    검사에 적용되지

    검사를 수행하지 않습니다.

    기본 값은 true(사용)입니다.



    기능 정보
    •  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)


    페이지 속성
    hiddentrue


    정보
    title문서 수정 이력
    변경 이력

    하위 페이지 표시
    alltrue


    정보
    titleBCRM 정보


    (BCRMD3576) Excel File Upload 후, DataGrid Validate관련 문의드립니다.
    (BCRM#E3604) [i-AUD]Grid유효성 검사에서 제한 방법에 "모든값"을 추가 요청합니다.