농부지기

/*==+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 * Group : 2. 각 개별적으로 호출되는 validation 검사
 **=++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*/

/******************************************************************************************
 * 기능 : 값이 NULL인지 검사
 * 인자 : val - 검사하고 싶은 값
 * 리턴 : true / false
 * 예문 :
 *****************************************************************************************/

function gfn_IsNull(val)

{

    var sVal = new String(val);

    if (sVal == null || sVal == "NaN" || sVal == "null" || sVal.trim().length <= 0 || escape(sVal) == "undefined"){

        return true;

    }else{

        return false;

    }

}

/******************************************************************************************
 * 기능 : 값이 존재하는지 체크
 * 인자 : val - 검사하고 싶은 값
 * 리턴 : true / false
 * 예문 :
 *****************************************************************************************/

 function gfn_IsExist(val)

{

    if (gfn_IsNull(val)){

        return false;

    }else{

        return true;

    }

}

/******************************************************************************************
 * 기능 : 값이 존재하는지 여부 체크 (zero도 null 로 판단)
 * 인자 : val : null 을 검증해야 될 값
 * 리턴 : true / false
 * 예문 :
 *****************************************************************************************/

function gfn_IsNullZero(val)

{

    var sVal = new String(val);

    sVal = sVal.trim();

    if(gfn_IsNull(val) == true || sVal == "0" || sVal == "0.0" || sVal == "0.00" || sVal == "0.000"){

        return true;

    }else{

        return false;

    }

}

/******************************************************************************************

 * 기능 : 그룹별 SUM 구하여 검사하고 싶은 MAX값보다 크면 해당 ROW를 RETURN

 * 인자 : objDs       - 검사할 dataset

 *         psGrpCol   - Group을 묶어서 검사할 컬럼 리스트

 *         psSumCol   - 합계용 컬럼

 *         pnMinValue  - 최소값

 *         pnMaxValue - 최대값

 * 리턴 : -1           : 정상

 *         0보다 크면 : 해당 오류 ROW임

 * 예문 : gfn_bpCheckGroupSum(dsExceptShop, "SHOP_CD,IMP_CD", "CLASS_RATT", 100, 100);

 *         "SHOP_CD,IMP_CD" 2개의 컬럼 그룹별로  SUM(CLASS_RATT:율) 합이 : 최소100, 최대100 이여야 함.

 *****************************************************************************************/

function gfn_CheckGroupSum(objDs, psGrpCol, psSumCol, pnMinValue, pnMaxValue){

    var arrGrpCol = psGrpCol.split(",");

    var sFindExpr, nFindRow, nSumValue;

    pnMinValue = toNumber(pnMinValue);

    pnMaxValue = toNumber(pnMaxValue);

    for(var nRow=0; nRow < objDs.getRowCount(); nRow++){

        sFindExpr = "";

        for(var ii=0; ii<arrGrpCol.length; ii++){

            if (ii==0)

                sFindExpr += arrGrpCol[ii] + "=='" + objDs.getColumn(nRow, arrGrpCol[ii]) + "'";

            else

                sFindExpr += " && " + arrGrpCol[ii] + "=='" + objDs.getColumn(nRow, arrGrpCol[ii]) + "'";

        }

        nSumValue = 0;

        nFindRow  = -1;

        do{

            nFindRow = objDs.findRowExpr(sFindExpr, nFindRow + 1);

            if (nFindRow < 0) break;

            nSumValue += toNumber(objDs.getColumn(nFindRow, psSumCol));

        }while(true);

        if (pnMinValue > nSumValue || nSumValue > pnMaxValue){

            return nRow;

        }

    }

    return -1;

}

/******************************************************************************************
 * 기능 : 여러개의 레코드에서 연속된 FROM~TO 일자가 존재 할 경우 검사
 * 인자 : objDs        - 검사할 dataset
 *         psGrpCol     - 그룹으로 묶을 컬럼목록
 *         psDtFormat   - 시작~종료가 년, 년월, 년월 구분값(YEAR, YM, YMD)
 *         psContYn     - 위라인 종료일자와 현재라인 시작일자간 계속연결여부
 *                        (Y - 날자가 계속 연결되어야 됨.      (위 라인.종료일자+1 = 현재라인.시작일자  이면 정상)
 *                         N - 날자가 계속 연결되지 않아다 됨. (위 라인.종료일자   < 현재라인.시작일자  이면 정상)
 * 리턴 : -1           : 정상
 *         0보다 크면 : 해당 오류 ROW임
 * 예문 :
 * 화면컬럼 : 부서, 매장, 판매방법, 시작일자 ,  종료일자
 *             A001 , 111  , 1        , 2013.01.01,  2013.06.01
 *             A001 , 111  , 1        , 2013.06.02,  2013.08.01
 *             A001 , 111  , 1        , 2013.08.01,  2014.01.15   <--이부분에서 오류 처리.  시작일자 2013.08.01은 위쪽 시작~종료일자에 포함 되므로.
 *             B001 , 111  , 1        , 2013.01.01,  2013.06.01
 *
 * 필수처리 : 시작~종료일자는 반드시 필수 이면서,  일자검사(년, 년월, 년월일,  최소값, 최대값)는 마친 후에 호출 해야 됨
 *****************************************************************************************/

