====== 프로퍼티 설정관리 ======
===== 1. 개요 ======
프로퍼티 서비스 설정관리는 전자정부표준프레임워크 실행환경에서 제공하는 프로퍼티 서비스를 이용하기 위한 설정 파일을 관리할 수 있는 기능을 제공한다.
전자정부 표준 프레임워크에서 제공하는 프로퍼티 서비스는 두 가지로 나눌 수 있는데. 하나는 해당 프로퍼티 서비스 설정파일 안에 관리하고자 하는 프로퍼티를 설정할 수 있는 inline properties 와 외부 프로퍼티 파일에  관리하고자 하는 프로퍼티를 설정하는 outer properties 가 있다.

프로퍼티 설정관리 에서는 2가지 서비스 모두 관리 할 수 있으며, 프로퍼티 서비스에 대한 자세한 내용은 [[https://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte:fdl:property]] 참고한다.

===== 2. 설명 ======

==== 프로퍼티 설정관리 ====
기본적으로 설정관리 도구의 프로퍼티 설정관리는 외부 프로퍼티(egovsms.properties) 파일에 선언해 놓은 프로퍼티 서비스 설정파일을 읽어서 Bean ID 별 목록으로 조회 할 수 있다.
전자정부 표준 프레임워크에서 제공하는 프로퍼티 서비스의 설정은 egovframework.rte.fdl.property.impl.EgovPropertyServiceImpl를 구현 클래스로 하여 
properties ,extFileName 두가지의 프로퍼티 명이 정해져 있기 때문에 신규 설정을 생성하거나 할 때, properties ,extFileName 중 하나를 선택하여 필요한
프로퍼티를 설정하면 된다.

=== 프로퍼티 설정관리 목록 조회 ===
설정관리 도구 메인화면 >> 좌측 메뉴 >> 프로퍼티 설정관리 선택


== 프로퍼티 설정파일 과 설정관리 화면 비교 ==
    * context-properties.xml
<code xml>
<bean name="propertiesService" class="egovframework.rte.fdl.property.impl.EgovPropertyServiceImpl" 
destroy-method="destroy">				 
	<property name="properties">
	   <map>
	     <entry key="pageUnit" value="10"/>
	     <entry key="pageSize" value="10"/>
	     <entry key="Globals.fileStorePath" value="/user/jeus/files/cms/"/>
	   </map>
	</property>
</bean>
</code>

    * 설정관리 도구 표현
아래와 같이 설정파일에 표현된 Bean Name 별로 목록을 보여주며 해당 Bean 명을 클릭하면 각 빈의 상세 설정을 조회 할 수 있다.

{{:egovframework:oe1:설정관리:가이드:프로퍼티_설정관리목록.jpg|}}
    * 버튼 설명
    - 신규빈등록 : 기존 설정이 존재할 때, properties OR extFileName 등 다른 설정을 추가 할 경우 사용
    - 신규등록 : 프로퍼티 서비스 설정이 아예 존재하지 않거나 기존 설정이 있다 하더라도 삭제하고 재작성 할 경우 사용

=== 프로퍼티 설정관리 상세 조회 ===
설정관리 도구 메인화면 >> 좌측 메뉴 >> 프로퍼티 설정관리 >> 조회된 목록에서 프로퍼티 명( properties,extFileName) 선택

아래와 같이 선택한 Bean 의 상세 설정을 HTML Table 을 이용하여 조회 할 수 있다.
각 체크 박스를 이용하여 프로퍼티삭제가 가능하며, 삭제 후 저장을 통해 화면에서 수정사항을 반영할 수 있다.

{{:egovframework:oe1:설정관리:가이드:프로퍼티_설정관리상세.jpg|}}
    * 버튼 설명
    - 프로퍼티 추가: 프로퍼티를 추가할 경우 사용
    - 프로퍼티 삭제: 체크 박스로 선택한 프로퍼티를 삭제함
    - 미리보기: 현재 상세조회 되고 있는 Bean을 포함하여 저장되지 않은 변경 사항을 포함하여 XML 파일을 팝업창으로 미리 볼 수 있다.
    - 저장: 현재 화면에서 수정된 사항을 파일에 반영할때 사용
    - 삭제: 현재 상세조회 하고 있는 Bean 설정을 설정파일에서 삭제함
    - 목록: 목록 화면으로 이동

== 프로퍼티 추가 ==
프로퍼티 추가 버튼을 눌러서 ROW 를 하나 추가한 다음 관리하고자 하는 Entry를 Key, Value 로 넣어준다.
External 프로퍼티의 경우 프로퍼티 파일 경로를 넣는다.

{{:egovframework:oe1:설정관리:가이드:프로퍼티_설정관리추가.jpg|}}

== 프로퍼티 삭제 ==
삭제할 프로퍼리를 체크 박스로 선택하여 일괄 삭제 한다.

{{:egovframework:oe1:설정관리:가이드:프로퍼티_설정관리삭제.jpg|}}

== 미리보기 ==
화면에서 변경할 사항을 실제 설정파일을 수정하기 전에 미리보기로 볼 수 있다.

{{:egovframework:oe1:설정관리:가이드:프로퍼티_설정관리미리보기.jpg|}}

=== 비지니스 규칙 ===
설정관리 도구의 프로퍼티 서비스 설정관리는 아래와 같은 비지니스 규칙을 갖는다. 규칙에 위반 될 경우, Validation 체크를 통해 저장이 방지 된다.
    - 상세 조회시 Bean 클래스 및 Bean 명은 수정할 수 없다.
    - Bean class는 egovframework.rte.fdl.property.impl.EgovPropertyServiceImpl 만 가능하며, properties OR extFileName 외에 다른 프로퍼티명은 선택할 수 없다. 
    - properties / extFileName 의 프로퍼티가 기존 설정에 존재하는 경우, 다시 동일한 프로퍼티를 등록할 수 없다.
    - 특수문자의 경우,  파일 경로 및 Cron Expression 등 (/ * : . - _ ?)만 입력 가능하며 한글 입력은 불가하다.

===== 3. 참고자료 ======
properties Serivce
  * [[https://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte:fdl:property]]