Change Request Options

Tools > Personal Options > Change Request

Use the Change Request options to specify the criteria that the application uses to determine whether a change request has been read. You can also indicate how often the application should search for new change requests and how change request locking issues should be handled.

Mark as read

When change request is selected: Marks an asset as read as soon as you select it. An unread asset is displayed with bold font. A read asset is displayed with regular font.
When selected for ___ seconds: Marks an asset read after it has been selected for the specified number of seconds. The range is from 15 to 9999 seconds.
Only when manually marked as read: Marks a selected asset read when you choose Change Request > Mark as Read .

Note: Assets are always marked as read when you display their properties.

System tray notifications

Check for new or modified change requests: Checks for new or modified assets at regular intervals and lets you know that you have become responsible for new assets. If this option is checked, you must also specify the number of minutes between checks in the Interval option below. When unchecked, the application does not place an icon in the system tray for a new change request.
Interval (in minutes): Specifies the number of minutes between automatic checks for new or modified assets. The default is 10 minutes.

Locking

Exclusively lock change request during edit: Locks an asset when you open its Properties dialog box for editing. If unchecked, the application does not lock assets when you open its Properties dialog box.
Clear manually locked change requests after edit: Unlocks a locked asset after you have edited its properties and clicked OK to create a new revision. If unchecked, the application does not remove the locks.

URL Options

Display template: Specifies a special template used to generate an HTML representation of an item when the item’s URL is copied to the Clipboard. With no format, there is a default HTML representation that specifies the type of item and identifies it by name and number. When the text is generated from the template, the specified property values are substituted for the variables in ~~*~~. The variables may be referenced by the same names used in report templates, as well as by the display name of the property. When using the display name, you can omit spaces, and case will be ignored. For example, if you use the following sample template for a file: Change Request:~~CR Number~~:~~CreatedBy~~, the HTML representation will be the Change Request:38,849:Tom Smith. This template is a superset of that used by the Report feature of the client.
Generate ID-based URLs: Specifies the URL by ID rather than by name. For example, an ID-based URL would be starteam://hostname:49201/12;ns=Project;scheme=id, while a name-based URL would be starteam://hostname:49201/myproject.
Note: Folders always use an ID-based URL.

Note: If you do not select either of the locking options, opening a change request will not lock it; you must manually lock and unlock it. If you select the Exclusively Lock option only, change requests that are not already locked become locked when you open them and unlocked when you click Cancel or OK. If you select the Clear change request Locks option only, any change request that you have locked manually becomes unlocked when you click OK to create a new revision. If you select both options, you can lock change requests manually or by opening them. These change requests become unlocked when you click OK to create new revisions or (if they were not locked prior to being opened) when you click Cancel.