この章では、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ファイルの場所
メニュー・グループを変更するには、カスタマイズするメニュー・グループのプロパティ名を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ファイルのみです。データベースやコードを変更する必要はありません。