8 メニューのカスタマイズ

この章では、Oracle Identity Manager管理およびユーザー・コンソールのメニューをカスタマイズする方法について説明します。

コンソールのメニューをカスタマイズするには、次の手順を実行します。

カスタマイズするメニュー・グループまたは項目を特定し、Oracle Identity Manager Design Consoleの「Form Information」フォームを使用してそのメニュー・グループまたは項目のクラス名を取得します。

たとえば、「マイ・リソース」メニューの「新しいリソースのリクエスト」項目のクラス名は、My Resources.Request New Resourcesです。この名前は、データベースのWIN表に含まれます。対応するメニュー項目は、メニュー・グループ・コードがMy Resourcesで、メニュー項目コードがRequest New Resourcesであることを示しています。

xlWebAdmin.propertiesまたはxlDefaultAdmin.propertiesファイルを開きます。次の表に、サポートされる各アプリケーション・サーバーでのこれらのファイルの場所を示します。

表8-1 xlWebAdmin.propertiesおよびxlDefaultAdmin.propertiesファイルの場所

アプリケーション・サーバー	場所
OC4J	ファイルはOC4J_HOME\product\10.1.3.1\OracleAS_1\j2ee\home\applications\Xellerate\xlWebApp\WEB-INF\classes.で取得できます。
JBoss	JBOSS_HOME\server\default\deploy\XellerateFull.earにあるEARファイルからxlWebApp.warを抽出します。 WARファイルからxlWebApp.war\WEB-INF\classes\xlWebAdmin.propertiesおよびxlWebApp.war\WEB-INF\classes\xlDefaultAdmin.propertiesを抽出します。 xlWebAdmin.propertiesファイルまたはxlDefaultAdmin.propertiesファイルを編集します。 WARファイルを再パッケージします。 EARファイルを再パッケージします。
WebSphere	ファイルは、WS_HOME\installedApps\<cell_name>\Xellerate.ear\xlWebApp.war\WEB-INF\classesで取得できます。
WebLogic	管理サーバー: ファイルは、WL_HOME\user_projects\domains\<domain_name>\XLApplications\XLXellerateFull.ear\ xlWebApp.war\WEB-INF\classesで取得できます。管理対象サーバー: ファイルは、WL_Home\user_projects\domains\<domain_name>\<managed_server>\stage\Xellerate\ xlWebApp.war\WEB-INF\classesで取得できます。

メニュー・グループを変更するには、カスタマイズするメニュー・グループのプロパティ名をxlWebAdmin.propertiesファイル内で検索します。各メニュー・グループには、表示ラベルを示す単一のプロパティが関連付けられています。

メニュー・グループの表示ラベルのプロパティ名は、menuGroup.menu group codeの形式で、空白はハイフン（-）に置き換えられます。たとえば、My Resourcesというコードのメニュー・グループの場合、プロパティ名はmenuGroup.My-Resourcesです。プロパティに割り当てられた値を、表示するラベルに変更します。
各メニュー項目には、2つのプロパティが関連付けられています。1つはメニュー項目の表示ラベル・プロパティで、もう1つはメニュー項目のリンク・プロパティです。このリンク・プロパティにより、メニュー項目が選択されたときに表示されるターゲット・ページが識別されます。メニュー項目の表示ラベル・プロパティはxlWebAdmin.propertiesファイルに定義され、メニュー項目のリンク・プロパティはxlDefaultAdmin.propertiesファイルに定義されます。

メニュー項目の表示ラベルのプロパティ名は、menuItem.menu group code.menu item codeの形式で、空白はハイフンに置き換えられます。つまり、My-Resourcesというコードのメニュー・グループに含まれるRequest-New-Resourcesというコードのメニュー項目のプロパティ名は、menuItem.My-Resources.Request-New-Resourcesです。メニュー項目のリンク・プロパティの形式は、menuItem.menu group code.menu item code.linkです。
新規メニュー項目またはグループを作成するには、最初にOracle Identity Manager Design Consoleの「Form Information」フォームを使用して、システムに適切なエントリを作成します。次に、手順4の説明に従って、対応する新規プロパティを追加します。新規メニュー・グループごとに1つの新規プロパティが必要です。また、新規メニュー項目ごとに2つの新規プロパティが必要です。

たとえば、FavoritesおよびNon-Work Linksというコードの2つの新規メニュー項目を含むMy Linksというコードの新規メニュー・グループを追加するとします。この場合、Oracle Identity Manager Design Consoleの「Form Information」フォームでMy Links.FavoritesおよびMy Links.Non-Work Linksというクラス名を使用して、システムに2つの新規エントリを作成する必要があります。使用するクラス名は任意に指定できます（ここでの名前は単なる例です）。表示されるラベルは、これらの名前に依存しません。
手順5で指定したクラス名を使用して、xlWebAdmin.propertiesファイルに次のプロパティを追加します。
```
menuGroup.My-Links=My Links
menuGroup.My-Links.Favorites=Favorites
menuGroup.My-Links.Non-Work-Links=Non-Work Links
```
手順5で指定したクラス名を使用して、xlDefaultAdmin.propertiesファイルに次のプロパティを追加します。
```
menuGroup.My-Links.Favorites.link=favorites.do?myfavorites
menuGroup.My-Links Non-Work-Links.link=nonworklinks.do?nonworklinks
```

メニュー・グループまたは項目の名前を変更する場合、変更する必要があるのはxlWebAdmin.propertiesおよびxlDefaultAdmin.propertiesファイルのみです。データベースやコードを変更する必要はありません。