Sun Java System Communications Express 6 2005Q4 Customization Guide

Customizing Views

These examples show how to modify views

Customizing Tasks Search View

The file name including path that pertains to tasks search view is <calclient-dir>/tasksSearch.jsp
The common components present in tasksSearch.jsp are: Banner, Application bar, calendar tool bar
In the tasksSearch.jsp you can customize
- The overall layout and look and feel.
- Icons or images such as select_all, unselect_all, sort_up, sort_down, sort_selected_up, sort_selected_down gifs.
- Task related informative icons or images such as recurring gif, reminding gif, public task gifs.
- The table column ordering.
- The edit task and view task popup window sizes and styles.

Customizing the Column Order in Tasks Printable View

The file pertaining to customizing the column order in tasks is <calclient-dir>/tasksPrint.jsp

The common components present are Banner and Application bar.

You can customize the table column ordering.

The tasksPrint.jsp is located at <calclient-dir>/tasksPrint.jsp

Example 3–5 shows the code used to customize Tasks print view in a table with the columns in the order - 'Priority', 'Title', 'Due Date', 'Status', 'Type' :

Example 3–5 Default Ccode that Displays the Table Column Order:

<th class="TblThCl1" scope="col" nowrap><strong>
<%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Priority", "Priority") %></strong></th>
 <th width="35%" scope="col" nowrap><strong><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Title", "Title") %></strong></th>
            <th scope="col" nowrap><strong><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-DueDate", "Due Date") %></strong></th>
            <th scope="col" nowrap><strong><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Status", "Status") %></strong></th>
            <th scope="col" nowrap><strong><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Type", "Type") %></strong></th>
          </tr>

  <jato:content name="ZeroTasks">
          <tr>
              <td class="TblTdCl1Lst" colspan="6"><%= 
getLocalizedLabel(session, "uwc-calclient-tasks-NoTasksToDisplay-message", 
"This view does not have any tasks to display. 
Choose another filter or search for tasks.") %></td>
          </tr>
  </jato:content>
  <jato:content name="NonZeroTasks">
      <jato:tiledView name="TasksTiledView" 
type="com.sun.uwc.calclient.TasksTileView">
          <jato:hidden name="TaskCalID"/>
          <jato:hidden name="TaskUID"/>
          <jato:hidden name="TaskRID"/>
          <tr>
            <td <jato:content name="FirstColumnStyle"/> 
align="center"><jato:text name="Priority" escape="false"/></td>
        <jato:content name="IsConfidential">
            <td <jato:content name="TitleColumnStyle"/>>
<%= getLocalizedLabel(session, "i18nModel", 
			"uwc-calclient-view-Busy", "Busy") %></td>
        </jato:content>
        <jato:content name="IsNotConfidential">
            <td <jato:content 
name="NormalColumnStyle"/>><strong><jato:text name="Title"/></strong><br>
              <jato:content name="HasAlarm">
                <img src="<%= getLocalizedLabel(session, "skinModel", 
"uwc-calclient-NotifyImage", "../uwc/images/LrlNotify_1.gif") %>"width="12"
height="12" border="0" hspace="2" align="absmiddle" alt="<%= 
getLocalizedLabel(session, "uwc-calclient-tasks-Notify", "Notify") %>" 
title="<%= getLocalizedLabel(session, "uwc-calclient-tasks-Notify",
"Notify") %>">
              </jato:content>
              <jato:content name="IsRecurring">
                <img src="<%= getLocalizedLabel(session, "skinModel", 
"uwc-calclient-RecurringImage", "../uwc/images/LrlRecur_1.gif") %>" 
width="12" height="12" border="0" align="absmiddle" hspace="2" 
title="<%= getLocalizedLabel(session, "uwc-calclient-tasks-Recurring",
"Recurring")
%>" alt="<%= getLocalizedLabel(session, "uwc-calclient-tasks-Recurring", 
"Recurring") %>">
              </jato:content>
              <jato:content name="IsPublic">
                <img src="<%= getLocalizedLabel(session, "skinModel", 
"uwc-calclient-PublicImage", "../uwc/images/LrlPrvPub_1.gif") %>" 
width="12" height="12" border="0" hspace="2" 
title="<%= getLocalizedLabel(session, "uwc-calclient-tasks-Public",
"Public") %>" 
alt="<%= getLocalizedLabel(session, "uwc-calclient-tasks-Public",
"Public") %>">
              </jato:content>
              <jato:content name="IsExternal">
                <br>
                [<jato:text name="OwnerName"/>&nbsp;
(<jato:text name="CalendarName"/>)]
              </jato:content>
            </td>
        </jato:content>
            <td <jato:content name="NormalColumnStyle"/>>
<jato:text name="DueDate"/>&nbsp;<jato:text name="DueTime"/></td>
            <td <jato:content name="NormalColumnStyle"/>>
<jato:text name="PercentStatusAsText" escape="false"/></td>
            <td <jato:content name="NormalColumnStyle"/>>
<jato:text name="Category" escape="false"/></td>
          </tr>
      </jato:tiledView>
  </jato:content>

