Course B-1

[공통 코드 관리] 개발

목표

• 이미 등록된 데이터 컴포넌트를 이용하여 두 개의 새로운 테이블을 정의하고, 가장 많이 사용되는 list-master-detail 패턴의 화면을 구성한 다음 테이블 반환 함수를 사용한 데이터 처리 과정을 이해합니다.

• 학습 인정 시간: 5 시간

주의 사항

• GPM에서 데이터 컴포넌트는 새로 등록하지 않고 테이블만 새로 정의합니다.

• 이전 과정에서 진행했던 내용과 중복되거나 응용하여 해결할 수 있는 부분은 생략했습니다.

개발 화면

1. 테이블 정보

2. 모델링

2.1) 코드 그룹 정보 테이블 생성 [GPM→모델링→테이블 관리]

• 신규 버튼 클릭 - 상위 메뉴 "EDU" 선택

• 테이블 명 : comCodeGroup_xxx

• 테이블 설명 : 코드 그룹 정보

2.2) 코드 세부 정보 테이블 생성 [GPM→모델링→테이블 관리]

• 신규 버튼 클릭 - 상위 메뉴 "EDU" 선택

• 테이블 명 : comCodeMaster_xxx

• 테이블 설명 : 코드 세부 정보

3. 비즈니스 로직 생성

3.1) 공통 코드 관리 조회 프로시저 생성 [GPM→개발→SP편집]

• 신규 버튼 클릭 - 상위 메뉴 "EDU" 선택

• SP 명 : P_DEV002_xxx_Q

• SP 설명 : 공통 코드 관리 조회

• 테이블 탭으로 이동하여 'comCodeGroup_xxx' 테이블만 드래그 드랍하여 Parameter 탭에만 세팅 후 "SP 편집창에 적용" → "SP 생성" 순서로 처리합니다.

• SP 정보 생성 후 SSMS 도구를 이용해 아래 쿼리를 참고하여 저장 프로시저 내용을 완성합니다.

    ----------------------------------------------------------------------------------------------------------------------- 
    -- 요약 정보
    IF @p_work_type IN ( 'list' ) 
    BEGIN
    ----------------------------------------------------------------------------------------------------------------------- 

        SELECT A.*
        FROM comCodeGroup_xxx A
        WHERE group_code LIKE '%' + @p_group_code + '%'
        AND group_name LIKE '%' + @p_group_name + '%'
        AND group_category LIKE @p_group_category + '%'
    
        SELECT @p_row_count = @@ROWCOUNT

        IF @p_row_count > 0  
            SET @p_error_code = 'MSG0001'                                -- 정상적으로 조회가 되었습니다  
        ELSE 
            SET @p_error_code = 'MSG0006'                                -- 조회된 자료가 없습니다.                 

    END -- 요약 정보 끝 
    ----------------------------------------------------------------------------------------------------------------------- 

    ----------------------------------------------------------------------------------------------------------------------- 
    -- 상세 정보
    IF @p_work_type IN ( 'detail' ) 
    BEGIN
    ----------------------------------------------------------------------------------------------------------------------- 

        SELECT A.*
        FROM comCodeMaster_xxx A
        WHERE group_code = @p_group_code

        SELECT @p_row_count = @@ROWCOUNT

        IF @p_row_count > 0  
            SET @p_error_code = 'MSG0001'                                -- 정상적으로 조회가 되었습니다  
        ELSE 
            SET @p_error_code = 'MSG0006'                                -- 조회된 자료가 없습니다.                 

    END -- 상세 정보 끝 
    -----------------------------------------------------------------------------------------------------------------------

3.2) 공통 코드 관리 저장용 프로시저 생성 [GPM→개발→SP편집]

• 신규 버튼 클릭 - 상위 메뉴 "EDU" 선택

• SP 명 : P_DEV002_xxx_S

• SP 설명 : 공통 코드 관리 저장

• 조회용 프로시저와 마찬가지로 아래 사진과 같이 Parameter 탭에만 세팅 후 "SP 편집창에 적용" → "SP 생성" 순서로 처리합니다.

4. 저장용 프로시저 완성

4.1) 파라미터 수정

4.2) 테이블 변수 처리

• 하나의 문자열로 받아온 여러 행(Row)에 대한 각 필드별 값을 파싱하여 테이블 형태로 보관하기 위해 변수를 정의합니다.

• 테이블 반환 함수 "SplitTableNVarchar"를 사용해 테이블 변수(@tb_comCodeMaster_xxx)에 데이터를 삽입합니다.

