Overview

Tracker allows you to define the option menu items of any Pulldown or Release Number field. Option menu items can be added, edited and marked obsolete or deleted at any time.

Option Menu Item List

Each Pulldown or Release Number type field has an option menu item list. To get to this list:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the field for which you want to see the Item List

By default, the Option Menu Item list shows the option menu items currently available in the pulldown. The items are sorted by the value of the order property. By default, if there are more than 50 option menu items for a pulldown field, the item list will be broken up into pages. Click on the page pulldown to select a page or click on the Previous or Next arrows to move to another page. You can change how many items are displayed per page via the Maximum Menu Items option in the General Preferences section.

The top right of the page shows a total number of option menu items configured for the field. This count only includes the items currently being displayed on the list. For example, when you first browse to the Item List, the count will include all non-obsolete items. If you search for a list of items, the count will reflect the number of items which matched the search criteria.

For RelNum (Release Number) fields, the pulldown RelNumType will be displayed at the top with four choices "<RelNum Field Name>", "<RelNum Field Name> - B" "<RelNum Field Name> - C" and "<RelNum Field Name> - D". Each of these represents one of the 4 digits in the Release Number field. To see the option menu items for a particular digit, choose that digit. The page will be refreshed to show the items for that digit.

For each option menu item the following properties are displayed:

• Menu Item Name
  The label of the option menu item

• Order
  The order of the option menu item with respect to other items

• Add Default
  A value of "Yes" in this column indicates that the item is the default option menu item for the pulldown field

• Public
  A value of "Yes" indicates the option menu item is available on external pages such as the Submit Page and Knowledge Base

• Obsolete
  A value of "Yes" indicates that the option menu item has been marked as obsolete so it will not be available as a selection on various Tracker pages

Printing the Item List

The items displayed on the Item List can be printed using the Print link in the upper right corner of the Item List pages. Only the items currently displayed on the list will be printed (e.g. if you have run a search for a particular set of items, only those items will be printed as opposed to the full set of items).

Exporting the Item List

The items displayed on the Item List can be exported to *.csv format (comma separated values) using the Export link in the upper right corner of the Item List pages. You can then open this file in another tool such as Microsoft Excel or Crystal Reports. Only the items currently displayed on the list will be exported (e.g. if you have run a search for a particular set of items, only those items will be exported as opposed to the full set of items).

Importing Option Menu Items

Option menu items can be imported into a pulldown field unless it is configured as a user pulldown. Details for importing option menu items can be found in the Importing Pulldown Items into Tracker section.

Delete Obsolete

All obsolete option menu items in a pulldown field can be deleted via the Delete Obsolete link. This operation is not available for Release Number fields. Obsolete items can only be deleted if they are not referenced in any records or saved queries (including query criteria for ad-hoc queries). This operation will permanently delete these items and they cannot be restored later.

To delete obsolete menu items:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the field that contains the obsolete items you wish to delete
5. Click on the Delete Obsolete link in the upper right of the Item List page
6. A confirmation page will be displayed to note how many obsolete items will be deleted. Click on the OK to continue. Doing so will permanently delete the obsolete items and they cannot be restored later.
7. Click OK after the operation has been completed

If there are obsolete items that cannot be deleted because they are referenced in records and/or saved queries when trying to use the Delete Obsolete operation, a message will be displayed to mention that none of the obsolete items can be deleted.

To remove references to an option menu item from records:

1. Login to the workgroup
2. Enable the Include Obsolete Items option in the Preferences section so that obsolete items will be available for selection on the Query Page
3. Run a query with a single form selected to return all records that contain the obsolete option menu item(s) you wish to delete
4. Click on the Edit Records link to choose a replacement value in the records for the item(s) you wish to delete. Please review the information about the Editing or Deleting a Set of Query Results section for details about using this operation. It is critical that you review that section because the Edit Records operation cannot be undone except by restoring to a backup copy of your database.
5. Click on the Query icon
6. If desired, disable the Include Obsolete Items option in the Preferences section

To remove references to an option menu item from saved queries, refer to the Edit a Saved Query section to remove the obsolete item(s) from report criteria.

To remove references to an option menu item from ad-hoc query criteria, click on the Query icon, click on the Clear button, then click on the Run Query button.

Item Search

A search function is available to help you quickly locate an option menu item or set of items that match certain criteria.

