Item Editors

This topic describes the StarTeam Web Client's default Item Editors.

Your StarTeam Web Client administrator can customize the layout, properties, and workflow of the Item Editors for your organization. Thus, the default Item Editors discussed here may vary significantly from your implementation of the StarTeam Web Client.

File Editor

The following details the tabs on the File Editor.

General tab

Property Description
Name Name of the file.
Description Description of the file.
Size Size of the tip revision of the file in bytes.
Executable Indicates whether the executable bit must be set for a UNIX file.
Last Modified By Name of the person who last modified the file.
Last Modified On Date and time the file was last checked in.
File Time Stamp Date and time the file was last modified.
Locked Exclusively By Name of the user who has exclusively locked the file.
Locked Non-Exclusively By Name of the user who has non-exclusively locked the file.

Archive tab

Property Description
Type Indicates whether a file is stored as a StarTeam (Native) file or as another type of file.
Format Vault storage format for the file. StarTeam 2006 and later versions use only Native-II storage.
Archive File Name Name of the Native-II Vault file that stores the tip revision. This name is the MD5 value of that file revision's content converted to a 32-digit hex string.
Compression

The file's level of compression.

Default

Compromise between maximum compression and maximum speed.

Maximize Compression

Densest possible compression of file revisions used to save space on the server.

Maximize Speed

Fastest possible compression of file revisions used to improve server performance.

None

No compression.

Custom

The Custom tab lists any custom property names and values.

Comment

Use the Comment field to provide additional information about the item.

Back to top

Change Request Editor

The following details the tabs on the Change Request Editor.

Synopsis

Property Description
Status Stage of the change request.
Priority Whether or not the change request is of high importance.
Type Kind of change request: a Defect or a Suggestion.
Severity Importance of the change request: Low, Medium, or High.
Platform Operating system platform to which the change request applies.
Last Build Tested Build in which the defect was discovered or last tested.
External Reference Customer or other outside source who provided the data for the change request.
Addressed In Build Build in which the fix first appears.
(Addressed in Build) By Name of the person who resolved the change request. This value is a read-only calculated value.
Component Module in which the defect occurs.
Category Sub-component in which the defect occurs.
Synopsis Brief description of the change request.
Responsibility Name of the person currently responsible for the change request.
(Responsibility) As of Date and time the person responsible for the change request was assigned that responsibility. This value is a read-only calculated value.
Entered By Name of the person who created the change request. This value is a read-only calculated value.
Entered On Date and time the change request was created. This value is a read-only calculated value.

Description

Property Description
Description and steps to reproduce Complete, detailed description of the change request.
Test command Command to use to test the solution for the change request.

This tab also contains a Browse button for locating the command to test.

Solution

Property Description
Workaround Alternate solution to the change request other than the fix.
Fix Solution that was applied to the change request.

Custom

The Custom tab lists any custom property names and values.

Attachments

Use the Attachments tab to manage files attached to an item in the following ways:

  • Click Add... to attach a local file to the item.
  • Select an attachment and click Remove to remove the attached file.
  • Select an attachment and click Save to save the attached file to your local or network drive.

Comment

Use the Comment field to provide additional information about the item.

Back to top

Requirement Editor

The following details the tabs on the Requirement Editor.

Requirement

Property Description
Name Requirement name.
Created By Name of the person who created the first revision of the requirement in the view. This value is a read-only calculated value.
Created On Date and time the first revision of the requirement was created. This value is a read-only calculated value.
Attachments Number of files attached to the requirement. This value is a read-only calculated value.
Modified By Name of the last person who modified the requirement. This value is a read-only calculated value.
Modified On Date and time the requirement was last modified. This value is a read-only calculated value.
Type Category of the requirement.
Owner Name of person ultimately responsible for the fulfillment of the requirement.
Priority The relative importance of the requirement can remain Unassigned (the default), or ranked as Essential, Useful, or Desirable.
Status Current stage of the requirement. This property indicates the progress from Submitted to Rejected or Complete.

Note: The status ReadyForCCP means the requirement is ready for review by the Change Control Board.

External Reference External source or reference for this requirement. This usually is the name of an external customer who asked for the requirement. If you are publishing requirements from CaliberRM to StarTeam, this property displays its identification for this requirement.
Description Provides a description of the requirement, usually revised over time to eliminate ambiguities.

Responsibility

To assign requirements to available resources, select one or more available users and click Add selected users to add them to the Responsible list. Click Remove selected users to remove selected users from the list.

Ambiguity Review

Property Description
Number of ambiguities found Number of ambiguities that reviewers have found in the initial description of the requirement.
Revised description Provides a new, revised description because of ambiguities found in the original description or because of other reasons.
Comments Provides information about the ambiguities in the original requirement and why the description has been revised.

Estimate

