|
| |
| Sun Java System Identity Installation Pack 2005Q4M3 릴리스 노트 | |
6
사용자 정의 메시지 카탈로그
이전 릴리스에서는 배포자가 WPMessages.properties 파일을 편집하여 메시지 카탈로그 항목을 추가하거나 시스템에 제공된 항목을 수정해야 했습니다. 그러나 현재 릴리스에서는 사용자가 사용자 정의 메시지 카탈로그를 만들 것을 권장합니다. 사용자 정의 메시지 카탈로그의 장점은 다음과 같습니다.
Identity Manager에서는 다음과 같은 순서로 메시지 카탈로그 항목을 검색합니다.
메시지 카탈로그 형식
WPMessages.properties 파일에서는 항목이 KeyName=MessageText 형식으로 정의됩니다. 사용자 정의 메시지 카탈로그에서는 각 항목이 별도의 Msg 요소로 지정됩니다. KeyName은 id 속성에 지정되고 MessageText는 텍스트 간에 지정됩니다. 다음 예제에서는 메시지 카탈로그 항목에 대해 설명합니다.
<Msg id='UI_REMEMBER_PASSWORD'>Remember to set your password.</Msg>
메시지 텍스트는 텍스트가 렌더링되는 방법을 제어하는 HTML 태그를 포함할 수 있지만, 태그는 사용하지 않는 것이 좋습니다. HTML 태그를 사용해야 할 경우 < 및 >과 같은 기호 대신 < 및 >과 같은 코드를 사용합니다.
또한, 메시지 텍스트는 표시되는 문자열에 삽입될 데이터에 대한 변수를 포함할 수 있습니다. 다음 예제는 AR_CORRELATED_USER 키에 대한 기본 메시지입니다.
Correlated account with user {0}.
렌더링된 버전은 다음으로 표시될 수 있습니다.
Correlated account with user jdoe.
사용자 정의 메시지 카탈로그 만들기
다음 절차에서는 사용자 정의 메시지 카탈로그를 만드는 방법에 대해 설명합니다.
- 기본 메시지 카탈로그 항목을 대체할 경우 WPMessages.properties 파일에서 해당 오류 메시지 키를 찾습니다. 사용자 정의 메시지 카탈로그에서 이러한 키를 지정해야 합니다.
새 메시지를 만들 경우 키가 WPMessages.properties 파일에 표시되는지 확인합니다.
- XML 파일 또는 블록을 다음과 같은 구조로 만듭니다.
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>
<Configuration name='CatalogName'>
<Extension>
<CustomCatalog id='CatalogName' enabled='true'>
<MessageSet language='en' country='US'>
<Msg id='KeyName'>MessageText</Msg>
<Msg id='KeyName'>MessageText</Msg>
...
</MessageSet>
</CustomCatalog>
</Extension>
</Configuration>
여기서,
CatalogName은 메시지 카탈로그의 이름입니다. 이 값은 SystemConfiguration 객체에서 카탈로그를 정의하는 데에도 사용됩니다.
KeyName은 메시지 키 이름입니다.
MessageText는 그래픽 사용자 인터페이스에 표시되는 문자열입니다. 이 텍스트는 HTML 태그와 변수를 포함할 수 있습니다.
en_US 이외의 로켈을 지원할 경우 language 및 country 속성을 변경합니다. 여러 로켈을 지원할 경우 각 로켈에 대한 별도의 MessageSet 요소를 만듭니다.
작업 예제는 예제 절을 참조하십시오.
- 파일 또는 블록을 Identity Manager로 가져옵니다.
- 시스템 구성 객체를 로드하고 <Configuration><Extension><Object> 요소 내에 다음 줄을 추가합니다.
<Attribute name='customMessageCatalog' value='CatalogName'/>
- 시스템 구성 객체에 대한 변경 사항을 저장합니다.
- 응용 프로그램 서버를 다시 시작합니다. 이제 새 메시지 카탈로그 항목을 사용할 수 있습니다.
예제
다음 예제에서는 myCustomCatalog라는 사용자 정의 메시지 카탈로그를 만들고 교환 파일 가져오기 하위 탭의 레이블과 도움말 텍스트를 대체합니다.
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>
<Configuration name='myCustomCatalog'>
<Extension>
<CustomCatalog id='myCustomCatalog' enabled='true'>
<MessageSet language='en' country='US'>
<Msg id='UI_SUBNAV_CONFIGURE_IMPORT_EXCHANGE'>Import XML File</Msg>
<Msg id='UI_SUBNAV_CONFIGURE_IMPORT_EXCHANGE_HELP'>Loads the specified XML file.</Msg>
</MessageSet>
</CustomCatalog>
</Extension>
</Configuration>