# 공통코드관리

## 1 개요

> 공통적으로 사용하는 특정값들의 리스트를 구성할 수 있는 화면입니다. 보통 화면에서 데이터를 추가 시 콤보박스에 선택하는 리스트에 대한 데이터를 만들수 있는 용도입니다.

{% hint style="info" %}
시스템을 사용할 사용자 정보, 각 업무 화면에서 사용하는 공통코드 정보, 매출처 정보 등이 있어야 접수, 결과 입력, 성적서 발행 등의 작업 수행이 가능합니다.

※ 시스템을 처음 구축하여 사용하시는 기관에서는 당사 직원의 도움을 받아 기초 코드를 입력합니다. 이후에 법령과 같이 변경된 사항이 있을 때 해당 메뉴를 통해 직접 추가하십시오.
{% endhint %}

{% hint style="success" %}
아이랩에서 제공되는 화면 중 대부분의 Combo Box 부분에 들어가는 값들을 지정하는 화면입니다. ex) 검사목적, 관리계좌, 문자상용구, 시약구분 등
{% endhint %}

![](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-L9sMKyUo82VSZc9LSFY%2F-L9sMVPvXok5cOAIUPPq%2F%EA%B2%80%EC%82%AC%EB%AA%A9%EC%A0%8101.png?generation=1523511599253929\&alt=media)

### 1-1 적용 내용 및 설명&#x20;

![](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-L9sMKyUo82VSZc9LSFY%2F-L9sMVPzN1JbXTnwC_zz%2F%EA%B2%80%EC%82%AC%EB%AA%A9%EC%A0%81%EC%BD%A4%EB%B3%B4%EB%B0%95%EC%8A%A402.png?generation=1523511608415839\&alt=media)

각 분야별로 중복되는 이름이 있는 경우 해당 화면 표기 중 검사목적, 관련법령 (수질분야)를 제외한 다른 분야에 대한 정보들은 각 분야 이름을 앞에 붙여서 사용하면 됩니다.

#### 공통코드 분류 및 설명

| 공통코드     | 비고          |
| -------- | ----------- |
| 검사목적     | 수질 분야 검사목적  |
| 식품검사목적   | 식품 분야 검사목적  |
| 대기검사목적   | 대기분야 검사목적   |
| 관련 법령    | 수질 분야 관련 법령 |
| 식품 관련 법령 | 식품 분야 관련 법령 |
| 대기 관련 법령 | 대기 분야 관련 법령 |
| …        |             |

{% hint style="info" %}
※ 해당 공통코드의 정보가 추가, 변경, 삭제 되었다면 해당 정보가 사용되는 화면이 새로 열릴 때 적용됩니다.
{% endhint %}

**※ 적용되어야 할 화면이 이미 열려 있었다면, 해당 화면을 한번 닫았다가 다시 열어서 사용 할 때부터 적용됩니다.**

## 2 화면 구성

![공통코드 화면](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-L9sMKyUo82VSZc9LSFY%2F-L9sMVS4hr3J_tlhinm2%2F%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C%EA%B4%80%EB%A6%AC%EC%A0%81%EC%9A%A903.png?generation=1523511607170773\&alt=media)

