Sun Java System Identity Server version 2004Q2

     Administration Console: New Tab Sample

  ------------------------------------------------------------

     Purpose

     Demonstrate how to add a new tab to the header view that is
     visible only to the top level administrator.

     How is this done? Three new classes are needed, one for the
     navigation frame (UMNewTabNavViewBean), one for the data frame
     (UMNewTabDataViewBean), and one to decide if the tab should be
     displayed (UMNewTabListener). UMNewTabListener is invoked by the
     framework prior to the tab being displayed. This class detemines
     whether or not the user is a top-level administrator, which then
     allows the tab to be displayed. When the new tab is selected
     UMNewTabNavViewBean is invoked and the navigation frame gets
     refreshed and a link is displayed. Selecting the link will refresh
     the data frame with the current location DN.

  ------------------------------------------------------------

     Files

     1. UMNewTabNavViewBean.java
     2. UMNewTabDataViewBean.java
     3. model/UMNewTabModel.java
     4. model/UMNewTabModelImpl.java
     5. model/UMNewTabListener.java
     6. jsp/UMNewTabNav.jsp
     7. jsp/UMNewTabData.jsp

  ------------------------------------------------------------

     Directions

     1. Copy the above JSP files to
     /opt/SUNWam/web-src/applications/console/user

     2. Add the the following resource strings to the console
     properties file /opt/SUNWam/locale/amAdminModuleMsgs.properties
     newTabNavLink.label=Invoke Data View
     newTabDataInvoked.message=Data View is invoked. Current location
     is
     module105_new=New Tab

     3. Compile the Java files
     cd /opt/SUNWam/samples/console/NewTab
     gmake all

     4. Create a new jar with the sample class files.
     cd /opt/SUNWam/samples/console
     jar cf am_console_sample.jar com

     5. Copy the am_console_sample.jar into
        /opt/SUNWam/web-src/applications/WEB-INF/lib

     6. Redeploy the console
     Set the DEPLOY_LEVEL to 22 in the silent file
     For webserver: run amws61config -s <silent file>
     For application server: run amas70config -s <silent file>

     7. Login as Top Level Administrator, select the Service
     Configuration tab, and select Administration Service. Add the
     following entry to the View Menu Entries attribute.
     module105_new|/amconsole/user/UMNewTabNav

     8. Add com.iplanet.am.console.user.model.UMNewTabListener to the
     Event Listener Class attribute.

     9. To see the new tab you can either re-login, or you can refresh
     the header frame of the console (by selecting one of the other
     visible tabs.)
