Add a Matrix Selector Control to a Form

Use the Form Editor (accessed from within a Blueprint in CSM Administrator) to add a Matrix Selector Control to a Form. When you add a Matrix Selector Control to a Form, you define:

• Validation instructions:
  • Validation Table: Business Object that supplies all the possible values to the matrix (ex: Priority Matrix Element). Typically, this is a Lookup Object.
  • Value Field: Lookup field (Field in the Lookup Object) that supplies the values (ex: Priority).
  • Order By: Field to use to order the values in the matrix, as well as an ascending (ex: 0-10, A-Z) or descending (10-0, Z-A) order.
  • Field to Populate: Field in the Business Object to populate with the final value from the matrix.
• Column properties: Values and order to display in the column header.
• Row properties: Values and order to display in the row.
• Constraints: Expressions that limit when the Field on the Form is populated with the final value from the matrix.

To add a Matrix Selector Control to a Form:

1. Open a Form in the Form Editor.
2. Drag-and-drop the Matrix Selector Control from the Special Control tree onto the Form.
3. Right-click the Control, and then select Control Properties.

4. Define the Validation:
   1. Validation Table/Field:

      Select the Lookup table and Field that supply all the possible values (example: For Incident, it might be the Status field in the Incident Status Lookup table, with Status values like New, In Progress, Assigned, etc.).

   2. Order By:

      Select the Field to use to order the values, as well as an ascending (ex: 0-10, A-Z) or descending (10-0, Z-A) order. Rarely will the alphabetical order match the order in which the values should appear in your item, unless you prefix the values with numbers or letters (example: For status, you would likely want lifecycle order, not alphabetical order); therefore, it is common to define a field that contains a sequence number purely for controlling the order (ex: Status Order).

   3. Field to Populate: Select the Field to populate with the final value from the matrix.
5. Define column properties:
   1. Column Header: Select the Field from the Lookup Object that supplies the value for the column header in the matrix.
   2. Save Column To: Select the Field in the primary Business Object to populate with the column value selected from the matrix.
6. Define row properties:
   1. Row Header: Select the Field from the Lookup Object that supplies the value for the row header in the matrix.
   2. Save Row To: Select the Field in the primary Business Object to populate with the row value selected from the matrix.
7. Define constraints that limit when the Field on the Form is populated with the final value from the matrix:
   1. Click Add to add a constraint or filter.
   2. Select a Field in the Business Object you are currently working with.
   3. Select an operator (ex: Equals).
   4. Value: Select a value for the Field. Applicable values include:
      • Fields
      • Expressions
      • Metric Values
      • Prompts
      • Stored Values
      • System Functions
   5. Click OK.
   6. Add additional constraints as necessary.

8. Click OK.

9. After the Control or Controls are on the Form, use the Form Editor to define how each Control looks and behaves on the Form (ex: Size, image, alignment, anchoring, layering, visibility, and tab order).
10. Publish the Blueprint (File>Publish Blueprint) to commit the changes, or save the Blueprint (File>Save Blueprint) to continue making other changes.