Adding and updating Faces portlet modes for existing JSR 168 portlets

To add Faces JSR 168 portlet modes and their initial pages, or change an initial page value, edit configuration parameters using the Portlet Deployment Descriptor editor.

  1. Open the portal.xml file (double-click the Portlet Deployment Descriptor node in the Project Explorer) in the Faces portlet project to which you want to add new modes.

  2. Click the Portlets tab.

  3. In the Portlets section on the left side, select the portlet that you want to modify.

  4. In the Initialization section on the right side (you may need to scroll down), click the Add button to add a new parameter. If you merely want to change the JSP path for an existing initial page, select the parameter in the table and click Edit. Depending on which button you clicked, the New Initialization Parameter or Edit Initialization Parameter dialog will open.

  5. Type the appropriate mode name, based on the table below, and JSP path value (relative to the project context root) for the initial page. Click OK.

    Mode JSP path
    com.ibm.faces.portlet.page.view An initial JSP file path for the View mode
    com.ibm.faces.portlet.page.edit An initial JSP file path for the Edit mode
    com.ibm.faces.portlet.page.help An initial JSP file path for the Help mode
    com.ibm.faces.portlet.page.config An initial JSP file path for the Configure mode

  6. Save the portal.xml file.

If you select the Source page and scroll to the place in the portal.xml file where configuration parameters are defined, you should see generated results similar to the following example:

<init-param>
   <name>com.ibm.faces.portlet.page.edit</name>
   <value>/jsp/MyEdit.jsp</value>
</init-param>

 

Related concepts

Dynamic data using Faces components
Creating Faces portlets and projects
Faces portlet communication

 

Related tasks

Creating Faces portlet projects
Creating Faces portlets
Adding and updating Faces portlet modes for existing IBM portlets