Configuring the Default Home Page for the Content Frame

There are a number of ways you can specify the page that displays in the content frame of the Navigator window when users log in. The content frame is referred to as the Home page in the user interface. You can use one of these methods:

This task shows you how to:

Pass the ContentPage Parameter to emxNavigator.jsp

The value for the ContentPage can be the URL for any JSP, plus any needed URL parameters.

  • Define the value for the ContentPage URL parameter to pass to emxNavigator.jsp.

    The value for the ContentPage can be the URL for any JSP, plus any needed URL parameters. For example:

    emxNavigator.jsp?ContentPage=../engineeringcentral/
emxMyTasksSummaryFS.jsp

    Where ../engineeringcentral/emxMyTasksSummaryFS.jsp is the URL for the Tasks page within Engineering Central.

    The URL assigned to the ContentPage parameter can contain only one parameter/value pair as part of the URL. Any additional parameters are ignored.

Pass the CommandName and MenuName Parameters to emxNavigator.jsp

The values for the CommandName and MenuName parameters combine to define which content page should be loaded.

  • Define the value for both the CommandName and MenuName URL parameters to pass to emxNavigator.jsp.

    These parameters let you specify the name of a menu and command object pair to display in the content frame. The system displays the URL associated with the command object attached to the menu. The parameters are:

    • MenuName. Gets the name of the menu object for the submenu that has the command object attached. The links in the Actions submenus cannot be used for display in the content frame.
    • CommandName. Gets the name of the administrative command object from which the href URL is to be obtained.

    For example: 

    emxNavigator.jsp?MenuName=TMCMyDesk&CommandName=TMCRoutesMyDesk

    Where TMCMyDesk is the name of the menu object for the Team Central submenu in the DS (formerly My Desk) menu and TMCRoutesMyDesk is the name of the command object for the Routes link. This command object contains an href parameter that points to the JSP for the Routes page.

Pass an objectId to emxNavigator.jsp

You can pass an objectId to load the tree for that specific object.

  • Define a value for the objectId URL parameter to pass to emxNavigator.jsp.

    For example: 

    emxNavigator.jsp?objectId= 29547.17050.1266.35700

    Where 29547.17050.1266.35700 is the ID for the business object for which the default page for that object.

Define a Home Page in emxSystem.properties

You can define a value for the emxNavigator.Home.ContentPage property in the emxSystem.properties file to define which page to open.

  1. Open the emxSystem.properties file for editing.

  2. Locate this line:

    emxNavigator.Home.ContentPage = 
emxDefaultNavigatorContentPage.jsp

    By default this property is set to the default home page, which is the welcome page or emxDefaultNavigatorContentPage.jsp.

  3. Set the value for this property to the name of the jsp page you want to use as the system default.

  4. If needed, continue editing the emxSystem.properties file. If finished, save the file.

  5. When finished making all properties file edits, restart the application server. If using a J2EE implementation, run the warutil and deploy files as usual.