function gfn_CheckGroupFromToDate(objDs, psGrpCol, psDateCol, psDtFormat, psContYn){

    var nRowCnt = objDs.rowcount;

    if (nRowCnt == 0) return -1;

    psDtFormat = psDtFormat.toUpperCase();

    var aGrpCol  = psGrpCol.split(',');

    var aDateCol = psDateCol.split(',');

    var sFromDt, sToDt, sNextDt;

    // 1. 컬럼 그룹별, 날짜별로 정렬

    var sKeyString = "S:";

    for(var ii=0; ii<aGrpCol.length; ii++){

        sKeyString = sKeyString + "+" + aGrpCol[ii];

    }

    for(var ii=0; ii<aDateCol.length; ii++){

        sKeyString = sKeyString + "+" + aDateCol[ii];

    }

    objDs.keystring = sKeyString;

    //------------------------------------------------------------------

    // 3. 이전ROW와 현재 ROW간에 일자 검사 (0 row는 skip)

    //------------------------------------------------------------------

    var bSame;

    for(var nRow=1; nRow<nRowCnt; nRow++){

        // a. 위쪽ROW와 현재ROW간에 그룹컬럼값들이 동일하지 검사

        //    --동일하면 : 위쪽ROW.종료일자 와 현재ROW.시작일자간 검사

        bSame = true;

        for(var ii=0; ii<aGrpCol.length; ii++){

            if (objDs.getColumn(nRow-1, aGrpCol[ii]) != objDs.getColumn(nRow, aGrpCol[ii])){

                bSame = false;

                break;

            }

        }

        if (bSame == false) continue;

        // b. 현재 ROW에 대한 시작일자 < 종료일자 검사

        sFromDt = objDs.getColumn(nRow, aDateCol[0]);

        sToDt   = objDs.getColumn(nRow, aDateCol[1]);

        if (sFromDt > sToDt){

            alert("시작일자가 종료일자보다 더 클 수 없습니다.");

            return nRow;

        }

        // c. 위쪽ROW와 현재ROW간에 그룹컬럼값들이 동일하므로 검사

        sToDt   = objDs.getColumn(nRow-1, aDateCol[1]);

        sFromDt = objDs.getColumn(nRow  , aDateCol[0]);

        if (psDtFormat == "YEAR"){

            sNextDt = (toNumber(sToDt) + 1).toString();

        }else if(psDtFormat == "YM"){

            sNextDt = gfn_AddMonth(sToDt, 1);

        }else if(psDtFormat == "YMD"){

            sNextDt = gfn_AddDate(sToDt, 1);

        }

        if (psContYn == 'Y'){

            if (sNextDt != sFromDt){

                alert("종료일자와 시작일자가 연속으로 입력되지 않았습니다.");

                return nRow;

            }

        }else{

            if (sNextDt > sFromDt){

                alert("종료일자와 시작일자가 연속으로 입력되지 않았습니다..");

                return nRow;

            }

        }

    }

    return -1;

}

☞  

☞  

1. dataset 컬럼 및  체크 값

    - expr : 컬럼에 검사방법에 대한 사항을 입력

2. source

function fn_OnLoadInit()

{

      gfn_SetGridValidation(dsGridValidation, divDataArea.grdEvalList, dsTerm);  // 3. Grid validation 사용시 index를 사용

}

function fn_SaveValidate()

{

    // 1. 수정여부 검사

    if (gfn_CheckDsModified(dsEvalList) == false) return false;

    ...

    // 9. 검사

    if (gfn_ValidateGrid(dsGridValidation, divDataArea.grdEvalList) == false) return false;

    return true;

}

3. 참고

   1.  gfn_SetGridValidation 을 사용했던 이유는   gfn_ValidateGrid()함수가 grid의 index를 이용해서 했기 때문에

        차후 개발시 gfn_ValidateGrid()함수에서 컬럼값으로 처리하는 방법으로 수정 필요

/******************************************************************************************
 * 기능 : 사용자가 입력한 Dataset에 대한 validation check
 * 인자 : objGrd       :  화면에 보여주고 있는 Grid name
           objDsChkType : 검사할 check 목록된 기록된 Dataset
           bChkBoxExist : Grid 맨 왼쪽에 check box가 존재 시 check 된 자료만 검사할지 여부
                          이때 check column은 Grid에서 맨 앞쪽(0 index)에 위치되어져 있어야 함.
           bAllRowChk   : Dataset에서 모든 row를 검사 할지 여부 (false일 경우 insert,update된 row만 검사)
 * 리턴 : true/false
 * 예문 :
 * 개발 : 김용학.
 * objDsChkType 컬럼리스트 : colId   :  colNm    :  checkType                 : message : messageViewYn
 *              컬럼값     : EMP_NO  :  사원번호 : Required;Duplicate=EMP_NO :         :
                             EMP_NM  :  사원명   : Required;                 :         :
                             REG_NO  :  주민번호 : Required;MinLen=13;MaxLen=13    :         :
 *****************************************************************************************/

