이 문서는 rootHR에서 사용하는 항목코드의 역할과 관리 방법,
그리고 다국어 환경에서 코드명을 설정하는 기준을 안내합니다.
항목코드는 인사·근태·급여 등 여러 모듈에서 공통으로 사용되는 기준 데이터로,
시스템 운영의 일관성과 데이터 정합성에 직접적인 영향을 줍니다.
메뉴 경로 #
시스템 > 시스템 환경설정 > 항목코드 관리
시스템 > 시스템 환경설정 > 항목코드 다국어 설정
항목코드 이해하기 #
항목코드는 시스템 전반에서 사용되는 공통 선택값(기준값)을 정의하는 설정입니다.
발령 유형, 상태값, 구분 코드 등 다양한 화면에서 항목코드를 기준으로 데이터가 관리됩니다.
항목코드는 다음과 같은 구조로 관리됩니다.
- 코드그룹: 항목코드를 묶는 상위 기준
- 상세코드: 실제 화면과 데이터에 사용되는 코드 값
항목코드는 한 번 사용되기 시작하면 여러 데이터와 연결되기 때문에 운영 중 변경 시 특히 주의가 필요합니다.
항목코드 조회하기 #
- 코드그룹별로 등록된 상세코드를 조회할 수 있습니다.
- 회사 운영 기준에 맞춰 항목코드를 추가·수정·삭제할 수 있습니다.
- 코드그룹을 지정하지 않고 검색하면 전체 코드가 조회됩니다.
항목코드 추가하기 #
- 코드그룹을 선택하거나 입력한 후
검색을 클릭합니다. 추가를 클릭하면 상세코드에 새로운 입력 행이 추가됩니다.- 코드, 코드명(한글), 순서를 입력합니다.
- 필요한 경우 영문코드명을 함께 입력합니다.
- 입력이 완료되면
저장을 클릭합니다.
📌 필수여부에 체크된 코드는 시스템 기본 동작에 사용하는 코드이므로 수정 또는 삭제가 제한됩니다.
항목코드 수정하기 #
- 코드명이 잘못되었거나 표현을 변경해야 하는 경우 수정할 수 있습니다.
- 이미 사용 중인 코드의 의미 변경은
기존 데이터 해석에 영향을 줄 수 있으므로 신중하게 진행해야 합니다.
항목코드 삭제하기 #
- 실제 데이터에 사용 중인 코드는 삭제할 수 없습니다.
- 더 이상 사용하지 않는 경우에도
삭제보다는 미사용 처리 또는 운영 기준 변경을 권장합니다.
📌 운영 포인트
항목코드는 데이터 이력과 직접 연결되므로, 운영 중 코드 추가·수정·삭제 시에는
해당 코드가 어디에서 사용되는지 반드시 확인해야 합니다.
다국어 항목 등록하기 #
다국어를 사용하는 회사의 경우, 항목코드에 대해 언어별 코드명을 설정할 수 있습니다.
다국어 코드 설정은 직원의 언어 설정에 따라 화면에 표시되는 코드명을 제어하기 위한 기능입니다.
메뉴 경로
시스템 > 시스템 환경설정 > 항목코드 관리
- 항목코드별로 영문, 일문, 중문 코드명을 등록할 수 있습니다.
- 언어별 코드명이 등록되지 않은 경우, 기본 한글 코드명이 표시됩니다.
- 다국어 설정은 코드 값에는 영향을 주지 않고, 표시 이름에만 적용됩니다.