| 영역명      | 설명                                       |
| -------- | ---------------------------------------- |
| 조회 영역    | 해당 조회조건을 통해 원하시는 내용을 조회할 수 있습니다.         |
| 기본 버튼    | 자세한 설명은 아래 [버튼설명](#3)에서 하겠습니다.           |
| 입력/수정 영역 | 추가/수정 시 활성화되며 해당 내용을 기재하여 추가/수정할 수 있습니다. |
| 분류목록     | 코드의 카테고리를 의미합니다.                         |
| 공통코드 목록  | 해당 카테고리의 해당하는 내용이 출력됩니다.                 |

## 3 버튼설명

![공통코드 버튼](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-MJUlGwYxeBlVWJQIufU%2F-MJUmQgysq8Pfu35kPix%2F%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C_%EB%B2%84%ED%8A%BC.png?alt=media\&token=3f36231d-e10f-4a84-90d5-115898879605)

| 버튼명   | 설명                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Excel | <p>화면에서 조회된 공통코드 목록을 보이는 그대로 <strong>엑셀로 변환</strong>합니다.<br><strong>※ 분류 목록은 변환되지 않고 공통코드 목록만 변환됩니다.</strong><br><br>모든 공통코드 목록을 엑셀로 변환하시려면 분류 목록에서 전체를 선택하신 뒤 <code>Excel</code> 버튼을 클릭해 주세요.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 추가    | <p>ㆍ새로운 공통코드를 생성합니다.</p><p>ㆍ선택한 분류 안으로 공통코드를 생성하고 싶을 때는 값유지 체크하신 뒤 추가 버튼을 이용하십시오.</p><p> <img src="https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-L9sMKyUo82VSZc9LSFY%2F-L9sMVTCpUyCEJbPfmGK%2F%EC%B6%94%EA%B0%8004.png?generation=1523511607077122&#x26;alt=media" alt=""></p><p><code>추가</code> 버튼 클릭 후 분류 목록에 있는 공통코드로 사용해야 한다면 분류 목록에 보이는 분류를 입력하시고 새로운 분류 목록을 만드시려면 원하시는 이름을 입력 바랍니다.<br></p><p>ㆍ각 입력 칸 우측 상단에 삼각형 표시가 있다면 필수 입력 칸이니 빈칸이 되지 않도록 값을 입력하면 됩니다.</p><p><img src="https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-L9sMKyUo82VSZc9LSFY%2F-L9sMVTFJgb3jVIzaID0%2F%EB%B6%84%EB%A5%9805.png?generation=1523511602212715&#x26;alt=media" alt=""></p><p></p><p>ㆍ정렬 순서는 해당 공통코드를 사용하는 화면에서 보여지는 순서입니다.</p><p>자동증가 시 가장 마지막 순서 + 1로 저장되며, 순서를 변경하고 싶을 때는 해당 부분을 체크 해지 후 원하시는 순서로 저장해보십시오.</p><p><img src="https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-L9sMKyUo82VSZc9LSFY%2F-L9sMVTHOshBfznPphWi%2F%EC%A0%95%EB%A0%AC%EC%BD%94%EB%93%9C%EC%88%9C%EC%84%9C06.png?generation=1523511605893666&#x26;alt=media" alt=""></p> |
| 수정    | 선택된 공통코드의 정보를 수정합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 저장    | `추가` 또는 `수정` 버튼으로 입력된 공통코드의 정보를 저장합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 삭제    | <p>ㆍ선택된 공통코드를 삭제합니다.<br>ㆍ분류를 삭제하기 위해서는 선택된 분류 안에 있는 모든 공통코드 목록을 모두 삭제해야 합니다.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 취소    | 입력된 내용들을 저장하지 않고 취소합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

## **4입력 / 수정 영역**

![](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-MJUoCmuBFviydloPXrT%2F-MJUoYqLlD4FrEnYWzJz%2F%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C_%EC%9E%85%EB%A0%A5%2C%EC%88%98%EC%A0%95.png?alt=media\&token=5f3f2cf9-0b95-4589-a41a-942cdf5d5d39)

| **명칭** | 설명                                                                                                                         |
| ------ | -------------------------------------------------------------------------------------------------------------------------- |
| 분류     | 공통으로 사용되는 코드의 분류명을 입력합니다.                                                                                                  |
| 코드     | <p>분류 항목에 의해 분류되는 공통 코드의 명칭을 코드로 구분하기 위한 항목으로 숫자 값이나 영문자 값으로 입력합니다.<br><strong>※ 코드 값은 분류에서 유일한 값으로 지정해야 합니다.</strong></p> |
| 상위  코드 | 분류 항목에 의한 분류 이외에 코드들을 묶음 형태로 관리할 필요가 있을 때 묶을 상위 공통 코드의 코드 값을 상위 코드 항목으로 지정합니다.                                             |
| 정렬 순서  | 보여지는 순서를 지정하여 자주 사용하는 목록 값은 정렬 순서를 앞으로 놓거나 할 때 사용합니다.                                                                      |
| 명칭     | 코드의 명칭을 입력합니다.                                                                                                             |
| 약어     | 명칭으로 표기하지 않고 약어로 표기할 수 있도록 값을 입력합니다.                                                                                       |
| 사용 여부  | 공통코드로 관리는 하지만 업무에서 사용을 하지 않는 코드의 경우 “미사용”으로 지정하면 **제외**하여 Combo Box의 목록을 만듭니다.                                             |
| 비고     | 코드에 대한 설명을 입력합니다. (각 관련 법령의 세부사항이 필요할 경우 이곳에 입력하여 사용하기도 합니다.)                                                              |

## 5 공통코드 관리 활용 예시

{% hint style="info" %}
공통코드를 추가하고 활용하는 방법에 대한 예시입니다.\
기관과 사용자의 환경에 따라 다소 상이하거나 차이가 있을 수 있습니다.\
\
\&#xNAN;**※ 오류나 궁금한 점 발생 시 아이랩 서비스요청 기능을 이용해주시기 바랍니다.**
{% endhint %}

**1. 공통코드를 추가하여 접수를 진행한 뒤, 성적서에 출력되게 만드는 방법을 진행하겠습니다.**

**2. 먼저, 공통코드 관리화면에서 접수화면에 출력되는 "시험구분"에 코드를 추가합니다.**

![공통코드 관리화면 - 신검, 재검, 재재검 구분 코드 추가](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-LENb7AMHuIApXihHr2m%2F-LENdc7XbLRrG6eRUQ1S%2F%EC%9D%B4%EB%AF%B8%EC%A7%80%208.png?alt=media\&token=43f55a27-a811-40ea-8c66-549465eb0b47)

**3. 신검과 재검을 구분하는 코드를 추가하셨다면 접수화면에서 정상적으로 출력되는지 확인합니다.**

![접수화면에서 공통코드 추가확인](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-LENb7AMHuIApXihHr2m%2F-LENeBmNwRrbapSH1DKV%2F%EC%9D%B4%EB%AF%B8%EC%A7%80%2011.png?alt=media\&token=fd6a37f8-89cd-4bb0-929f-81b4a48e2747)

**4. 그 뒤, 접수를 진행하신 다음 성적서에 표시하고 싶은 부분에 시험구분의 데이터를 연동시키는 변수를 기입합니다.** &#x20;

**변수명 :  \[AgainTypeName]**&#x20;

![원하시는 리포트의 변수 기입](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-MJV8mfCM-swplifP3gn%2F-MJVBf2C74mvAH6EdUWw%2F%EA%B3%B5%ED%86%B5%EC%BD%94%EB%93%9C_%EB%B3%80%EC%88%98%EB%AA%85%20%EA%B8%B0%EC%9E%85%20%EC%98%88%EC%A0%9C.png?alt=media\&token=6d47e448-b846-4579-b9c2-273fb354f905)

&#x20;                                                                                         ↓

![성적서에 시험구분 연동완료화면](https://3435040722-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L9sM1gtG7RzXNTibOAX%2F-LENb7AMHuIApXihHr2m%2F-LENfMzBZK5TUVFNdt-G%2F%EC%9D%B4%EB%AF%B8%EC%A7%80%2013.png?alt=media\&token=58826dc6-8cf7-4438-8de4-11a91aa23cb0)

마지막으로  접수 건과 같이 시험구분이 출력 되는지 확인합니다.

{% hint style="success" %}
공통코드는 재실행 시에 적용됩니다. 만약 추가를 진행하셨는데 보이지 않는다면 재실행하 진행해보시기 바랍니다.
{% endhint %}
