Item Tracking Fields

Vault Professional is installed with default values for certain drop down lists that appear in the Add and Modify Work Item pages and Query Items pages. Those fields are:

  1. Type

  2. Status

  3. Priority

  4. Platform

The available values for these fields can be added, modified or deleted. (If the value is used in other parts of the system or is used as a default value, then the value can be modified but not deleted).

There are also two custom field labels that can be configured from this page.

Database Fields

Every project that is created will use the database field values configured here for Type, Status, Priority, and Platform.

Adding a Value

To add a new database field value, enter the new value in the text box located at the top of the associated database field table then click Add. The new value will appear in the associated table.

Modifying a Value

To modify a database field value, click the Modify icon associated with the value you wish to modify. A text field, an update link and a cancel link will be displayed in the table row for that value. Make the change then click the Update link.

Deleting a Value

To delete a database field value, click the Delete icon associated with the value you wish to delete. You will be asked to confirm the deletion.

Default Values

The following table contains the default values of the database fields. The highlighted values are used by the system and can be modified but not deleted.

Field

Description

Default Values

Type

An item sub-category that helps define an item

Bug, Feature, Task, Discussion  

Status

A value that describes the status or state of an item

Unconfirmed, Open, Completed, Verified, Invalid, Disregard, Duplicate

Priority

A value that represents the importance of an item

Unknown, Low, Medium, High, Urgent

Platform

The operating system that the issue pertains to

Unknown, Windows, Unix, Mac

Status field definitions include a "Status Type" setting. This allows you to label statuses Open, Pending and Closed. This is especially helpful when viewing search results, bug-in-progress lists, etc. For example, you can define many variations of "open issue" status (Researching, In Progress, etc.) and still have them all show up in "Open" or "My Open" searches.

Usage Examples for Status Types

The default values for VaultPro work item Status can all be renamed, but two of them have special meaning in VaultPro: Completed and Verified.

Open

All items begin in the "open" state. This status is hardwired into a built in query like "My Open". If it's renamed, clicking on "My Open" will show bugs that have the renamed status, but they will still be your open bugs.

Unconfirmed

A (potential) bug has been reported and logged in Vault Pro. After investigating the bug, the developer is unable to reproduce it. The developer changes the status to unconfirmed and changes the assignee to a tester. The tester will spend more time trying to reproduce and isolate the bug. If it's successfully reproduced, the bug goes back to open (with comments detailing the steps necessary to make it happen). If it can't be reproduced, it will be marked invalid.

Invalid

A bug that has been logged, but can't be reproduced. Either a customer report was wrong, an internal tester was wrong, or the bug has become invalid over time as the project matures (e.g. the bug has been sitting "open" for so long that the feature with the bug has been removed or substantially modified).

Duplicate

The work item is the same as another item is already logged in work item tracking.

Disregard

This can be used for a bug that was logged as a test, or It can also be used as a flag for items that can be deleted for some reason.

Completed

A developer has checked changes into the tree that are meant to address the work item. The work item now goes to a tester or Resolver who does some regression testing and either marks the bug "verified" or resets it to "open" with comments on what failed and it returns to the developer. This one is also hardwired to "My Open", but the "Completed" tab of it.

Verified

Items that have passed through testing, and the tester or Resolver is confident that the item has been addressed and nothing else has been broken in the process. Work is completed on this item.

Custom Fields

The Custom Fields section allows you to name extra fields that can be displayed on the Add and Modify Item forms and Query forms.

Click the icon next to a custom field's definition to edit that field.

Enter the custom field label in the textbox. If you want the custom field displayed on the External Add page, check the checkbox in the Show for External Add column. If you want this field to be a required for the external page check the checkbox in the Required for External column. Click Update to make the changes. Click Cancel to cancel the modification.