//------------------------------------------------------------------------------------------------
// 데이터셋에 선언해놓은 여러건에 대한 정보 체크
// dsChkGrid.check 컬럼 값 예 : Required;Date=YYYY;                       [ 필수이면서 년도 검사]
//                               Date=YYYY;                                [년도     검사]
//                               Date=YYYYMM;                              [년.월    검사]
//                               Date=YYYYMMDD;                            [년.월.일 검사]
//                               Compare=lessEqual,계획종료월,PLAN_EYM;  [ (날짜 대소 비교 가능) (fromDate <= toDate 이면 정상) ]
//                               Compare=less,     계획종료월,PLAN_EYM;  [ (날짜 대소 비교 가능) (fromDate <  toDate 이면 정상) ]
//                               CondRequired=FIX_YN:Y,PLAN_YY,SALE_NO    [ (특정조건일 경우 만 필수)  ]
//                                          (위와 같을 경우 FIX_YN='Y' 일경우 필수 && PLAN_YY 값이 존재 하면 필수 && PLAN_CD 값이 존재 하면 필수
//                               Duplicate=BRAND_CD,DTL_PLAN_CD           [ 컬목 목록만틈 중복 중복 검사 ]
//                               Between=201311,201502                    [ 문자 TYPE 인 경우 가능.  숫자가 가능할 수 있음 ]
//                               BetweenNum=201311,201502                  [ 숫자 type 만 가능 ][Between A AND B 검색]
//------------------------------------------------------------------------------------------------
// 향후 개발해야 될 check목록 : 주민번호 검사 (Resident)
//                                 email 형식     (Email)
//                                 MinLen  : 최소 length (문자에 활용됨) (MinLen=5)
//                                 MaxLen  : 최대 length (문자에 활용됨) (MaxLen=15)
//                                 MinValue : 최소값 (숫자에 활용됨) (MinValue=10)
//                                 MaxValue : 최대값 (숫자에 활용됨) (MaxValue=999)
//                                 MinDate  : 최소년도, 최소년월, 최소일자  (MinDate=YYYY,2014; MinDate=YYYYMM,201405; Mindate=YYYYMMDD,20140505;)
//                                 MaxDate  : 최대년도, 최대년월, 최대일자  (MaxDate=YYYY,2014; MaxDate=YYYYMM,201405; MaxDate=YYYYMMDD,20140505;)
//                                 
//------------------------------------------------------------------------------------------------

function gfn_DataValidation(objGrd:Grid, objDsChkType:Dataset, bChkBoxExist:Boolean , bAllRowChk:Boolean ) {

    var sChkColId, sColId, sColNm, sCheckType, arrCheckType, sMessage, sGubun, sMessageViewYn;

    var sFunction = "";

    var objBusiDs     = eval(objGrd.binddataset);

    var nBusiDsCnt    = objBusiDs.rowcount;

    var nChkTypeDsCnt = objDsChkType.rowcount;

    var nRowType;

    if(gfn_IsNull(bChkBoxExist)) bChkBoxExist = false;

    if(gfn_IsNull(bAllRowChk))   bAllRowChk = false;

    if(  bChkBoxExist == true ) {

        sChkColId = objGrd.getCellProperty("body",0,"text");

        sChkColId = sChkColId.replace("bind:","");

    }

    if(nChkTypeDsCnt <= 0 || nBusiDsCnt <= 0 ) return true;

    // 0. 업무 Dataset별로 수행

    for(var nRow = 0 ; nRow < nBusiDsCnt ; nRow ++ ) {

        nRowType = objBusiDs.getRowType(nRow);

        if (nRowType == Dataset.ROWTYPE_NORMAL && bAllRowChk == false) continue;

        for(var i = 0 ; i < nChkTypeDsCnt ; i ++ ) {

            sColId         = objDsChkType.getColumn(i,"colId"        );

            sColNm         = objDsChkType.getColumn(i,"colNm"        );

            sCheckType     = objDsChkType.getColumn(i,"checkType"    );

            sMessage       = objDsChkType.getColumn(i,"message"      );

            sMessageViewYn = objDsChkType.getColumn(i,"messageViewYn");  //검사 후 오류가 있으면 alert()을 보여줄지 말지 여부

            if (gfn_IsNull(sColId) || gfn_IsNull(sCheckType)) continue;

            // 1.함수 호출

            if(sColId == "func") {

                if (typeof eval(sCheckType) == "function"){

                    // 존재시 함수 호출

                    if(eval( sCheckType ).call(this,objBusiDs,nRow) == false )

                        return false;

                }

            }else{

                if(((bChkBoxExist == false) || bChkBoxExist == true && objBusiDs.getColumn(nRow,sChkColId) == '1')){

                    arrCheckType = sCheckType.split(";");

                    // 체크 부분 (체크 방법이 여러건 존재)

                    for(var k = 0 ; k < arrCheckType.length ; k ++ ) {

                        if(gfn_IsExist(arrCheckType[k].trim())){

                            // 변수 값에 "=" 이 존재 가능하기때문에

                            if(arrCheckType[k].indexOf("=")  > -1 ) {

                                sFunction = "gfn_DataValidation_" + arrCheckType[k].substring(0,arrCheckType[k].indexOf("="));

                                sGubun    = arrCheckType[k].substr(arrCheckType[k].indexOf("=") + 1);

                            }else {

                                sFunction = "gfn_DataValidation_" + arrCheckType[k];

                                sGubun    = "";

                            }

                            //해당  Function 존재 여부 체크

                            if (typeof eval(sFunction) == "function"){

                                // 존재시 함수 호출

                                if(eval( sFunction ).call(this,sColId, sColNm, objBusiDs, nRow, sGubun, sMessage, sMessageViewYn) == false ) {

                                    objBusiDs.rowposition = nRow;

                                    return false;

                                }

                            }

                        }

                    }  // for end

                }

            } // if end

        }// for end

    }

    return true;

}

