Pick Lists

The Administrator has the ability to customize and add pick lists used within the Organization. The majority of Contour's pick lists are defined and managed at this screen.

adminPickLists

Creating New Pick Lists

Pick lists may be created and associated with either existing fields or custom user fields. For example, if you create a new type of Item called User Requests, you may want to have a unique drop down list called "User Request Status" with different values from any other pick lists.

1.	Select the Administration perspective option located within Contour's header. If the option is unavailable then you do not have Administration rights.

2.	Select the Pick Lists option from the left side panel.

3.	Click on the Add Pick List button.

4.	Enter a name (for display) and description (for internal use).

5.	Save the new pick list.

6.	The Edit link within each row allows for editing of the name and description.

Deleting Pick Lists

Note: Once a pick list has been used (assigned) by an Item it may not be deleted as that Item (even when deleted) is archived and retained as part of the Project history. To remove the pick list from an Item please refer to Customizing Item Types.

Icon Key for Pick List Configuration

Pencil	Edit List Item
Flag	Mark Item as default
Arrow Up	Move up in list
Arrow Down	Move down in list
Red X	Delete
Plus Sign	Add New

Adding/Editing a Pick List Item

Pick lists are made up of one or more individual Items.

1.	To access a pick list's Items, click on the Config link within the row of the desired pick list.

2.	Select the row with the desired pick list Item and the button with the pencil icon or add a new Item by clicking the plus sign button.

•	Display - Name of the pick list Item visible by users.

•	Description - Used to describe the value internally to other admins.

•	Value - A secondary field that can be useful for reporting instead of working with the Display field's user friendly text.

•

Color - A color can be assigned to pick list items to differentiate an items status, priority, or any number of configurations. By default the Test Case Status field can be set to have a passing color of green, a failing status of red, and a blocked status of orange to quickly identify the state of a field in a list of items.

3.	Click on Save.

Configuring a Pick List

Each pick list's display order and default can be configured.

1.	Select the desired pick list Item's row.

2.	Using the buttons available at the top right of the list, move the selected Item up or down in the list.

3.	Set the default pick list Item by selecting the desired row and clicking on the button with the red flag icon.

Note: There can only be one default selection for each pick list.

pickListConfig

Deleting Pick List Items

Items within a pick list can be deleted however each removed Item must be reassigned to a different Item first.

1.	Select the desired pick list Item.

2.	Click on the button with the red X icon.

3.	Select a replacement pick list Item.

4.	Click on Delete.

Note: Each pick list must retain at least one value and that value cannot be deleted. If the pick list has not been used by an Item the whole pick list may be removed, but this would likely only happen during the initial setup of Contour.