Example 3–6 shows the code required to change the table column ordering so that it displays in the order title, due date, status, priority and type

Example 3–6 Changed table column ordering

<tr>
<th class="TblThCl1" scope="col" nowrap>
<strong><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Priority", "Title") %></strong>
</th>
<th width="35%" scope="col" nowrap><strong>
<%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Title", "Due Date") %></strong></th>
<th scope="col" nowrap><strong><%= getLocalizedLabel(session,
"uwc-calclient-tasks-Status", "Status") %></strong></th>
 <th scope="col" nowrap><strong><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-DueDate", "Priority") %></strong></th>
 <th scope="col" nowrap><strong><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Type", "Type") %></strong></th>
</tr>

  <jato:content name="ZeroTasks">
 <tr>
 <td class="TblTdCl1Lst" colspan="6"><%= getLocalizedLabel(session, 
"uwc-calclient-tasks-NoTasksToDisplay-message", 
"This view does not have any tasks to display. 
Choose another filter or search for tasks.") %></td>
          </tr>
  </jato:content>
  <jato:content name="NonZeroTasks">
      <jato:tiledView name="TasksTiledView" 
type="com.sun.uwc.calclient.TasksTileView">
          <jato:hidden name="TaskCalID"/>
          <jato:hidden name="TaskUID"/>
          <jato:hidden name="TaskRID"/>
          <tr>
        <jato:content name="IsConfidential">
            <td <jato:content name="TitleColumnStyle"/>><%= 
getLocalizedLabel(session, "i18nModel", 
"uwc-calclient-view-Busy", "Busy") %></td>
        </jato:content>
        <jato:content name="IsNotConfidential">
<td <jato:content name="FirstColumnStyle"/> align="center"><strong>
<jato:text name="Title"/></strong><br>
              <jato:content name="HasAlarm">
                <img src="<%= getLocalizedLabel(session, "skinModel", 
"uwc-calclient-NotifyImage", "../uwc/images/LrlNotify_1.gif") %>" 
width="12" height="12" 
border="0" hspace="2" align="absmiddle" alt="<%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Notify", "Notify") %>" 
title="<%= getLocalizedLabel(session, 
"uwc-calclient-tasks-Notify", "Notify") %>">
  </jato:content>
 <jato:content name="IsRecurring">
 <img src="<%= getLocalizedLabel(session, "skinModel",
"uwc-calclient-RecurringImage", "../uwc/images/LrlRecur_1.gif") %>" 
width="12" 
height="12" border="0" align="absmiddle" hspace="2" title="<%= 
getLocalizedLabel(session, "uwc-calclient-tasks-Recurring", 
"Recurring") %>" 
alt="<%= getLocalizedLabel(session, "uwc-calclient-tasks-Recurring", 
"Recurring") %>">
              </jato:content>
              <jato:content name="IsPublic">
                <img src="<%= getLocalizedLabel(session, "skinModel", 
"uwc-calclient-PublicImage", "../uwc/images/LrlPrvPub_1.gif") %>" 
width="12" height="12" border="0" hspace="2" title="<%= 
getLocalizedLabel(session, "uwc-calclient-tasks-Public", "Public") %>" 
alt="<%= getLocalizedLabel(session, "uwc-calclient-tasks-Public", 
				"Public") %>">
              </jato:content>
              <jato:content name="IsExternal">
                <br>
 [<jato:text name="OwnerName"/>&nbsp;(<jato:text name="CalendarName"/>)]
              </jato:content>
            </td>
        </jato:content>
            <td <jato:content name="NormalColumnStyle"/>>
<jato:text name="DueDate"/>&nbsp;<jato:text name="DueTime"/></td>
            <td <jato:content name="NormalColumnStyle"/>>
<jato:text name="PercentStatusAsText" escape="false"/></td>
            <td <jato:content name="NormalColumnStyle"/>>
<jato:text name="Priority" escape="false"/></td>
            <td <jato:content name="NormalColumnStyle"/>>
<jato:text name="Category" escape="false"/></td>
          </tr>
      </jato:tiledView>

Customizing Tasks Error View

To modify the tasks error view, you need to edit the file <calclient-dir>/tasksError.jsp

Customizing Events view

To modify the events view, edit the following JSP file.

<calclient-dir>/EventsManager.jsp

To modify the search events view, edit the following JSP file.

<calclient-dir>/eventsSearch.jsp

To modify the anonymous events view, edit the following JSP file.

<calclient-dir>/EventsManagerAnon.jsp

To modify the anonymous search events view, edit the following JSP file.

<calclient-dir>/eventsSearchAnon.jsp

To modify the anonymous Error view, edit the following JSP file.

<calclient-dir>/eventsanonError.jsp

To modify the printable images view, edit the following image. You can change the image and then replace the changed image in the root folder.

uwc-common-PrintableImage=../uwc/images/LrlPrintable_1_wo.gif

Customizing Tasks View

To modify the tasks view, you need to modify the file <calclient-dir>/tasks.jsp.