/******************************************************************************************
 * 기능 : 필수값 체크
 * 인자 : sColId  : column id
           sColNm : 컬럼 한글명
           objDs  : 업무 dataset
           nRow   : 검사중인 row
           sGubun : 검사방법 (옵션)
           psMessage  : 메세지 옵션) - 미 존재 시 .. 임으로 alert처리.  존재 시 (화면에서 개발자가 지정한 message로 조회)
 * 리턴 : true/false
 * 예문 :
 *****************************************************************************************/

function gfn_DataValidation_Required(sColId, sColNm, objDs, nRow ,sGubun, psMessage, psMessageViewYn){

    var sColValue = String(objDs.getColumn(nRow , sColId)).trim();

    if(gfn_IsExist(sGubun) ) {

        // 필수 체크 시 sGubun에 대한 컬럼값이 존재 할 경우만 필수체크 처리

        // 즉, sGubun값이 미 존재 하면 필수 체크 안함

        var sTagetValue = objDs.getColumn(nRow, sGubun);  

        if(gfn_IsNull(sTagetValue)) {

            if(gfn_IsNull(sColValue) ) {

                gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + " 은(는) 필수 항목 입니다.");

                return false;

            }

        }

    } else {

        if(gfn_IsNull(sColValue) ) {

            gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + " 은(는) 필수 항목 입니다.");

            return false;

        }

    }

    return true;

}

/******************************************************************************************
 * 기      능 : 날짜 확인 로직
 * 인      자 :
 * 반      환 : sGubun - YYYY,YYYYMM,YYYYMMDD, (lessEqual,계획종료월,PLAN_EYM)
 *****************************************************************************************/

function gfn_DataValidation_Date(sColId,sColNm,objDs,nRow ,sGubun, psMessage, psMessageViewYn){

    var strDate = String(objDs.getColumn(nRow , sColId)).trim();

    if (gfn_IsNull(strDate)) return true;

    strDate = strDate.replace('.', '');

    strDate = strDate.replace('-', '');

    strDate = strDate.replace('/', '');

    if (strDate.length == 4) strDate = strDate + '0101';

    if (strDate.length == 6) strDate = strDate + '01'  ;

    // 1. 단순일자 검사

    if (sGubun == "YYYY" || sGubun == 'YYYYMM' || sGubun == 'YYYYMMDD'){

        if(gfn_IsDate(strDate) == false) {

            gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + "가(이) 정확하지 않습니다.");

            return false;

        }

        return true;

    }

    return true;

}

/******************************************************************************************
 * 기      능 : 두개 컬럼 비교
 *****************************************************************************************/

function gfn_DataValidation_Compare(sColId,sColNm,objDs,nRow ,sGubun, psMessage, psMessageViewYn){

    var sColValue = String(objDs.getColumn(nRow , sColId)).trim();

    var arrVal    = sGubun.split(",");

    // 1. 첫 번째 값 처리

    if (gfn_IsNull(sColValue)) return true;

    // 2. 두 번째 값 처리

    var sSecondValue = objDs.getColumn(nRow, arrVal[2]).trim();

    if (gfn_IsNull(sSecondValue)) return true;

    //3. 두 개 컬럼 대소 비교 (첫번째 일자 <= 두번째 일자)

    if (arrVal[0] == "lessEqual"){

        if (sColValue > sSecondValue){

            gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + "는(은) " + arrVal[1] + " 보다 더 클 수 없습니다.");

            return false;

        }

    }else if (arrVal[0] == "less"){

        if (sColValue >= sSecondValue){

            gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + "는(은) " + arrVal[1] + " 보다 더 크거나 같을 수 없습니다.");

            return false;

        }

    }

    return true;

}

/******************************************************************************************
 * 기      능 : 한 값이 존재 또는 특정 값 일 경우 필수 처리
 * 인      자 :
 * 반      환 : sGubun - CondRequired=FIX_YN:Y,PLAN_YY,PLAN_CD
 *                         (위와 같을 경우 FIX_YN='Y' 일경우 필수 && PLAN_YY 값이 존재 하면 필수 && PLAN_CD 값이 존재 하면 필수
 *****************************************************************************************/

function gfn_DataValidation_CondRequired(sColId,sColNm,objDs,nRow ,sGubun, psMessage, psMessageViewYn){

    var strDestVal = String(objDs.getColumn(nRow, sColId)).trim();

    var aColList   = sGubun.split(",");

    var aEssentialYN = "N";  //일단 sColId 에 미 필수 항목이라고 처리

    // 1. 값이 존재 하면 정상

    if (gfn_IsExist(strDestVal)) return true;

    // 2. 각 체크할 컬럼 처리

    for(var ii=0; ii<aColList.length; ii++){

        var aRealColList = aColList[ii].split(":");

        var strColVal    = objDs.getColumn(nRow, aRealColList[0]);

        // 1. 특정컬럼값이 null이면.. 필수 아님

        if (aRealColList.length == 1){

            if (gfn_IsNull(strColVal)){

                return true;

            }else{

                gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + " 은(는) 필수 항목 입니다.");

                return false;

            }

        // 2. 특정컬럼값이 null이 아니면서 특정값 이면 필수

        }else if (aRealColList.length == 2){

            if (gfn_IsNull(strColVal)) return true;

            if (strColVal == aRealColList[1]){

                gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + " 은(는) 필수 항목 입니다.");

                return false;

            }

        }

    }

    return true;

}

