Adding a Task Group to the Common Tasks Page

You can add a new group of tasks to the Common Tasks page to display the most important tasks for your add-on component. To add a task group, use an integration point of type org.glassfish.admingui:commonTask.

Example 3–9 Example Task Group Integration Point

In the example console-config.xml file, the following integration-point element adds a new task group to the Common Tasks page:

       <integration-point 
            id="sampleGroup" 
            parentId="commonTasksSection"
            type="org.glassfish.admingui:commonTask" 
            priority="500"
            content="sampleTaskGroup.jsf"
        />

This example specifies the following values:

• The id value, sampleGroup, specifies the integration point ID.

• The parentId value, commonTasksSection, specifies that the task group is to be placed on the Common Tasks page.

• The type value, org.glassfish.admingui:commonTask, specifies the integration point type as a common task.

• The priority value, 500, specifies the order of the task group on the Common Tasks page. The low value places it at the end of the page.

• The content value, sampleTaskGroup.jsf, specifies the JavaServer Faces page that displays the task.

Creating a JavaServer Faces Page for Your Task Group

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

Example 3–10 Example JavaServer Faces Page for a Task Group

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

<sun:commonTasksGroup title="My Own Sample Group">
    <sun:commonTask
        text="Go To Sample Resource"
        toolTip="Go To Sample Resource"
        infoLinkUrl="/com_sun_webui_jsf/help/
helpwindow.jsf?&windowTitle=Help+Window&helpFile=jdbcconnectionpoolnew1.html" 
        onClick="admingui.nav.selectTreeNodeById('form:tree:resources:treeNode1'); 
        parent.location='#{facesContext.externalContext.requestContextPath}/sample/
page/testPage.jsf?name=name=Sample%20Resource%20Page'; return false;">
    </sun:commonTask>
    <sun:commonTask
        text="Sample Configuration"
        toolTip="Go To Sample Configuration"
        infoLinkUrl="/com_sun_webui_jsf/help/
helpwindow.jsf?&windowTitle=Help+Window&helpFile=jdbcconnectionpoolnew1.html" 
        onClick="admingui.nav.selectTreeNodeById(
                     'form:tree:configuration:sampleConfigNode'); 
        parent.location='#{facesContext.externalContext.requestContextPath}/sample/
page/testPage.jsf?name=Sample%20Configuration%20Page'; return false;">
    </sun:commonTask>
</sun:commonTasksGroup>

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

This file uses the sun:commonTasksGroup tag to specify the task group, and two sun:commonTask tags to specify the tasks in the task group. The sun:commonTasksGroup tag has only one attribute, title, which specifies the name of the task group.