This section describes the request parameters
that you
can use in JSP files to customize home page content.
Home page
form parameters
To support dynamic
home page content such as sections, action-needed sections, tasks,
a Java™ bean is available as
a request parameter called
HomePageForm. The home page Java bean contains a handful of
methods that can be used to access information about sections and
tasks.
Table 1. Home page request parameters, values, and descriptions| Property name |
Value |
Description |
|---|
| sections |
List of
Section Java beans |
A list of sections the current user can view.
|
| sectionToTaskMap |
Map of sections to their corresponding tasks |
A map that links a specified section Java bean to a task Java bean. |
| actionNeededSection |
Section Java bean, or null |
A section Java bean that contains
the pending actions for the current user. A null
is used if no pending actions exist for the current user. |
The following properties are available
for the section Java bean:
Table 2. Section Java bean request
parameters, values,
and descriptions| Property name |
Value |
Description |
|---|
| titleKey |
Title message key for the section |
The message key for the section title. |
| iconUrl |
Icon
URL, or null |
The URL path for the
icon to be used for the section.
A null is used to indicate that no icon is used. |
| iconAltTextKey |
Text key |
Text key to be used as
the alternate text
for the icon of the section. |
| tasks |
List of task Java beans |
A list of tasks that can be displayed in the section |
The following properties are available
for the task Java bean:
Table 3. Task Java bean request
parameters, values,
and descriptions| Property name |
Value |
Description |
|---|
| urlPath |
URL |
A URL path to
this task. |
| urlKey |
Text key |
The text
key to be used for the link to
this task. |
| descriptionKey |
Text key |
Text
key to be used as the description of
this task. |
Examples of request parameters in home.jsp
The following
code obtains the
HomePageForm Java bean and iterates through
the available sections and tasks and creates links to each available
task.
<c:set var="pageConfig" value="${HomePageForm}" scope="page" />
<c:forEach items="${pageConfig.sections}" var="section">
<%-- Process each section here --%>
<c:forEach items="${pageConfig.sectionToTaskMap[section]}" var="task">
<%-- Process each section here --%>
<a href="/itim/self/<c:out value="${task.urlPath}"/>"
title="<fmt:message key="${task.urlKey}" />">
<fmt:message key="${task.urlKey}" />
</a>
<fmt:message key="${task.descriptionKey}" />
</c:forEach>
</c:forEach>