To search for an option menu item or set of items:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the pulldown field in which you want to search
5. Type in any desired criteria into the Search... box
6. If you wish to filter the search results to include or exclude public and/or obsolete items, click on the icon to show the multiple selection boxes for Public and Obsolete.

   In the Public field, selecting "<None>" will include public and non-public items in the search results (this is the default selection). Selecting "Yes" indicates the search results should be filtered to show only public items, selecting "No" will filter the search results to exclude public items.

   In the Obsolete field, selecting "<None>" will include obsolete and non-obsolete items in the search results. Selecting "Yes" indicates that the search results should be filtered to show only obsolete items, selecting "No" will filter the search results to exclude obsolete items.

   To make multiple selections in the list boxes, hold down the Ctrl button on your keyboard as you click on the items you wish to select.

7. Click on the Search icon to return the results that match the selected criteria

Click on the Remove icon to remove the search criteria and reset to the defaults (no key word(s) or phrase in Search... box, "<None>" selected for Public, "No" selected for Obsolete).

It is often a good idea to create a backup of your database before making major changes such as modifying your pulldown menus as some modifications are irreversible other than by restoring a backup copy of your database.

The Items button for the Assigned To field will display the User Accounts section. Items listed in the Assigned To field are the users listed in the User Accounts section. For a user to be available in the Assigned To field on the Add Page, the user must be a member of a user group with the privilege "Can Be Assignee For Add". For a user to be available in the Assigned To field on the Edit Page, the user must be a member of a user group with the privilege "Can Be Assignee For Edit".

The Items button for the Reported By field will display the User Accounts section. Items listed in the Reported By field are the users listed in the User Accounts section.

The Items button for the Status field will display the Global States List. Items listed in the Status field are the states created in the Global States List.

If you anticipate having a large number of option menu items in a pulldown, it is recommended that you choose "Search Pulldown" as the Display Style for the field. This style allows users to type in key words to find any option menu items that match the criteria. When there is a large number of option menu items in the field and the display style is something other than "Search Pulldown", all of the option menu items are displayed in the field, which can impact performance as the browser loads all of the available option menu items. With the "Search Pulldown" style selected, only the items that match a search are loaded, minimizing the time needed for the browser to render the field.

To add option menu items to a pulldown use the following steps. To add option menu items to a pulldown configured as a user pulldown, review the User Pulldown section.

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the pulldown field or release number field you wish to modify
5. You will be presented with a page listing all of the current items. To add a value, click on the Add Item button. If you clicked on the Items button for a release number (RelNum) type field, the items for the first digit will be displayed. To select another digit, make a selection in the RelNum Type pulldown at the top.

   When adding an item you can specify:

   • Name for the menu item in the Item Label field
   • Relative order in which the item should appear in the Order field (all entries with the same relative order are listed alphabetically)
   • Which option menu items in the parent field will be associated with this value can be selected in the Related to Parent Pulldown Items field. This field will only be displayed if the pulldown field to which this option menu item belongs has a "Parent Pulldown" defined in the Fields section.
   • Whether the value should be displayed if the field appears on the Submit Page and the Knowledge Base Search Page. Checking the box marked Value is Public indicates the choice should appear on the Submit Page and Knowledge Base pages.

The figure below displays the attributes that can configured when an option menu item is added. The field Related to Parent Pulldown Items will only appear if the pulldown field is configured as a dependent pulldown.