/******************************************************************************************
 * 기      능 : 중복 검사
 *****************************************************************************************/

function gfn_DataValidation_Duplicate(sColId,sColNm,objDs,nRow ,sGubun, psMessage, psMessageViewYn){

    var aColList = sGubun.split(",");

    var sFildCond, sColValue, nFindRow;

    sFildCond = aColList[0] + "=='" + objDs.getColumn(nRow, aColList[0]) + "'";

    for(var ii=0; ii<aColList.length; ii++){

        sFildCond += "&& " + aColList[ii] + "=='" + objDs.getColumn(nRow, aColList[ii]) + "'";

    }

    nFindRow = objDs.getCaseCount(sFildCond);

    if (nFindRow > 1){

        gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, "중복된 건이 발견되었습니다.");

        return false;

    }

    return true;

}

/******************************************************************************************
 * 기      능 : 날짜 비교 로직
 *****************************************************************************************/

function gfn_DataValidation_DateLt(sColId,sColNm,objDs,nRow ,sGubun, psMessage, psMessageViewYn){

    if(gfn_IsNull(sColValue) ) {

        gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + " 을 확인 하십시오.");

        return false;

    }

    return true;

}

/******************************************************************************************
 * 기      능 : Between A AND B 검색
 *****************************************************************************************/

function gfn_DataValidation_Between(sColId,sColNm,objDs,nRow ,sGubun, psMessage, psMessageViewYn){

    var sColValue = String(objDs.getColumn(nRow , sColId)).trim();

    var arrVal    = sGubun.split(",");

    // 1. 첫 번째 값 처리

    if (gfn_IsNull(sColValue)) return true;

    // 2. Between 검색

    if (arrVal[0] > sColValue || sColValue > arrVal[1]){

        gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + "는(은) " + arrVal[0] + " ~ " +  arrVal[1] + " 사이만 가능합니다.");

        return false;

    }else{

        return true;

    }

}

/******************************************************************************************
 * 기      능 : Between A AND B 검색
 *****************************************************************************************/

function gfn_DataValidation_BetweenNum(sColId,sColNm,objDs,nRow ,sGubun, psMessage, psMessageViewYn){

    var sColValue = String(objDs.getColumn(nRow , sColId)).trim();

    var arrVal    = sGubun.split(",");

    // 1. 첫 번째 값 처리

    if (gfn_IsNull(sColValue)) return true;

    // 2. Between 검색

    if (toNumber(arrVal[0]) > toNumber(sColValue) || toNumber(sColValue) > toNumber(arrVal[1])){

        gfn_DataValidation_ErrorMessage(psMessageViewYn, psMessage, sColNm + "는(은) " + arrVal[0] + " ~ " +  arrVal[1] + " 사이만 가능합니다.");

        return false;

    }else{

        return true;

    }

}

/******************************************************************************************
 * 기능 : DataValidation 검수 후 오류 존재 하면 조회
 *****************************************************************************************/

function gfn_DataValidation_ErrorMessage(psMessageViewYn, psDsMessage, psLocalMessage){

    if (psMessageViewYn == 'N') return;

    if (gfn_IsNull(psDsMessage))

        gfn_alert(psLocalMessage);

    else

        gfn_alert(psDsMessage);

}

/******************************************************************************************
 * 기능 : 입력일자의 정합성 체크
 * 인자 : 'yyyyMMdd' 형태로 표현된 날짜.
 * 리턴 : true , false
 * 예문 :
 *****************************************************************************************/

function gfn_IsDate(strDate)

{

    var v_date = gfn_Date2Str(gfn_bpStr2Date(strDate));

    if (v_date == strDate)

        return true;

    else

        return false;

}

/******************************************************************************************
 * 기능 : 날짜를 문자로 변환.
 * 인자 : inDate 문자열
 * 리턴 : 해당일자
 * 예문 :
 *****************************************************************************************/

function gfn_Date2Str(inDate)

{

  return (new Date(inDate)).getFullYear()

           + (((new Date(inDate)).getMonth() + 1) + "").padLeft(2, '0')

           + (((new Date(inDate)).getDate()) + "").padLeft(2, '0');

}

☞  

☞  

/******************************************************************************************
 * 기능 : Dynamic Calcurate
 * 인자 : objDs - 값을 얻을 dataset
 *         psSrcColList - 계산식에 사용될 컬럼 리스트
 *         psFomula     - 계산식
 *         psSetColId   - 계산된 값을 넣을 컬럼
 *         psSetCond    - 계산된 값을 넣을 때 처리방법 (NULL=0,  NULL=NULL, 0=NULL)
 * 리턴 : Grid header에 대한 index
 * 예문 : gfn_DynamicCalcurate(objDs, "컬럼명,row=3:컬럼명,row=3"
 *                                  , "([컬럼명1] + [컬럼명2])/100 - 100"
 *                                  , "컬럼명,row=3"
 *                                  , "NULL=0")
 *
 *        gfn_DynamicCalcurate(objDs, "컬럼명, find=컬럼명1=='3'&&컬럼명2>=30:컬럼명,row=3"
 *                                            , "([컬럼명1] + [컬럼명2])/100 - 100"
 *                                            , "컬럼명,find=컬럼명1=='3'&&컬럼명2>=30"
 *                                            , "NULL=NULL")
 * 개발자 : 김용학 (아직 프로젝트 적용한적 없음.  혹시 이 소스를 사용하시면 개발자 지우지 말아주세요.
 *          나름 아이디어 상품이라서 ^^
 * 참고 : find 조건으로 넘와 왔을 경우 값을 못찾으면 null('')로 set
 *****************************************************************************************/