4.3) 작업 타입: 신규 (@p_work_type = 'N')

• 신규 저장은 새로운 그룹 코드(group_code)에 대한 세부 코드(sub_code)들을 한 번에 입력하고 저장한다는 의미입니다.

• 입력된 그룹코드가 이미 등록된 코드인지 확인 후 comCodeGroup_xxx, comCodeMaster_xxx 테이블 순서로 데이터를 삽입합니다.

4.4) 작업 타입: 수정 (@p_work_type = 'U')

• 처리하려는 세부 코드 대상 중 신규(row_status='N')인 데이터의 중복 여부를 확인합니다.

• comCodeGroup_xxx 테이블의 데이터 수정 → comCodeMaster_xxx 테이블의 데이터 삭제 → 수정 → 삽입 순서로 처리합니다.

4.5) 작업 타입: 삭제 (@p_work_type = 'D')

• 삭제는 그룹 코드(group_code)에 대한 삭제를 의미하므로 comCodeGroup_xxx, comCodeMaster_xxx 두 테이블에 전달받은 그룹 코드 파라미터(@p_group_code)로 등록된 모든 데이터를 삭제합니다.

5. 화면 개발

5.1) 폼 생성 [Visual Studio→도구→GPM Tools]

5.2) 화면 디자인

• 디자인 리스트를 아래 사진처럼 구성하고 "디자인 적용" 버튼을 누른 다음 [개발 화면]의 이미지를 참고하여 컨트롤을 재배치 합니다.

5.3) 컨트롤 배치

• [개발 화면]과 같이 화면 구성과 컨트롤들을 배치합니다.

6. 기능 구현

저장 프로시저를 처리하는 코드 패턴은 폼 템플릿에 미리 작성되어 있는 #region [예시 코드]를 참고합니다.

6.1) 조회용 프로시저 실행 메서드 [Func_P_DEV001_xxx_Q]

private bool Func_P_DEV002_xxx_Q(string workType)
{
    string groupCode = string.Empty;
    string groupName = string.Empty;
    string groupCategory = string.Empty;

    if (workType.Equals("list"))
    {
        groupCode = txtGroup_code.Text;
        groupName = txtGroup_name.Text;
        groupCategory = cboGroup_category.EditValue?.ToString() ?? string.Empty;
    }
    else if (workType.Equals("detail"))
    {
        groupCode = gvwList.GetValue("group_code")?.ToString() ?? string.Empty;
    }

    try
    {
        P_DEV002_xxx_Q procInfo = new P_DEV002_xxx_Q();

        procInfo.AddParamData(
            workType,
            groupCode,
            groupName,
            groupCategory);

        ResultSet result = ExecuteProcedure(procInfo);

        if (workType.Equals("list"))
        {
            SetData(grdList, result?[0]);
        }
        else if (workType.Equals("detail"))
        {
            SetData(grdDetail, result?[0]);
        }

        return result?.IsSuccess ?? false;
    }
    catch (Exception ex)
    {
        ShowErrorMessageBox(ex);
        return false;
    }
}

6.2) 저장용 프로시저 실행 메서드 [Func_P_DEV001_xxx_S]

• ParameterBuilder에 대한 자세한 내용은 [기능 문서]를 확인바랍니다.

