Skip to main content

Jama Connect User Guide

Add a lookup matrix

A lookup matrix serves as a source for logic-based calculations in lookup matrix type calculated fields.

To add a logic-based calculated field to an item, you must first add the lookup matrix and give it a name. Adding an optional description defines how the lookup matrix is used in calculated fields.

To configure a lookup matrix, you must select a pick list for the matrix columns, rows, and results.

  1. Create pick lists for the calculation inputs (matrix rows and matrix columns) and the calculation results (matrix values).

    1. Select Lookup matrix as the pick list type.

    2. (Optional) To change the table color from default gray, select a row in the Pick list values table, click Edit values, and select a color.

  2. Select Admin > Organization > Lookup matrices.

  3. Click Add lookup matrix.

  4. Enter a name and optional description for the lookup matrix.

  5. Configure the lookup matrix settings:

    1. Under Matrix Configurations, use the drop-down selectors to configure the matrix columns, rows, and values/result.

    2. Click Generate matrix, then select matrix values for each matrix cell according to the logic-based calculation outcomes you need.

      For example, when you select Low for the P-total field and Minor for the Severity field, the calculated field for Risk Score returns the result Acceptable in yellow.

  6. Click Save & done.

  7. Select from an existing item type or add a new item type, then click Add field.

  8. Confirm that the calculation input fields were added to the item: make sure the pick lists match the configuration pick lists used for the calculation lookup matrix source you want.

  9. In the Add field window that opens, select Lookup matrix as the calculation type.

    Select from an existing lookup matrix as the calculation source, then select from available fields as calculation inputs.

  10. Click Save.