function gfn_DynamicCalcurate(objDs, psSrcColList, psFomula, psTargetColId, psSetCond){
    var aSrcColList = psSrcColList.split(':');
    var sValue, nRow, sFindExpr;
    var sFomulaCal=psFomula;
    var sLastValue;
    
    //1. 계산식에 적용될 컬럼에 대한 값 찾기 와   계산식에 값 Replace
    for(var idx=0; idx<aSrcColList.length; idx++){
    
        //a. 각 컬럼에 대한 row찾기
        var aSrcCol = aSrcColList[idx].split(',');
        if (aSrcCol[1].indexOf("row=") >= 0){
            nRow   = aSrcCol[1].replace("row=", '');
        }else{
            sFindExpr = aSrcCol[1].replace("find=", '');
            nRow      = objDs.findRowExpr(sFindExpr);
            if (nRow < 0){
                sFomulaCal = '';
                break;
            }
        }
        
        //b. 값 얻기
        sValue = objDs.getColumn(nRow, aSrcCol[0]);
        if (gfn_isNull(sValue)) sValue = 0;
        
        //c. 산술식에서 컬럼명을 값으로 대체하기
        sFomulaCal = sFomulaCal.replace('[' + aSrcCol[0] + ']', sValue);
    }
    
    //3. 값 계산하기  (eval()함수에서 나눗셈에  0 이 존재 하면 오류는 안나고,  NaN 으로 결과가 나옴)
    sLastValue = eval(sFomulaCal);  
    if (sLastValue == "NaN" || sLastValue == "Infinity"){
        if (psSetCond == "NULL=0"   ) sLastValue = 0;
        if (psSetCond == "NULL=NULL") sLastValue = '';
    }else if (sLastValue == "0=NULL"){
        sLastValue = '';
    }
    
    //4. 계산된 값을 Dataset에 set
    var aTargetCol = psTargetColId.split(',');
    
    if (aTargetCol[1].indexOf("row=") >= 0){
        nRow   = aTargetCol[1].replace("row=", '');
    }else{
        sFindExpr = aTargetCol[1].replace("find=", '');
        nRow      = objDs.findRowExpr(sFindExpr);
        if (nRow < 0) return;
    }
    
    objDs.setColumn(nRow, aTargetCol[0], sLastValue);
}

/******************************************************************************************

 * 기      능 : dataset 한줄 삽입

 * 인      자 : objGrid - Grid 명

 *              objCopyDs - 선택된 row를 복사한다.

 *              objGrid   - 존재시 insert된 row이 이동

 *              nInstRow  - 추가할 row지정

 *****************************************************************************************/

function gfn_InsertRow(objDs, objCopyDs, objGrid, sFosColId, nInstRow){

    if (gfn_isNotNull(objGrid)){

        objGrid.setFocus();

    }

    var nRow;

    if (nInstRow >= 0)

        nRow = objDs.insertRow(nInstRow);

    else

        nRow = objDs.addRow()

    if (gfn_isNotNull(objCopyDs)){

        objDs.copyRow( nRow,  objCopyDs,  objCopyDs.rowposition);       

    }

    objDs.rowposition = nRow;

    if (gfn_isExist(sFosColId)){

        var nIdx = gfn_GetColIndex(objGrid, sFosColId);

        if (nIdx >= 0){

            objGrid.setCellPos(nIdx);

        }

    }

    return nRow;

}

/******************************************************************************************

 * 기      능 : 선택한 dataset Row삭제

 * 인      자 : objDs - 삭제할 Dataset

 * 반      환 : 삭제 row (-1이면 오류)

 *****************************************************************************************/

function gfn_DeleteSelRow(objDs){

    var nRow, nType;

    // 1. 선택한줄 확인

    nRow = objDs.rowposition;

    if (nRow < 0){

        gfn_alert("선택된 ROW가 존재 하지 않습니다.");

        return -1;

    }

    // 2. 신규 자료 인지 검사

    nType = objDs.getRowType(nRow);

    if (nType == 2){

        objDs.deleteRow(nRow);

        return -1;

    }

    return nRow;

}

function gfn_ExistColumnId(objDs, sColId){

    var nColCnt = objDs.colcount;

    for(var i=0; i < nColCnt; i++){

        if (sColId == objDs.getColID(i)) return true;

    }

    return false;

}

☞  

/******************************************************************************************
 * 기      능 : Dataset 복사
 * 인      자 : tarDs - 추가될 dataset
 *              srcDs - 자료를 가지고 있는 daaset
 *****************************************************************************************/

function gfn_AddCopyRow(tarDs, srcDs){

    var nAddRow;

    for(var nRow=0; nRow<srcDs.rowcount; nRow++){

        nAddRow = tarDs.addRow();

        tarDs.copyRow(nAddRow, srcDs, nRow);

    }   

}