Property Description
Expected effort Expected case estimate of how long it will take to implement the requirement. If you are publishing requirements from CaliberRM to StarTeam, these text boxes are already filled with data based on a specific unit, such as hours or days. Otherwise, the units are arbitrary, but must be the same for the Low Effort and the High Effort text boxes, and must be used consistently for all requirements.
High effort Worst-case estimate of how long it will take to implement the requirement. If you are publishing requirements from CaliberRM to StarTeam, these text boxes are already filled with data based on a specific unit, such as hours or days. Otherwise, the units are arbitrary, but must be the same for the Low Effort and the Expected Effort text boxes, and must be used consistently for all requirements.
Low effort Best case estimate of how long it will take to implement the requirement. If you are importing requirements from CaliberRM, these text boxes are already filled with data based on a specific unit, such as hours or days. Otherwise, the units are arbitrary, but must be the same for the Expected Effort and the High Effort text boxes, and must be used consistently for all requirements.
Notes Field used to provide additional information about the estimated effort to implement the requirement.

Custom

The Custom tab lists any custom property names and values.

Attachments

Use the Attachments tab to manage files attached to an item in the following ways:

  • Click Add... to attach a local file to the item.
  • Select an attachment and click Remove to remove the attached file.
  • Select an attachment and click Save to save the attached file to your local or network drive.

Comment

Use the Comment field to provide additional information about the item.

Back to top

Task Editor

The following details the tabs on the Task Editor.

Task

Property

Description

Name

Task name.

Responsibility

Name of the person responsible for the completion of this task or subtask. Other people can be assigned as additional resources.

Milestone

Indicates whether the task must be treated as a milestone.

Status

The stages of the task are as follows:

Pending

Waiting for completion of a predecessor task.

Ready To Start

Work can be started on the task.

In Progress

Work has been entered for the task.

Finished

Work is finished on the task.

Closed

Task is completed and closed.

Hold

Work is temporarily stopped on the task, usually to wait for completion of another task.

Priority

Importance of the task. The default is Medium. These priorities are identical to those in MS Project. Do Not Level is a Microsoft Project-specific term you should ignore.

Duration

Number of hours expected for completion of the task.

Percent complete

Percentage of work that has been completed on the task.

Needs attention

Notifies team leaders or task reviewers that this task requires attention. Type the information about why this task needs attention in the text box below the Needs Attention check box.

Resources

To assign tasks to available resources, select one or more available users and click Add selected users to add them to the Task resource assignments list. Click Remove selected users to remove selected users from the list.

Time

The Time tab automatically tracks the variance between the estimated and actual start date, finish date, and duration of a task.

Property Description
Plan Start Estimated start date for the task. The default value is the current date.
Plan Finish Estimated finish date for the task. The default value is the current date.
Plan Work Number of hours estimated to complete the task.
Actual Start Actual start date calculated from work records.
Actual Finish Actual finish date when the task status changes to Finished.
Actual Work Actual number of hours taken to complete the task, calculated from work records.
Variance Start Variance in days between the expected start date and the actual start date. This value is a read-only calculated value.
Variance Finish Variance in days between the expected finish date and the actual finish date. This value is a read-only calculated value.
Variance Work Variance in number of hours between estimated and actual duration. This value is a read-only calculated value.

Work

Property Description
User Name Name of the person who performed the work for this work-record entry. The default value is the current user.
Date Date work was done for this work record. The default value is the current date.
Work Number of hours worked for this work-record entry.
Remaining Work Remaining number of hours to complete the task.
Comments Field used to provide additional information about what work was done for this work record.

Notes

Use the Notes field to provide additional information about the task.

Custom

The Custom tab lists any custom property names and values.

Attachments

Use the Attachments tab to manage files attached to an item in the following ways:

  • Click Add... to attach a local file to the item.
  • Select an attachment and click Remove to remove the attached file.
  • Select an attachment and click Save to save the attached file to your local or network drive.

Comment

Use the Comment field to provide additional information about the item.

Back to top

Topic Editor

The following details the tabs on the Topic Editor.

Topic

Property Description
Title Topic title.
Created By Name of person who created the topic. This value is a read-only calculated value.
Created On Date and time the topic was created. This value is a read-only calculated value.
Attachments Number of attachments to the topic. This value is a read-only calculated value.
Modified By Name of the last person who modified the topic. This value is a read-only calculated value.
Modified On Date and time the topic was last modified. This value is a read-only calculated value.
Content Text contents of the topic.

Options

To designate the recipients of the topic or response, select one or more available users and click Add selected users to add them to the Recipients list. Click Remove selected users to remove selected users from the Recipients list.

Property Description
Recipients

Intended recipients of the topic or response.

Note: You cannot delete yourself as a recipient unless you delete all the recipients. When recipients are identified, StarTeam does not allow you to remove yourself from the notification list.

Priority Topic importance: Low, Normal, or High.
Status Topic state: Active or Inactive.

Custom

The Custom tab lists any custom property names and values.

Attachments

Use the Attachments tab to manage files attached to an item in the following ways:

  • Click Add... to attach a local file to the item.
  • Select an attachment and click Remove to remove the attached file.
  • Select an attachment and click Save to save the attached file to your local or network drive.

Comment

Use the Comment field to provide additional information about the item.

Back to top