Creating a JavaServer Faces Page for Your Task

A JavaServer Faces page for a task uses the JSFTemplating tag sun:commonTask. This tag provides all the capabilities of the Project Woodstock tag webuijsf:commonTask.

Example 3–8 Example JavaServer Faces Page for a Task

In the example, the sampleCommonTask.jsf file has the following content:

<sun:commonTask
        text="Sample Application Page"
        toolTip="Sample Application Page"
        infoLinkUrl="/com_sun_webui_jsf/help/
helpwindow.jsf?&windowTitle=Help+Window&helpFile=applications.html" 
        onClick="admingui.nav.selectTreeNodeById('form:tree:deployment:ejb'); 
        parent.location='#{facesContext.externalContext.requestContextPath}/sample/
page/testPage.jsf?name=Sample%20Application%20Page'; return false;">
</sun:commonTask>

In the actual file, there are no line breaks in the infoLinkUrl attribute or the parent.location code values.

This file uses the sun:commonTask tag to specify the task. In your own JavaServer Faces pages, specify the attributes of this tag as follows:

text

The task name that appears on the Common Tasks page.

toolTip

The text that appears when a user places the mouse cursor over the task name.

infoLinkUrl

The URL for the link that is displayed at the bottom of the task's information panel.

onClick

Scripting code that is to be executed when a user clicks the task name. The parent.location value on the next line is part of the onClick code.