/******************************************************************************************
 * 기능 : 특정컬럼 값중 가장 큰 값에 대한 row를 return
 * 인자 : objDS   - 찾을 Dataset name
 *        psColId - 찾을 컬럼명
 * 리턴 : 가장큰 값에 대한 row
 * 예문 :
 *****************************************************************************************/

function gfn_GetMaxFirstRow(objDs, psColId){

    var sMaxVal;

    sMaxVal  = objDs.getMax(psColId);

    return objDs.findRow(psColId, sMaxVal);

}

/*******************************************************************************
 ★ 설명
     Dataset에서 strVal에 해당하는 Record 찾기
     찾기 시작하고자 하는 Record에서 끝까지 찾고 다시 처음부터 시작 Record까지
     찾은 후 그걸 한번에 Return하기 위해 만듬
 ★ parameter
    1. objDs : Dataset Object ( 예 : Dataset00 )
    2. strColID : Column명
    3. strVal : 찾고자 하는 값
    4. nStartRow : 찾기 시작하고자 하는 Record
 ★ return
    찾은 Record를 담은 Array
 ******************************************************************************/

function DsFindRow( objDs, strColID, strVal, nStartRow )

{

 if( fn_IsNull(nStartRow) )  nStartRow = 0;

 var frow = -1, expr;

 var arr=Array(), arr_no=0;

 while(1)

 {

  expr = objDs.name + ".getColumn(currow, " + "\"" + strColID + "\").toString().search(/" + strVal + "/) >= 0";

  frow = objDs.findRowExpr(expr, frow+1);

  if( frow < 0 )

   break;

  arr[arr_no] = frow;

  arr_no++;

 }

 return arr;

}

/*******************************************************************************
 ★ 설명
     DsFindRow()에서 대소문자 구별없이 찾을 수 있게 만듬
 ★ parameter
    1. objDs : Dataset Object ( 예 : Dataset00 )
    2. strColID : Column명
    3. strVal : 찾고자 하는 값
    4. nStartRow : 찾기 시작하고자 하는 Record
 ★ return
    찾은 Record를 담은 Array
 ******************************************************************************/

function DsFindRowCase( objDs, strColID, strVal, nStartRow )

{

 if( fn_IsNull(nStartRow) )  nStartRow = 0;

 var frow = -1, expr;

 var arr=Array(), arr_no=0;

 while(1)

 {

  expr = objDs.name + ".getColumn(currow, " + "\"" + strColID + "\").toString().search(/" + strVal + "/i) >= 0";

  frow = objDs.findRowExpr(expr, frow+1);

  if( frow < 0 )

   break;

  arr[arr_no] = frow;

  arr_no++;

 }

 return arr;

}

/******************************************************************************************
 * 기능 : 체크된 Row가 존재 하는지 검사
 * 인자 : objDS - 검사할 Dataset name
 * 리턴 : true  - check row존재
 *        false - check row 미 존재
 * 예문 :
 *****************************************************************************************/

function gfn_DeleteCheckExist(objDS)

{

    var nRow = objDS.findRow("_chk", "1");

    //1. 체크된 Row가 없을 경우

    if (nRow < 0){

        gfn_Alert('WRN00054'); //삭제할 항목을 선택하세요.

        return false;

    //2. 체크된 Row가 있을 경우

    }else{

        return true;

    }

}

/******************************************************************************************
 * 기능 : 체크된 Row가 존재 시 삭제
 * 인자 : objDS - 검사할 Dataset name
 *        sType - 바로삭제여부
 * 리턴 : true  - check row존재
 *        false - check row 미 존재
 * 예문 :
 *****************************************************************************************/

function gfn_DeleteChecked(objDS)

{

    var nRow = objDS.findRow("_chk", "1");

    //1. 체크된 Row가 없을 경우

    if (nRow < 0){

        gfn_Alert('WRN00054'); //삭제할 항목을 선택하세요.

        return false;

    //2. 체크된 Row가 있을 경우

    }else{

        var oExtCommon = new ExtCommon();

        var aIndex = oExtCommon.findRows(objDS, "_chk", "1");       

        for (var i = aIndex.length - 1; i > -1; i--) {

            objDS.deleteRow(parseInt(aIndex[i]));

        }

        return true;

    }

}

/******************************************************************************************
 * 기능 : 해당 dataset에서 컬럼명이 존재 하는지 검사
 * 인자 : objDs  - 검사할 dataset
 *        sColId - 검사할 컬럼명
 * 리턴 : true - 해당 컬럼 존재
 *        false - 해당 컬럼 미존재
 * 예문 :
 *****************************************************************************************/

function gfn_ExistColumnId(objDs, sColId){

    var nColCnt = objDs.colcount;

    for(var i=0; i < nColCnt; i++){

        if (sColId == objDs.getColID(i)) return true;

    }

    return false;

}

/******************************************************************************************
 * 기능 : Dataset 이 변경 되었는지 검사
 * 인자 : psDsList - String형식의 Dataset
 *        pbMsg     - 미 변경 시 Message 조회 여부
 * 리턴 : true - 수정된 dataset이 존재
 *        false - 수정된 dataset이 미 존재
 * 예문 : gfn_IsModified("dsName1,dsName2,dsName3", true);
 *****************************************************************************************/

