Configuring Field Mappings

The Step 2: Map PPM—QC/ALM Fields tab page of the Configure QC/ALM Integration for Request Type section displays a drop-down list of the unmapped QC/ALM Entity Fields, a drop-down list of the unmapped PPM Request Fields, and the Current Field Mappings table. Following is an example of an integration that has some field mappings configured.

In the Current Field Mappings table:

Field Description
QC/ALM Field

Displays ALM field names, followed by their DB field names (the names of the columns in the database) in parentheses.

PPM Field Displays the PPM request field names that are mapped to (that is, associated with) the ALM fields, followed by their tokens in parentheses.
Control

Specifies which field in the mapped field pair controls the other, or that a change to either field updates the other.

It can have one of the following values for any pair of mapped fields (row):

  • QC/ALM. The ALM entity field controls the mapped PPM request field. When the ALM entity is created or modified in any way, then the integration updates all the mapped PPM request fields that are controlled by ALM.

    When ALM controls a mapped pair and the value in the PPM field is changed, the value in the associated ALM field is not affected.

    When the integration creates an ALM entity, the PPM request fields have no effect on the fields controlled by ALM.

  • PPM. The PPM request field controls the mapped ALM entity field. When the PPM request is created or modified in any way, then the integration updates all the mapped ALM entity fields that are controlled by PPM.

    When PPM controls a mapped pair and the value in the ALM field is changed, the value in the associated PPM field is not affected.

    When the integration creates a PPM request, the ALM entity fields have no effect on the fields controlled by PPM.

  • Bidirectional. In effect, both the PPM fields and their mapped ALM fields operate as if they are in control—when either the integrated PPM request or ALM entity is created or modified, the integration updates all the associated fields in the ALM entity or PPM request respectively, as specified by the mappings.

Creating a New Field Mapping:

  1. From the QC/ALM Entity Fields drop-down list, select the ALM entity field that you want to map to a PPM request field.

    Each ALM entity field that you must map to a PPM request field is indicated by an asterisk (*) to the beginning of the field name in the QC/ALM Entity Fields list.

  2. From the PPM Request Fields drop-down list, select the PPM request field that you want to map to the ALM entity field you selected.

  3. Click Map Fields.

    The field pair is added to the Current Field Mappings table.

  4. Repeat this procedure for all the ALM entity fields that must be mapped and for other pairs of fields you want to map.

Modifying a Field Mapping:

  • If you want to change which field, if any, controls a current field mapping (row), change the value in the Control column for that field mapping.

  • If you want to remove a pair of fields from the mapping, click the Delete icon () in the right end of the row for the field pair you want to delete.

  • If both fields in the mapping are lists of values and you want to map the values, see Configuring Value Mappings.

Configuring Value Mappings

When both fields in a field mapping are lists of values, the Map Values button appears to the right of the row in the Current Field Mappings table. In this case, to map the values of one field to the values of the other field:

  1. Click OK.