====== 공통 코드 가이드 ======
===== 공통 코드 개요 =====
이 장에서는 XFrame 에서 제공하는 공통 코드 기능에 대해서 기술합니다. 이 장에서 기술하는 내용은 아래와 같습니다.
  * 공통 코드 개요
  * 공통 코드 아키텍처 및 명명 규칙
  * 공통 코드 적용 방법
  * 콤보 박스 주요 속성 및 이벤트
  
==== 공통 코드 개요 ====
공통 코드는 업무 화면에서 공통으로 사용하는 코드를 의미하며, 각각의 업무 화면에서 공통으로 사용하는 코드를 관리함으로써, 동일한 정보를 공통으로 사용할 수 있다.

xFrame 에서는 공통 코드를 “PICKLIST”라는 이름을 혼용해서 사용한다.

공통 코드를 사용함으로써 다음과 같은 장점이 제공된다.
  * 동일한 코드에 대한 일관성 유지
  * 공통 코드 변경시 코드를 사용하는 업무 화면의 변경없이 일괄 반영
  * 다양한 코드 정보에 대한 관리 체계 구축
  * 외부 메타 솔루션을 연계하여 코드 정보를 연계하는 기능을 제공한다.\\ (메타 솔루션 연동과 관련된 자세한 내용은 “메타 연동 가이드” 문서를 참조한다.)

==== 공통 코드 아키텍처 ==== 
공통 코드(PICKLIST)는 아래와 같은 아키텍처로 구성되어 있다.
{{ .:common_code_guide:00.png?nolink |}}

|< 100% 50px - >|
^  구분  ^ 설명  ^
|  1  | <WRAP>
각각의 코드는 유일한 ID를 가진다.
또한 각각의 코드는 코드 ID를 이름으로하는 파일로 추출되어 XFrameViewer에게 반영된다.

[코드 속성]
  * CODE_NAME : 코드에 대한 설명 문자열을 의미한다.
  * CODE_DELIMETER : 코드와 Commnet 를 구분하는 구분자를 의미한다.
  * CODE_STYLE : 코드 데이터에 대한 스타일을 의미한다. (리스트형/트리형)
</WRAP>|
|  2  | 코드는 코드 ID에 포함되는 각각의 코드를 의미한다. |
|  3  | Comment는 각각의 코드에 해당하는 설명 문자열을 의미한다. |

=== 코드 속성 ===
공통 코드는 아래와 같은 속성을 가진다.
|< 100% 150px - >|
^ 구분   ^ 설명   ^
| CODE_NAME | 코드에 대한 설명 문자열을 의미한다. |
| CODE_DELIMETER | 코드 데이터에서 코드와 Commnet 를 구분하는 구분자를 의미한다. |
| CODE_STYLE | 코드 데이터에 대한 스타일을 의미한다. (리스트형/트리형) |

=== 공통 코드 예시 ===
코드에 대한 예시는 아래와 같다.
|< 100% 150px - >|
^ 구분 ^ 설명 ^
| CODE_ID | NATION_CODE |
| CODE_NAME | 국가코드 |
| CODE_DELIMETER | “:” |
| CODE_STYLE | 리스트형 |
| CODE_DATA | 01:대한민국\\ 02:일본\\ 03:중국 |

=== 공통 코드 적용 대상 콘트롤 === 
공통 코드는 아래의 UI 콘트롤에 적용된다.
|< 100% 150px - >|
^ 구분 ^ 설명 ^
| 콤보 박스 | PICKLIST 속성 지정을 통해서 적용한다. |
| 그리드 칼럼 | 그리드의 칼럼의 데이터부의 속성중에 input_type 속성이 “combo_box”인 경우에 적용되며, PICKLIST 속성 지정을 통해서 적용한다. |
| 그리드 아이템 | 그리드의 특정 아이템에 대하여 칼럼의 PICKLIST와 다른 PICKLIST를 적용할 수 있다. |

==== 공통 코드 적용 방법 ==== 
코드성 데이터를 UI 콘트롤에 적용하는 방법은 아래와 여러가지가 존재하며, 두가지 이상을 혼용해서 사용할 수 있다.
  * PICKLIST 이용
  * XDATASET 이용
  * 스크립트 API 호출
  * "combobox_data" 속성 이용