Open topic with navigation

Configuring item mapping rules

You can configure item mapping rules to specify how field values are copied into items created from other items, such as issues created from test runs, and how items are linked. These rules allow you to copy additional information between items and offer more flexibility when copying values from custom fields. For example, you can map a custom test run pop-up menu field to any issue field without creating a custom issue pop-up menu.

Keep the following in mind:

• You can map item fields of the same type. For example, you can map test run text fields to issue text fields. You can also map pop-up menu, integer, and date/time fields to text fields. If a text field's limit is exceeded, the data is truncated to the field limit. To map two pop-up menu fields, the fields must use the same value list.
• You can map multiple fields to one field in new items. For example, you can map the test run Summary and Steps fields to the issue Description field to include the information from both test run fields in the issue Description.
• You can select Folders as the field to copy to a new item. Folders can only be mapped to text fields. If the Folders field is mapped to a single-line text field, a list of folder names is copied to the new item. If the Folders field is mapped to a multi-line text field, a list of folder paths is copied to the new item.
• You can map decimal fields to integer fields. When an item is created from another item and the Add dialog box opens, the decimal value copied into the integer field must be changed before the new item can be added. When an item is generated from an item and automatically added to the project, the decimal value copied to the integer field is accepted. If the generated item is edited, users are notified that the decimal value is invalid and must be changed before the changes can be saved.
• You can map calculated custom fields as the source field to copy to new items, but these fields cannot be selected as the field to be populated.

1. Choose Tools > Administration > Item Mapping Rules.

The Configure Item Mapping Rules dialog box opens.

2. Select a rule Type.

3. Click Add to create a new rule. See Adding item mapping rules.

4. Select a rule in the Custom Mappings list to modify it. See Editing item mapping rules.

5. Select a rule and click Top, Move Up, Move Down, or Bottom to organize the field order.

If multiple fields are mapped to the same field in a new item, the values are added in the order they appear in the Custom Mappings list.

6. Click Restore Default Values to restore the default mapping rules. See Default item mapping rules.

7. Select a rule and click Delete to delete it.

8. Click Export to export the item mapping rules. See Exporting item mapping rules.

9. Click Import to import the item mapping rules. See Importing item mapping rules.

10. Click OK to save the changes.

See also