Customizing the Detail Pane

You can modify the display format and content of the Detail (lower) pane on a per-workstation basis by placing correctly named and formatted HTML templates in the same directory as the starteam-servers.xml and starteam-client-options.xml files. For example, on a Microsoft Windows system these files could be located in the C:\Documents and Settings\USER\Application Data\Micro Focus\StarTeam folder.

Sample Detail pane templates are installed under the root installation folder in the samples\details-templates folder.

The name of the template file controls the StarTeam component to be modified. For example, a template named changerequest.details.html controls the format and content of the Detail pane display for the change request component.

To customize the fields that display in the Detail (lower) panes, do the following:

1. Create an HTML template file for the corresponding component that you wish to customize. For example, if you want to format the contents of the Detail pane for a change request, you would create a template file named changerequest.details.html.

   You must use the following file names for the component detail panes that you wish to customize:

   • folder.details.html
   • file.details.html
   • changerequest.details.html
   • task.details.html
   • topic.details.html
   • requirement.details.html
   • changepackage.details.html

2. Make any desired modifications to the template file.

   Follow the formatting example in the sample template file. The fields used in the Detail pane HTML templates are recognized by the client when they are contained between double tilde ~~ characters. For example: ~~Status~~ represents the Status field found in the Change Request Properties dialog box.

3. Save the template files in the same directory as the starteam-servers.xml and starteam-client-options.xml files. For example, on a Microsoft Windows system these files could be located in the C:\Documents and Settings\USER\Application Data\Micro Focus\StarTeam folder.