Configure field mappings

This topic provides details on how to configure field mappings for PPM and QC/ALM integration.

Map PPM--QC/ALM Fields UI elements

The Step 2: Map PPM—QC/ALM Fields tab of the Configure QC/ALM Integration for Request Type page displays the following:

  • A drop-down list of the unmapped QC/ALM Entity Fields
  • A drop-down list of the unmapped PPM Request Fields
  • The Current Field Mappings table

Following is an example of an integration that has some field mappings configured.

To understand 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.

Back to top

Create a new field mapping

To create 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.

Back to top

Modify 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 Configure value mappings.

Back to top

Configure 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 Map Values.

    The Map Values window opens.

    In this example, some QC/ALM Values and PPM Values have been mapped and others have not.

  2. Select a value from the QC/ALM Values column and a value from the PPM Values column. Then select an enabled <=, =>, or <=> button between the columns to specify the direction of the value mapping.

    The integration does not allow you to configure invalid value mappings. For example, if the field mapping specified in the Control column is QC/ALM or PPM, not Bidirectional, then only the corresponding direction for value mapping is available.

    If the field mapping specified in the Control column is PPM, you can use the (All unmapped PPM Values) option to map all the remaining unmapped PPM Values to one of the QC/ALM Values. Conversely, if the field mapping specified in the Control column is QC/ALM, you can use the (All unmapped QC Values) option to map all the remaining unmapped QC/ALM Values to one of the PPM Values.

    If the field mapping specified in the Control column is Bidirectional, you can map either all the remaining PPM Values to one of the QC/ALM Values or all the remaining QC/ALM Values to one of the PPM Values.

    Make sure that the mapping you specify will not result in invalid values in terms of PPM or QC/ALM processes.

  3. Click OK.

Back to top