function gfn_IsModified(psDsList, pbMsg){

    var paDsList = psDsList.split(',');

    var bChange  = false;

    for(var i=0; i<paDsList.length; i++){

        if (gfn_IsUpdate(eval(paDsList[i]))){

            bChange = true;

            break;

        }

    }

    if (pbMsg == true && bChange == true){

        alert("변경된 자료가 존재 합니다.");

        return true;

    }

    return false;

}

/******************************************************************************************
 * 기능 : Dataset의 변경 유무를 리턴한다.
 * 인자 : poDataset : 체크할 Dataset
 * 리턴 : true - 수정된 dataset이 존재
 *        false - 수정된 dataset이 미 존재
 *****************************************************************************************/

function gfn_IsUpdate(poDataset)

{

    // 삭제 여부

    if (poDataset.getDeletedRowCount() > 0) return true;

    // 입력/수정 여부

    for (var i = 0; i < poDataset.rowcount; i++) {

        if (poDataset.getRowType(i) == 2 || poDataset.getRowType(i) == 4) {

            return true;

        }

    }

    return false;

}

☞  

/******************************************************************************************
 * 기능 : Dataset에서 값을 얻어올때 null이면 공백을 return
 * 인자 : objDs - Dataset
 *        nRow  - ds row
 *        sColId - 컬럼 id
 * 리턴 : Dataset에서 get한 값
 * 예문 :
 *****************************************************************************************/

function gfn_GetColumnEmpty(objDs, nRow, sColId){

    var sVal = objDs.getColumn(nRow, sColId);

    if (gfn_IsNull(sVal)) sVal = ''

    return sVal;

}

/******************************************************************************************
 * 기능 : Dataset에서 값을 얻어올때 null이면 0을 return
 * 인자 : objDs - Dataset
 *        nRow  - ds row
 *        sColId - 컬럼 id
 * 리턴 : Dataset에서 get한 값
 * 예문 :
 *****************************************************************************************/

function gfn_GetColumnZero(objDs, nRow, sColId){

    var nVal = objDs.getColumn(nRow, sColId);

    if (gfn_IsNull(nVal)) nVal = 0

    return nVal;

}

/******************************************************************************************
 * 기능 : dataset에서 필요한 값을 find한 후 해당 컬럼값을 얻어 오기
 * 인자 : objDs        - 검색 및 찾아올 dataset
 *        strFindExpr  - find에 찾을 조건값
 *        sColId       - getColumn할 column id
 * 리턴 : 검색한 결과
 * 예문 :
 *****************************************************************************************/

function gfn_FindGetColumn(objDs, strFindExpr, sColid ){

    var nFindRow = objDs.findRowExpr(strFindExpr);

    if (nFindRow < 0) return '';

    return objDs.getColumn(nFindRow, sColid);

}

/******************************************************************************************
 * 기능 : 중복data검사
 * 인자 : objDs          - 검사할 dataset
 *        aColList       - 컬럼목록   "EMP_NO,DEPT_NO";
 *        nRow           - 검사 소스 ROW (이 row를 기준으로 중복되었는지 검사)
 * 리턴 : true - 중복,   false - 중복 없음
 * 예문 :
 *****************************************************************************************/

function gfn_IsDuplicate(objDs, aColList, nRow){

    var sFildCond, sColValue, nFindRow;

    var paColList = aColList.split(',');

    sFildCond = paColList[0] + "=='" + objDs.getColumn(nRow, paColList[0]) + "'";

    for(var ii=0; ii<paColList.length; ii++){

        sFildCond += "&& " + paColList[ii] + "=='" + objDs.getColumn(nRow, paColList[ii]) + "'";

    }

    sFildCond += "&& currow <> " + nRow);  //<----  currow가 되는지 테스트 해 보지 않았음

    nFindRow = objDs.getCaseCount(sFildCond);

    if (nFindRow > 1){

        return true;

    }

    return false;

}

/******************************************************************************************
 * 기능 : dataset에 null, space등의 결과로 tag 가 없는 컬럼에 대해서 tag 생성(default값 set)
 *        sql문장에서 null, space결과값은 dataset에 tag가 만들어지지 않는다.
 *        tag 가 만들어지지 않으면 getSum등의 함수에서 NaN 결과값을 return하게 됨
 *        값이 null, space인 경우 default 값 Setting으로도 가능함.
 * 인자 : bEvent - true : event 호출됨,   false : event 호출 안됨
 *        objDs  - 작업할 Dataset
 *        aColId - 값Setting Array형식의 컬럼리스트
 *        aVal   - 값Setting Array형식의 Setting할 값 리스트
 * 리턴 :
 * 예문 : var aColId = new Array('goodAllotSmtotScore', 'evalScoreSmtot');
 *        var aVal   = new Array('0', '');
 *        gfn_SetDsNullValue(true, dsProjectItem, aColId, aVal);
 *****************************************************************************************/

function gfn_SetDsNullValue(bEvent, objDs, aColId, aVal){

    if (bEvent == false)    objDs.enableevent = false;

    for(var nRow=0; nRow < objDs.getRowCount(); nRow++){

        for(var nIdx=0; nIdx<aColId.length; nIdx++){

            if ( gfn_IsNull(objDs.getColumn(nRow, aColId[nIdx])) ){

                objDs.setColumn(nRow, aColId[nIdx], aVal[nIdx]);

            }

        }

    }   

    if (bEvent == false)    objDs.enableevent = true;

}