Open topic with navigation

Adding item mapping rules

You can add item mapping rules to copy information to an item created from another item. See Configuring item mapping rules.

1. Choose Tools > Administration > Item Mapping Rules.

The Configure Item Mapping Rules dialog box opens.

2. Select a rule Type. The available options depend on the selected type.

3. Click Add.

A new row is added to the Custom Mappings list.

• Select a field to copy from the Copy Field list. The field value in the source item is copied to the field it is mapped to in the new item.

• Select a field to map the source field to from the to Field list. This field in the new item is populated with the value from the source item field.
• Optionally enter text or field codes in the Prepend Text and Append Text fields. You can only prepend and append text to values that are mapped to text fields. Click the Insert Field Code button to select from a list of available field codes.

4. Select Copy all issue reported by description fields to requirement description to copy information from the issue Detail: Found by mini tab to the requirement Description. This option is only available for Create Requirement from Issue rules.

If you map an issue reported by field with multiple records, only fields from the first record will be used if this option is not selected.

5. Select Copy test run problems statements to issue description to copy information from the test run Steps tab to the issue Description. This option is only available for Create Issue from Test Run rules.

6. Select a Link definition to use when a new item is created from an existing item. The list includes all link definitions that allow linking of the two item types.

Select Prompt user before adding link to prompt users to create a link when creating new items from existing items. If this option is not selected, the link is automatically created. The selected link definition is always used. See Working with Related Items.

7. Select Add the new item to the same folders option to add new items to the same folders as the source items.

When the new item is created, users can open the folder or remove the item from the folder on the Folders tab.

8. Click OK to save the changes.