private bool Func_P_DEV002_xxx_S(string workType)
{
    if (!ValidateControls(grpMaster))
        return false;

    string groupCode = txtGroup_code1.Text;
    string groupName = txtGroup_name1.Text;
    int codeLength = Convert.ToInt32(numCode_length.Value);
    string category = cboGroup_category1.EditValue?.ToString() ?? string.Empty;

    string fieldCaption1 = txtField_caption1.Text;
    string fieldCaption2 = txtField_caption2.Text;
    string numCaption1 = txtNumref_caption1.Text;
    string numCaption2 = txtNumref_caption2.Text;

    string useYN = chkUse_yn.EditValue?.ToString() ?? string.Empty;
    string memo = memoMemo.Text;

    ParameterBuilder paramBuilder = new ParameterBuilder();

    if (!workType.Equals("D"))
    {
        DataTable datas = BindingData(grdDetail);

        if (datas == null)
            return false;
            
        foreach (DataRow row in datas.Rows)
        {
            paramBuilder.Append(row, "row_status");
            paramBuilder.Append(row, "sub_code");
            paramBuilder.Append(row, "code_name");
            paramBuilder.Append(row, "system_yn");
            paramBuilder.Append(row, "extra_field1");
            paramBuilder.Append(row, "extra_field2");
            paramBuilder.Append(row, "numref1");
            paramBuilder.Append(row, "numref2");
            paramBuilder.Append(row, "sort_seq");
            paramBuilder.Append(row, "use_yn");
        }
    }

    try
    {
        P_DEV002_xxx_S procInfo = new P_DEV002_xxx_S();

        procInfo.AddParamData(
            workType,
            groupCode,
            groupName,
            codeLength,
            category,
            fieldCaption1,
            fieldCaption2,
            numCaption1,
            numCaption2,
            useYN,
            memo,
            SessionInfo.UserId,
            $"{GetClientPCName()}/{GetIPAddress()}",
            paramBuilder.GetParameter("row_status"),
            paramBuilder.GetParameter("sub_code"),
            paramBuilder.GetParameter("code_name"),
            paramBuilder.GetParameter("system_yn"),
            paramBuilder.GetParameter("extra_field1"),
            paramBuilder.GetParameter("extra_field2"),
            paramBuilder.GetParameter("numref1"),
            paramBuilder.GetParameter("numref2"),
            paramBuilder.GetParameter("sort_seq"),
            paramBuilder.GetParameter("use_yn"));

        ResultSet result = ExecuteProcedure(procInfo);

        if (!workType.Equals("D"))
        {
            _FindRowValue = result?.ReturnString;
        }

        return result?.IsSuccess ?? false;
    }
    catch (Exception ex)
    {
        ShowErrorMessageBox(ex);
        return false;
    }
}

6.3) 테이블의 기본 키에 대한 수정 제한 처리

• 테이블의 기본키인 [기본 정보] 영역에 '그룹 코드(group_code)'는 신규로 등록하는 상태에서만 입력이 가능하도록 합니다.

• GridView를 통해 입력받는 '세부 코드(sub_code)'는 GridColumn 속성을 통해 처리하는데, 필수로 값을 입력 받기 위해 AllowBlank 속성을 false로 설정하고, ColumnOperation 속성의 값을 ColumnLock으로 지정하여 새로 추가된 행(Row)일 때만 입력이 가능하도록 합니다.

• 참고) GridColumn에 설정된 AllowBlank 속성에 대하여 값 입력 확인은 BindingData 메서드에서 수행합니다.

6.4) 조회 조건 영역의 초기화 버튼 기능

• [GPM Tools→기본값 설정]에서 조회 조건 기본값 설정 정보를 등록하고 기능을 구현합니다.

6.5) 저장 시 작업 타입(workType) 판단 방법 수정 수정

• "그룹 코드" 컨트롤(txtGroup_code1)의 ReadOnly 속성의 값이 true이면 수정 상태, false이면 신규 상태로 판단하여 신규 상태일 때 "N"으로, 수정 상태일 때 "U"로 전달합니다.

public override void ClickSaveButton()
{
    if (Func_P_DEV002_xxx_S(txtGroup_code1.ReadOnly ? "U" : "N"))
    {
        ClickRetrieveButton();
    }
}

7. 체크 리스트

• 검색 / 신규→저장 / 수정→저장 / 삭제 기능이 올바르게 동작하는지 확인합니다.

• 그룹 코드는 신규 시에만 수정이 가능한지 확인합니다.

• 저장 시 [기본정보]영역에 필수 입력 항목 체크가 정확히 이루어지는지 확인합니다.

• 저장 시 [상세정보]영역에 필수 입력 항목 체크가 정확히 이루어지는지 확인합니다.

• [요약정보]영역과 [상세정보]영역에 데이터 건 수 집계가 제대로 표현되는지 확인합니다.

• 이미 등록된 그룹 코드(group_code)와 동일한 코드를 신규로 등록했을때 설정한 SP메시지가 제대로 출력되는지 확인합니다.

• 이미 등록된 세부 코드(sub_code)와 동일한 코드를 신규로 등록했을때 설정한 SP메시지가 제대로 출력되는지 확인합니다.

• 이미 등록된 세부 코드(sub_code)에 대하여 수정이 되지 않도록 설정되었는지 확인합니다.

• 조회 조건 영역의 초기화 버튼 기능이 정상 동작하는지 확인합니다.

• [요약정보]영역의 GridView의 행을 선택하고 Alt+F2 키를 눌러 등록 정보, 수정 정보가 정상 표현되는지 확인합니다.