Creating objects based on scores in a questionnaire assessment

You can configure the Questionnaire Assessment Workflow to create an object, such as an issue, when the score for the response to a question doesn't meet a set threshold.

Any files that are attached to the answered question are automatically attached to the created object.

You can create any object type except for Files (SOXDocument) and Links (SOXExternalDocument).

For more information about how scores are calculated, see Questionnaire template scores and scoring methods.

About this task

To perform this task, you must be an administrator with the application permission SOX > Administration > Workflow.

Procedure

  1. To open the GRC Workflow Designer, click Open Administration menu Administration menu > Solution Configuration > Workflows.
  2. Click Questionnaire Assessment Workflow.
  3. Select an action between two stages. For example, for a two stage questionnaire assessment, you can select the action Submit and Close between the Information Gathering stage and the Closed stage.
    The Action Properties panel appears.
  4. Expand the Validations and Operations section.
  5. Click New Operation.
  6. In the Operation field, select Custom action.
  7. Enter a Name.
  8. In the Class Name field, enter com.ibm.openpages.api.service.local.workflow.actions.QuestionnaireScoreAssessmentAction.
  9. Set the threshold:
    1. Click Add Property.
    2. Enter the Name of the property, threshold, and a Value, such as 4. When you set the value to 4, an object, such as an issue, is generated when a score for an answer is less than 4. If you don't specify the property objectType in step 10, an issue is generated by default.
      The default value of the threshold property is 5.
    3. In the Properties panel, click Done.
  10. Optional: If you want to create an object type other than an issue (the default), set the object type:
    1. Click Add Property.
    2. Enter the Name of the property, objectType, and a Value, such as SOXRisk. When you set the value to SOXRisk, a risk is generated when a score for an answer is less than the set threshold.
      The default value of the objectType property is SOXIssue.

      The objectType property must specify the system name, such as SOXRisk, rather than the display name, such as Risk. The object type must be a child of the asset type.

    3. In the Properties panel, click Done.
  11. In the Operations panel, click Done and click Publish.

Results

When the questionnaire assessment triggers the custom action, the questionnaire assessment shows an icon to point out each answer that has a score below the set threshold and an object, such as an Issue, is created. The low score icon only appears when the questionnaire assessment is in the Review stage.

In the following example, an issue is created because the objectType property was not specified.

Figure 1. A section of a questionnaire showing the low score icon
A questionnaire assessment with an answer that has a low score

The following figure shows the Parent and child relationships diagram for a questionnaire assessment. The relationships are expanded to show an issue as a child of the resource.

Figure 2. Parent and child relationship diagram showing an issue
Parent and child relationships diagram from the Admin tab of a questionnaire assessment showing an issue