Change Request Fields

This section lists all the change request fields in alphabetical order.

Note: Client-calculated fields cannot be used in custom email notifications or StarTeam Notification Agent . Reports can use any field name.
Addressed By

Values: list of users, <None>.

Internal Identifier: AddressedBy.

Indicates the user who resolved a change request (resolved statuses are Cannot Reproduce, As Designed, Fixed, Documented, and Is Duplicate).

Addressed In

Values: list of view labels, <None>.

Internal Identifier: AddressedIn.

Indicates the next build label created and applied to the view after the resolution to a change request occurs.

Addressed In View

Values: list of views, <None>.

Internal Identifier: AddressedInView

Indicates in what view the change request has been resolved. This is important for shared, and perhaps moved, change requests.

Attachment Count

Values: number.

Internal Identifier: AttachmentCount.

The number of files attached to an item.

Attachment IDs (Advanced)

Values: byte array. Displayed as a bracketed series of numbers in hex format. For example: [00 00 00 00 02 00 00 00] indicates two specific attachments.

Internal Identifier: AttachmentCount.

Cannot be used in queries. The ID numbers assigned to attachments. For example, the first attachment within a project is 00 00 00 00.

Attachment Names

Values: text containing a series of file names separated by spaces.

Internal Identifier: AttachmentNames.

The names of the files attached to an item.

Branch On Change (Advanced)

Values: No, Yes.

Internal Identifier: BranchOnChange.

Indicates whether the item will branch when it changes.

The value is No if the item's behavior is not set to Branch On Change. Reasons for this may be:
  • The item is in the root or a reference view and the Branch On Change feature is disabled.
  • The item is in a branching view but has already branched as a result of a change, which, in turn, results in the Branch On Change feature becoming disabled.
  • The item is in a branching view, but its behavior currently does not permit it to branch on change. This means that modifications are checked into the parent view.
Note: If the value is No, the value of the Branch State explains the No.
Branch State (Advanced)

Values: Branched, Not Branched, Root.

Internal Identifier: BranchState.

Indicates whether an item has branched in the child view, is still unbranched (and therefore is part of the parent view), or was created in the view in which it resides.

The values Branched and Not Branched apply to items in branching views. The value Root applies to items created in the view in which the item currently resides.

If the view is a reference view, it reflects the state of the item in the reference view’s parent.

Category

Values: text.

Internal Identifier: Category.

Text identifying the sub-component in which the defect occurs. It is usually used in combination with the Component field.

Closed On

Values: date/atime.

Internal Identifier: ClosedOn.

The date and time at which a change request was closed.

Comment

Values: text.

Internal Identifier: Comment.

The initial 2000 characters provided as the reason for changing an item's properties or contents are stored in the Short Comment field. The Comment field stores those 2000 characters and any additional text. Changing an item's properties causes the application to create a new revision.

Note: To include a Link comment, the Comment field is the value to use in an HTML report.
CommentID (Advanced)

Values: number.

Internal Identifier: CommentID.

The ID number assigned to the revision comment. Displays -1 if no revision comment was supplied.

Component

Values: text.

Internal Identifier: Component.

Text identifying the component in which the defect occurs. It is often used with the Category field to narrow that identification to a sub-component.

Configuration Time

Values: date/time.

Internal Identifier: ConfigurationTime.

Indicates the time to which an item is configured. If you configure an item to a specific time, this field contains that time. If you configure an item to a label or promotion state, this field shows either the time at which the label was created or the time at which the label associated with the promotion state was created.

CR Number

Values: number.

Internal Identifier: ChangeNumber.

The number assigned to a change request. For example, if the Object ID is 0, the change request number is 1.

Created By

Values: list of users, <None>.

Internal Identifier: CreatedUserID.

The name of the user who created the first revision in the view. This is either the user who added the item to the project, or the user who checked in the revision that branched.

Created Time

Values: date/time.

Internal Identifier: CreatedTime

The time at which the first revision in the view was created.

Deleted By

Values: list of users, <None>.

Internal Identifier: DeletedUserID.

The name of the user who deleted the item. Because deleted items do not appear in the list, this information is unavailable to users. Internal Use Only.

Deleted Time

Values: date/time.

Internal Identifier: DeletedTime.

