Change Request View

The Change Request view provides a powerful search and/or reporting mechanism that allows change requests and suggestions about possible improvements to a project to be entered, assigned to a team member, and tracked.

You can open the Change Request view by taking one of the following actions:
  • Select Window > Show View > Change Request
  • Select Window > Show View > Other, and choose Change Request from the StarTeam tree node.

When you open the Change Request view, a list of change requests displays.

All change requests shown in the Change Request view have the following characteristics:
  • Are attached to the folder selected from the Server Explorer.
  • Match the filter selected from the Filter list box.
  • Match the depth specified by the All Descendants button.

Using the Change Request List

From the Change Request list that displays in the Change Request view, you can perform a variety of operations, including the following options:

  • View unread items: To see the change requests for which you are responsible but have not reviewed, look for the change requests in boldface type. The change requests in regular type are those that you have read or those for which you are not responsible.
  • View properties: To open the Properties dialog box for a specific change request, double click on it.

Filter and Sort Change Request Data

You can sort the change requests by the data in a column and change the display based on a predefined filter available in the Change Request view toolbar.

You can sort change requests by clicking on a column header to sort the displayed change requests based on the value in that column. The sort is usually in ascending numeric or alphanumeric order, depending on the data. The ascending order for Severity displays from Low to Medium to High. The ascending order for Status reflects the life cycle of the change request, so these items display from New to Closed. The ascending order for Priority displays from No to Yes. To change the sort order from ascending to descending, click the header a second time. A triangle indicating the direction of the sort appears on the header of the primary sort column.

Default Change Request View Columns

You can view the following default columns in the Change Request view:

  • CR Number: Number that StarTeam assigned to the change request when it was first submitted.
  • Synopsis: Short explanation of the change request.
  • Type: Defect or Suggestion.
  • Status: Indication of the change request life cycle. Status classifications include New, Open, Cannot Reproduce, As Designed, Fixed, Documented, Is Duplicate, or Deferred.
  • Severity: Seriousness of the change request. Severity can be Minor, Normal, Major, or Critical.
  • Responsibility: Person who is responsible for the change request.
  • Addressed In: Build in which the change request is resolved.
  • Addressed By: Name of user who resolved the change request. A change request has been resolved when its status becomes Cannot Reproduce, As Designed, Fixed, Documented, or Is Duplicate.
  • Last Build Tested: Build in which the change request occurs.
  • Work Around: Solution to a change request other than a fix.
  • Modified Time: Time the change request was last modified.
  • Priority: Indication that the change request is or is not a Priority.
  • Description: Complete explanation of the defect or suggestion, including the steps to be taken to reproduce the problem.
  • Test Command: Command that can be used to test the change request’s solution.
  • Fix: Solution to the problem addressed by the change request.
  • Entered On: Date and time the change request was submitted.
  • Entered By: Person who submitted the change request.

Change Request View Toolbar and Context Menu Actions

In addition to the other capabilities described in this section, the Change Request view toolbar and context menu enable you to use the following options:

  • Apply predefined filters for viewing lists of change requests.
  • Search (CTRL+F) for change requests.
  • Link (unlink) the view to the selected StarTeam item.
  • Optionally show all descendants to determine the depth for which the client displays information
  • Select all items.
  • Select items using a label or pre-defined query.
  • Determine which fields to display in the view.
  • Perform up to fourth order sorts.
  • Create, edit, copy, or delete queries
  • Save or reset current view filters
  • Create, edit, save, or delete filters
  • Create new change requests
  • Open change requests in various views, including History, Label, Link, and Reference views
  • Modify and review change request properties
  • Email a text representation of the change request's properties, along with additional text. The information sent includes the fields displayed in the view.
  • Compare the properties of two change requests.
  • Set the lock status.
  • Mark the item as read or unread.
  • Add, edit, enable, or disable custom fields.
  • Create URLs and HTML representations and copy them to the Windows Clipboard and paste them into email applications, Word documents, Excel spreadsheets, and so on to quickly open the item in StarTeam
  • Create, attach, and detach labels.
  • Flag and remove flags from files.
  • Delete change requests.
  • Create, complete, and cancel links
  • Create desktop shortcuts (.stx) to quickly launch the Cross-Platform Client
  • Set or clear the item as an active process item.