To edit an option menu item:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the pulldown or release number field you wish to modify
5. You will be presented with a page listing all of the current items. If you clicked on the Items button for a release number (RelNum) type field, the items for the first digit will be displayed. To select another digit, make a selection in the RelNum Type pulldown at the top. Locate row for the option menu item you wish to modify, then click on the Edit button.

   If you change the Item Label field for an option menu item, any records with this value selected will display the updated Item Label.

   Changing the order field will change the order of the option menu item relative to other option menu items for this field.

   Checking the box for the Value is Public option will enable an option menu item to be displayed on the Submit Page and the Knowledge Base Search Page. Unchecking the option prevents the option menu item from being displayed on those pages. This option cannot be unchecked for the option menu item set as the default value for the pulldown.

   Checking the box for the option Value is Obsolete allows you to mark an option menu item so that it is no longer a valid value (e.g. the "obsolete" option menu item won't be available for selection on the Add, Edit, Task, and Submit pages or when using the Edit Results operation) while still allowing existing records to have the option menu item selected. For more information about marking records obsolete, review the Maintaining Option Menu Items section.

6. Click OK to save the changes

To delete an option menu item:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the pulldown or release number field you wish to modify
5. You will be presented with a page listing all of the current items. If you clicked on the Items button for a release number (RelNum) type field, the items for the first digit will be displayed. To select another digit, make a selection in the RelNum Type pulldown at the top. Locate row for the option menu item you wish to modify, then click on the Delete button. If any records contain the option menu item you are deleting, you will be prompted to make a selection from one of the following choices:
   • Choose a Replacement
     You can choose another option menu item configured for the pulldown field to replace the option menu item you are deleting in any records that contain it
   • Mark Obsolete
     Selecting this option allows any records that contain the option menu item you are deleting to continue to have this value. New records cannot have this option menu item selected, nor can this option menu item be selected for records that don't already have it while editing or performing the Task operation on records. If the pulldown field is part of a dependency with another pulldown, any dependencies for the option menu item you are deleting will be removed.

   If any saved queries contain the obsolete value, you will be prompted to select a replacement from the list of option menu items configured for the pulldown field.

6. Click OK to complete the operation

To restore a option menu item that was previously deleted or marked obsolete:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the pulldown or release number field you wish to modify
5. You will be presented with a page listing all of the current items. If you clicked on the Items button for a release number (RelNum) type field, the items for the first digit will be displayed. To select another digit, make a selection in the RelNum Type pulldown at the top. Click on the Add Item button
6. Enter the "Item Label" for the value you wish to restore and click on the OK button
7. You will be prompted that the item you are attempting to add was previously deleted or marked obsolete. Click on the Restore Item button. If the item was previously marked as obsolete, the "Value is Obsolete" property will be unchecked for the item. Any records that had the obsolete item selected will remain unchanged.

Configuring Items for User Pulldowns

The items in user pulldowns are members of the user group configured in the "User Group" option of the field's properties. TBD is also included as an option menu item and is set as the default value. Another user can be selected as the default value, if desired.

To add a user to be displayed as an option in a user pulldown, you must add the user to the appropriate user group.

To edit a user displayed as an option in a user pulldown:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the user pulldown field you wish to modify
5. Click on the Edit button to the left of the user (item) you wish to modify

   User Group indicates which user group is associated with this user pulldown. This can be changed in the field's properties.

   The Item Label is the user's name as it is configured in the User Accounts section. It can only be modified by editing the user's profile information.

   Changing the Order field will change the order of the option menu item relative to other option menu items configured.

   Checking the box for the Value is Public option will enable an option menu item to be displayed on the Submit Page and the Knowledge Base Search Page. Unchecking the option prevents the option menu item from being displayed on those pages.

   A "No" value in the Value is Obsolete option indicates that the user is a member of the user group associated with this field. A "Yes" value indicates the user is no longer a member of the user group. An obsolete user is no longer a valid value for the field (e.g. the "obsolete" user won't be available for selection on the Add, Edit, Task, and Submit pages or when using the Edit Results operation). However, existing records can have the obsolete user selected. For more information about obsolete items (users), review the Maintaining Option Menu Items section.

6. Click OK to save the changes

To remove a user so that it is not displayed as an option in a user pulldown, you must remove the user from the appropriate user group. This will mark the user as obsolete. Existing records that have this user selected for the pulldown will remain unchanged, but this user will no longer be available for selection in any other records.

To delete a user so that it is no longer listed in the Items list for the field:

1. Remove the user from the appropriate user group in the User Accounts section. This step will mark the user as obsolete. Existing records that have this user selected for the pulldown will remain unchanged, but this user will no longer be available for selection in any other records.
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the user pulldown field that contains the user you wish to delete from the pulldown
5. Click on the icon in the Search bar to show the multiple selection box for Obsolete. Click on "Yes". If desired, enter a key word(d) into the Search... box to narrow down the search results, then click on the Search icon to return the results that match the selected criteria.
6. Click on the Delete button to the left of the user you wish to delete. Click OK to confirm.
7. If the user is selected for the pulldown in any existing records, you will be prompted to select a replacement for the user. If you do not wish to replace the user in the existing records, select the option Mark Obsolete instead.

Selecting the Default Value for a Field

You can set which value is used as the default when a new record is added or when a field is initialized during the Task operation. You cannot delete a value if it is currently the default value. You must first set another value as the default, and then delete the value. Only non-obsolete items can be selected as the default value.

To change which option menu item is set as the default:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Fields link
4. Click on the Items button to the left of the pulldown or release number field you wish to modify
5. You will be presented with a page listing all of the current items. If you clicked on the Items button for a release number (RelNum) type field, the items for the first digit will be displayed. To select another digit, make a selection in the RelNum Type pulldown at the top. Locate row for the option menu item you wish to set as the default value, then click on the Set Default button

Item Dependencies and Default items

If a pulldown field is configured to be either the child pulldown or the parent pulldown in a Dependent Pulldowns Relationship, the Item Dependencies and Default Items buttons will be displayed above the option menu item list as shown in the figure below.

In the Item Dependencies page for a pulldown menu, you can map parent pulldown option menu items to each option menu item in the child pulldown and vice versa. Instructions on mapping pulldown option menu items can be found in the Dependent Pulldowns Help section.

In the Default Items page, you can select which option menu item in the child pulldown should appear as the default value for each possible option menu item in the parent pulldown. Instructions for selecting defaults for dependencies can be found in the Dependent Pulldowns Help section.

Maintaining Option Menu Items

When Option Menu Items become inactive, you need to decide how to reflect this in Tracker. To deactivate an option menu item, you can either mark it as obsolete or delete it.

Obsolete Option Menu Items
Marking an option menu item as obsolete allows records in Tracker to contain the obsolete value. This is useful in cases where you want to be able to perform searches in the Query or Metrics sections which include any obsolete option menu items as part of the search criteria or results. A preference is available to allow obsolete option menu items to be used on the Query Page. This preference can be set by default when new users are added to the workgroup in the User Preferences section or can be set by each individual user using the Preferences link available on the Home Page.

Items in User Pulldowns are marked obsolete when:

• a user is removed from the user group configured for the field
• the user group configured for the field is changed in the Fields section
• a user pulldown is set as a task field and the properties are configured such that a user that is not a member of the user group associated with the user pulldown is set as the value of the pulldown.

When an option menu item is marked obsolete, it cannot be selected when new records are added via the Add or Submit pages or using the Submit via Email feature. The obsolete option menu item will not be displayed as an option on the Edit or Edit Records pages or during the Task operation unless a record already has the obsolete item selected. If the original record contains an obsolete item when using the Add Similar operation to add a record, the newly added record will have the obsolete item replaced with the default value for the pulldown. If the original record contains an obsolete item when using the Cloning operation to copy a record, the clone record will also contain the obsolete item.

If the pulldown field is part of a dependency with another pulldown, when an option menu item is marked as obsolete, any dependencies involving the obsolete item will be removed. For example, let's say that Component is a parent to Sub-Component. The Component field has an option menu item called "Printer", which is related to the option menu items "Paper Tray" and "Ink" in the Sub-Component field. If the option menu item "Printer" is marked obsolete, the items "Paper Tray" and "Ink" will no longer be associated with "Printer".

When an option menu item is marked obsolete, it will still be displayed as part of Knowledge Base articles. Whether the obsolete item is available when the pulldown field is available as a filter on the Search Page depends on what is set for the "Include Obsolete Items" option in the Search Filters properties page.

All obsolete option menu items can be deleted from a pulldown using the Delete Obsolete operation available on the Option Menu Item List page for each pulldown field.

Deleted Option Menu Items
Deleting an option menu item will remove all references to the item: the deleted item will no longer be displayed on the Add, Edit, Task, View, Query, Home, Metrics pages. If there are any existing records that have the item selected, you will have the option to select a replacement for the item being deleted.

If the pulldown field is part of a dependency with another pulldown, when an option menu item is deleted, any dependencies involving the obsolete item will be removed. For example, let's say that Component is a parent to Sub-Component. The Component field has an option menu item called "Printer", which is related to the option menu items "Paper Tray" and "Ink" in the Sub-Component field. If the option menu item "Printer" is deleted, the items "Paper Tray" and "Ink" will no longer be associated with "Printer".

Deleted items can be restored using the steps in the Restore steps above.