The time at which an item was deleted. Because deleted items do not appear in the list, this information is unavailable to users. Internal Use Only.

Description

Values: text.

Internal Identifier: Description.

The description provided for an item at the time it was added to the view, including any later edits to it.

Dot Notation

Values: text.

Internal Identifier: DotNotation.

The branch revision number, for example, 1.2.1.0.

End Modified Time (Advanced)

Values: date/time.

Internal Identifier: EndModifiedTime.

The date and time at which a revision ceased to be the tip revision. Although this field can be displayed in the upper pane, its value is always blank. This is because, at any given configuration time, the item is still the tip revision.

Entered By

Values: list of users, <None>.

Internal Identifier: EnteredBy.

The name of the user who created this change request.

Entered On

Values: date/time.

Internal Identifier: EnteredOn.

The time at which this change request was created.

External Reference

Values: text

Internal Identifier: ExternalReference.

Text usually used to indicate a customer or other outside source who provided the data for this change request.

Fix

Values: text.

Internal Identifier: Fix.

The text in the Fix field.

Flag

Values: No, Yes.

Internal Identifier: Flag.

Marks or bookmarks files in the upper pane on your workstation. This is a client-calculated field.

Flag User List (Advanced)

Values: text displayed as a list of user names. For example: [Greg,Sam] indicates user names.

Internal Identifier: FlagUserList.

Can be used in queries. Identifies users who have set flags on a given item.

Folder

Values: text.

Internal Identifier: Folder.

The name of the folder that stores the item. This is a client-calculated field.

Folder Path

Values: text.

Internal Identifier: Folder Path (contains spaces).

The path to the folder. This is not the path to the working folder.

Item Deleted By

Values: list of users, None.

Internal Identifier: ItemDeletedUserID.

The name of the user who deleted this item. Because deleted items do not appear in the list, this information is unavailable to users. Internal Use Only.

Item Deleted Time

Values: date/time.

Internal Identifier: ItemDeltedTime.

The time at which the item was deleted. Because deleted items do not appear in the list, this information is unavailable to users. Internal Use Only.

Last Build Tested

Values: list of view labels, <None>.

Internal Identifier: LastBuildTested.

The build label selected by a user to represent the last build in which a change request was tested.

Locked By

Values: list of users, <None>.

Internal Identifier: ExclusiveLocker.

The name of the user who has exclusively locked a folder.

Modified By

Values: list of users, <None>.

Internal Identifier: ModifiedUserID.

The name of the user who last modified the item.

Modified Time

Values: date/time.

Internal Identifier: ModifiedTime.

The time at which an item was last modified. The item may have been checked in or had its properties changed. For folders, this has nothing to do with the working folder. Use Local Time Stamp for the time a working folder was last modified.

My Lock

Values: Exclusively Locked By Me, Non-exclusively Locked By Me, Not Locked By Me.

Internal Identifier: MyLock.

Indicates whether the current user has the item locked and, if so, whether that lock is exclusive or not. This is a client-calculated field.

New Revision Comment (Advanced)

Values: text.

Internal Identifier: NewRevisionComment.

Internal use only. The client uses this value during the item update process. The field always appears empty if added to the upper pane. This is a client-calculated field.

Non-Exclusive Lockers

Values: text.

Internal Identifier: NonExclusiveLockers.

The names of the users who have locked the folder non-exclusively.

Object ID

Values: number.

Internal Identifier: ID.

Each item is assigned an object ID when it is added to a view. For applicable items, when it is branched in a child view, it is assigned another object ID. The original ID belongs to the folder in the parent view.

Parent Branch Revision (Advanced)

Values: number.

Internal Identifier: ParentRevision.

The last digit in the branch revision number before an item branched. For example, if this number is 7, the branch revision was 1.7 at the time the item branched (becoming 1.7.1.0, as seen in the item’s history). This number is -1 if an item was not inherited from the parent view.

Parent ID (Advanced)

Values: number.

Internal Identifier: ParentID.

The object ID of an item in the parent view. The Parent ID is -1 if this view has no parent view.

Parent Revision (Advanced)

Values: number.

Internal Identifier: PathRevision.

The revision number at which an item branched. For example, if this number is 8, this item’s revision number in the parent view was 8 at the time the item branched. The history should show that revision 9 in the first revision in the current view. This number is 0 if this item was not inherited from the parent view.

