IssueNet Online Help System

www.elsitech.com

Item Lists

Modified: 2009/03/25 13:38 by Jeff Bishop - Categorized as: Architect
Edit

1 What are Item Lists?



An item list is a collection of values that can be assigned to a property. There are three types of item lists:
  • Parameter lists
  • Query Item lists
  • Plugin item lists

Edit

2 ParamLists

Selecting ParamLists in the Data Source Explorer displays current parameter lists. The administrator can add, remove or edit the values contained in the list. When editing or creating Parameters, an optional weight value can be added, which provides the ability to produce metric reports based on the weight values associate with items such as issues and tasks. The Sort Order can be tailored so that the display order of Parameters in the drop-down menus is controlled by the IssueNet Administrator.

Edit

2.1 Creating and Editing Paramlists

The values contained in Parameter lists can be added, removed and edited. Parameter Lists are accessed from the Data Source Explorer and selecting Item Lists followed by ParamLists.

To add a parameter
  1. In the Data Source Explorer, expand Item lists and ParamLists
  2. Double-click on the Object you wish to add a parameter (e.g. IssuePriority)
  3. Click the Add button
  4. Enter a Name for the Parameter
  5. (Optional) Enter a Weight for the Parameter
  6. (Optional) Enter a value for the Sort Order
  7. (Optional) Enter a Description for the Parameter
  8. Click OK to dismiss the Parameter dialog
  9. Click the Save button

To edit an existing Parameter
  1. In the Data Source Explorer, expand Item lists and ParamLists
  2. Double-click on the Object you wish to edit (e.g. IssuePriority)
  3. Select the Parameter and click the Edit button
  4. Make changes as need and click OK to dismiss the Parameter dialog
  5. Click the Update button

To remove an existing Parameter

  1. In the Data Source Explorer, expand Item lists and ParamLists
  2. Double-click on the list from which you wish to remove a Parameter
  3. Select the Parameter and click the Remove button
  4. Click the Save button

Edit

3 Plugin Item Lists

A plugin item list is an item list that is populated by a service implemented in a plugin. The plug-in implements a class that supports the IFillItemList interface, the service is called when IssueNet needs to fill a plugin item object with values.

An example is the ProjectResource item list which is used by the Task.Resource property. It populates the list of available resources based on the session variable $(Project) and loads only the resources that are linked to the project specified by the $(Project) variable.

Edit

4 Query Item Lists

A Query Item List allows you to create an item list that is loaded with a list of objects based on the results of a query. Because its contents are based on a query, query items lists are useful for defining dynamic lists that change as users add, remove and modify items in the database. Once you have created a query item list you can associate it with any ObjectID property of a class.

For example, if you added a property to the Task class named “Verified By” and wanted that list populated only by resources with the role “Test Engineer”, you would create a query that returned resources with the role “Test Engineer” and use it to create a query item list. Once you have the query item list, you associate it with the class property you want to use the new list – in this case the Task property “Verified by".