Folder Options

The folder options enable you to specify the criteria that the application uses to determine whether a folder has been read. You can also indicate how often the application should search for new folders and how folder locking issues should be handled.

Select Tools > Personal Options > Folder

Check-out

Use Last Modification Time for Folders During Checkout

Uses the last modification time when Working folders are created. Otherwise it uses the current time.
Locking
Exclusively Lock Folder During Edit Locks an asset when you open its Properties dialog box for editing. If not selected, the application does not lock assets when you open its Properties dialog box
Clear Manually Locked Folders After Edit

Unlocks a locked asset after you have edited its properties and clicked OK to create a new revision. If not selected, the application does not remove the locks.

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.

EOL

Automatic EOL conversion for check-out operations

Performs an automatic EOL conversion on check-out operations. If checked, also select the operating system on which you are working:

  • Windows (CR-LF)
  • Unix(LF)
  • Mac(R)

Files can be checked out in LF format on every platform, regardless of specific options.

The EOL Format property can be set in the StarTeam Cross-Platform Client in the Add/Check-in and File Properties dialog boxes.

The default for automatic EOL conversion for check-out operations is “checked” if the user does not have that option defined already.

The EOL Property values are:

Undefined

(null in the SDK).

Client Defined

Causes workstation default or per-checkout EOL conversion option to be used.

Fixed CR, Fixed LF, and Fixed CRLF

Causes this EOL format to be used always. The workstation/check-out conversion option is ignored.

Note: Once EOL Format is defined, Update Status works for all text files, regardless of what EOL format was used when they were checked-out. For compatibility with older Clients, if check-out "EOL conversion" is not requested, and EOL Format is Undefined, files are still checked out with the EOL convention with which they were added to the StarTeam Server.

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: ~~FolderPath~~:~~Name~~, the HTML representation will be the StarTeam path to the selected folder: SampleProject\ReadMe. This template is a super-set of that used by the Report feature of the client.

Another example about using project information: Server:~~Server~~|Project:~~Project~~|View:~~View~~|~~Path~~\~~Name~~

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.

Show Not-in-View Folders By Default Checks the Show Not-in-View Folders on the Folder Tree menu to set it to be on by default. (Changing this check box does not affect projects that are already open.)