Platform

Values: All, MacOS, Other, Unix, Windows 2000, Windows 95, Windows 98, Windows NT, Windows XP.

Internal Identifier: Platform

The value of the Platform field.

Priority

Values: No, Yes.

Internal Identifier: Priority.

The value of the Priority field. Many people use repository customization to extend this field to include other values because booleans in the application are treated as enumerated types. For example, No is 0 and Yes is 1. An administrator might change No to Not A Priority, Yes to Priority 1, and add Priority 2 through Priority 10.

Read Only (Advanced)

Values: No, Yes.

Internal Identifier: ReadOnly.

Indicates whether the item’s configuration is read-only (as in a rollback configuration of a view)/its behavior does not allow it to branch on modification. For folders, do not confuse a read-only configuration (an application issue) with a read-only folder (an operating system issue). A read-only folder cannot be edited and saved to disk. A folder whose configuration is read-only can be edited and saved to disk; it just cannot be checked in.

Read Status

Values: Read, Unread.

Internal Identifier: ReadStatus.

Indicates whether an item is considered read or not read. This is a client-calculated field.

Read Status User List

Values: text displayed as a list of user names. For example: [Greg,Sam] indicates user names.

Internal Identifier: ReadStatusUserList.

Can be used in queries. Identifies users for whom a given item’s status is Unread.

Resolved On

Values: date/time.

Internal Identifier: ResolvedOn.

The time at which a change request was resolved. The resolution can be: Cannot Reproduce, As Designed, Fixed, Documented, or Is Duplicate.

Responsibility

Values: list of users, <None>.

Internal Identifier: Responsibility.

The name of the user who is currently responsible for a change request.

Revision Flags (Advanced)

Values: 0.

Internal Identifier: RevisionFlags.

Internal use only.

Root Object ID (Advanced)

Values: number.

Internal Identifier: RootObjectID.

The object ID of the oldest ancestor of an item. For example, if an item was not inherited from a parent view, the root object ID is the same as its object ID. If it was inherited from a parent view, the root object ID is the Parent ID, or the item’s Parent ID.

Severity

Values: High, Low, Medium.

Internal Identifier: Severity.

The value of the Severity field.

Share State

Values: DerivedShare, Not Shared, Root Share.

Internal Identifier: ShareState

Indicates whether this item is shared. Not Shared means that the item is not shared. Root Share means that the item is shared and this item is the original (or root) reference. DerivedShare means that the item is shared, but this item is not the original (or root) reference.

Short Comment

Values: text.

Internal Identifier: ShortComment.

Stores the initial 2000 characters provided as the reason for changing an item’s properties or contents. Additional text is stored in the Comment field.

Status

Values: New, Open, In Progress, Deferred, Cannot Reproduce, As Designed, Fixed, Documented, Is Duplicate, Verified Deferred, Verified Cannot Reproduce, Verified As Designed, Verified Fixed, Verified Documented, Verified Is Duplicate, Closed Deferred, Closed Cannot Reproduce, Closed As Designed, Closed Fixed, Closed Documented, Closed Is Duplicate.

Internal Identifier: Status.

The value of the Status field.

Synopsis

Values: text.

Internal Identifier: Synopsis.

The value of the Synopsis field.

Test Command

Values: text.

Internal Identifier: TestCommand.

The text in the Test Command field.

Type

Values: Defect, Suggestion.

Internal Identifier: Type.

The value of the Type field.

Verified On

Values: date/time.

Internal Identifier: VerifiedOn.

The time at which a change request was verified. The resolution can be Verified Cannot Reproduce, Verified As Designed, Verified Fixed, Verified Documented, or Verified Is Duplicate.

Version (Advanced)

Values: number.

Internal Identifier: RevisionNumber.

The last number in the branch revision number. For example, if the branch revision number is 1.3.1.2, the version is 2.

View

Values: list of views, <None>.

Internal Identifier: ViewID.

The name of the view in which the item last branched. For example, if an item is inherited from a parent view but is branched in a child view, the value of this field in the child view changes from the name of the parent view to the name of the child view for the revision that branched and subsequent revisions in the child view.

Work Around

Values: text.

Internal Identifier: WorkAround.

The text in the Work Around field.