Business rules installed with assessments

Business rules

Assessments adds the following business rules.
Table 1. Business rules for assessments
Name Table Description
Assessable domain matches type Assessable Record

[asmt_assessable_record]

Ensures that all new assessable records are in the same domain as the metric type. This is a special requirement of assessment domain separation, that all records must be in the same domain.
Auto stakeholder creation Assessment Category User

[asmt_m2m_category_user]

Assigns new category users as stakeholders automatically for assessable records if the associated category has the Create stakeholders check box selected.
Auto stakeholder creation Category Assessable Records

[asmt_m2m_category_assessment]

Creates stakeholders from all of a category's category users automatically for new assessable records if:
  • The Create stakeholders check box is selected for the metric category.
  • The same metric category is associated to the new assessable record.
Auto stakeholder creation Metric Category

[asmt_metric_category]

Assigns all of a category's category users as stakeholders for each assessable record associated to the category when the Create stakeholders check box is selected for the category.
Calculate category max weight Assessment Metric

[asmt_metric]

Calculates the sum of all metric weights in a category.
Cancel notification workflow Assessment Instance

[asmt_assessment_instance]

Cancels the workflow that generates assessment email notifications when an assessment instance is deleted or changes state to Complete or Canceled.
Category domain matches type Metric Category

[asmt_metric_category]

Ensures that all new categories are in the same domain as the metric type. This is a special requirement of assessment domain separation, that all records must be in the same domain.
Check Live Feed Groups Assessable Record

[asmt_assessable_record]

Selects the Live feed check box if a live feed group is associated with the source record. If the Live feed check box is selected and no live feed group is associated with the source record, this business rule clears the check box.
Check only one default Bubble Chart

[asmt_bubble_chart]

Ensures there is only one default bubble chart for a metric type.
Check only one default Decision Matrix

[asmt_decision_matrix]

Ensures there is only one default decision matrix for a metric type.
Create actual results Assessment Instance

[asmt_assessment_instance]

Generates assessment and category results from the user responses if a user completes an assessment.
Create Business Rule on Remote table Assessment Metric Type

[asmt_metric_type]

Generates the following business rules if an assessment administrator creates or updates a metric type:
  • Business rule called Auto business rule for Assessments, which monitors the Table selected for the metric type. When someone adds a record that meets the metric type conditions, this business rule generates an assessable record. If someone changes the metric type's Table or conditions, the Create Business Rule on Remote table business rule updates the automatic business rule script to reflect the changes.
  • Business rule called Auto deletion rule for Assessments, which prevents users from deleting a record on the metric type's Table if the record is associated to metric or category results. If the record has no associated results and a user deletes it, this business rule deletes any associated assessable records.

The Create Business Rule on Remote table business rule generates automatic business rules only for metric types with Evaluation method set to Assessment.

Create Scheduled Job Assessment Metric Type

[asmt_metric_type]

Assessments: Generates a scheduled job for the creation of assessment components if either of these conditions is met:
  • Someone creates a new metric type with the schedule type set to Scheduled.
  • The schedule type changes from On demand to Scheduled.

Surveys: Generates a scheduled job for the creation of survey components if the schedule period for a survey definition is set to Daily, Weekly, Monthly, or Yearly.

Create Survey Records Assessment Metric Type

[asmt_metric_type]

Generates various records and populates certain fields on those records when someone creates a new survey definition, which is a metric type with Evaluation method set to Survey. More specifically, this business rule generates a survey category and assessable record, both associated to the survey definition.
Create UI Action on Remote table Assessment Metric Type

[asmt_metric_type]

Reserved for future use.
decision_matrix_axis Global

[global]

Limits available categories for X- and Y-axes to those that belong to the type if there is a metric type specified on the Decision Matrix form.
Delete Live Feed Group Assessable Record

[asmt_assessable_record]

Deletes the assessable record's live feed group, if there is one, when an assessment administrator deletes an assessable record.
delete related users Category Assessable Records

[asmt_m2m_category_assessment]

Deletes any stakeholders for the assessable record and category when an assessment administrator disassociates a category from an assessable record.
Do not allow category to change Assessment Metric

[asmt_metric]

Prevents the Category field from being changed if there are any conditional question dependencies related to the current record.
Do not allow datatype to change Assessment Metric

[asmt_metric]

Prevents the Data type and Template fields from being changed if there are any conditional questions that depend on the current record.
Ensure Types Match Assessment Metric

[asmt_metric]

Sets the type of a metric to the type of the associated category.
Ensure types match Assessment Stakeholders

[asmt_m2m_stakeholder]

Ensures users can only create a stakeholder from a category user and assessable record of the same type.
Ensure types match Category Assessable Records

[asmt_m2m_category_assessment]

Prevents users from associating categories of one type to an assessable record of a different type.
Evaluate filters Assessable Record

[asmt_assessable_record]

Performs the following after the system generates a new assessable record:
  • Checks all filter conditions for categories in the type.
  • Automatically associates the new assessable record to all categories for which it meets the category filter conditions.
Generate assessment trigger condition Trigger Condition

[asmt_condition]

Generates a business rule the survey or assessment trigger condition uses to send surveys or assessments.
getStakeholders Global

[global]

Ensures that only category users for categories associated with the assessable record are available on the Assessable Record form when users edit the Category users related list.
Link assessable record and category Metric Category

[asmt_metric_category]

Sets these hidden fields as follows for a newly created survey category:
  • Table: Assessment Metric Type [asmt_metric_type]
  • Filter: <sys_id of the survey definition the new survey category is associated with>
Live Feed Group Assessable Record

[asmt_assessable_record]

Creates a live feed group for the assessable record, if one does not exist, when the record is saved with the Live feed check box selected. If the check box is then cleared and the record saved, this business rule deletes an existing live feed group.
Metric domain matches category Assessment Metric

[asmt_metric]

Ensures that all new metrics are in the same domain as the category to which they belong. This is a special requirement of assessment domain separation, that all records must be in the same domain.
Notify assessment user Assessment Instance

[asmt_assessment_instance]

Starts a workflow that sends an email notification to the assigned user when an assessment instance changes to the Ready state or the user to which it is assigned changes. The workflow generates other assessment email notifications at later stages.
Prevent recursive dependencies Assessment Metric

[asmt_metric]

Prevents the Depends on field from being set in a way that creates a recursive conditional question dependency.
Publish Survey Assessment Metric Type

[asmt_metric_type]

Generates survey instances and assigns them to the associated survey users when the survey definition state changes from Draft to Published.
Remove auto create Business Rules Assessment Metric Type

[asmt_metric_type]

Deletes the automatically created business rule for a metric type when an assessment administrator deletes that metric type.
Remove auto create UI Actions Assessment Metric Type

[asmt_metric_type]

Reserved for future use.
Remove auto created business rule Survey Trigger Condition

[asmt_condition]

Deletes the automatically created business rule when someone deletes the survey trigger condition.
Remove Scheduled Job Assessment Metric Type

[asmt_metric_type]

Assessments: Deletes the scheduled job for a metric type if either of these conditions is met:
  • Someone deletes the metric type.
  • Someone changes the schedule type from Scheduled to On demand.

Surveys: Deletes the scheduled job for a survey definition if the schedule period is set to Only Once or No Limit.

Reset Min/Max for metric Assessment Metric Definition

[asmt_metric_definition]

Updates the Min and Max fields for metrics and survey questions based on the metric definition Value.
Set Domain for M2M Cat Assessable Recs Category Assessable Records

[asmt_m2m_category_assessment]

Ensures that assessable records are only associated to categories in the same domain. This is a special requirement of assessment domain separation, that all records must be in the same domain.
Set Domain for M2M Category Users Assessment Category User

[asmt_m2m_category_user]

Ensures that users are only linked to categories in the same domain. This is a special requirement of assessment domain separation, that all records must be in the same domain.
Set Domain for M2M Stakeholders Assessment Stakeholders

[asmt_m2m_stakeholder]

Ensures that assessable records are only linked to category users in the same domain. This is a special requirement of assessment domain separation, that all records must be in the same domain.
Set scratchpad fields Assessment Metric Type

[asmt_metric_type]

Caches field values for use by other scripts that run on the Assessment Metric Type form.
Store view type Metric Category

[asmt_metric_category]

Ensures that the Type field only allows users to select metric types used for assessments.
Synchronize category survey users Assessment Category User

[asmt_m2m_category_user]

Ensures that the same users are associated with all of a survey's categories.
Synchronize survey users and stakeholder. Metric Category

[asmt_metric_category]

Adds all users associated with a survey's existing categories to any newly created category for that survey.
Update Category Count Assessment Metric

[asmt_metric]

Updates the value in the Total metrics field on the Metric Category form when metrics are added to and deleted from the category.
Update records that match filter Metric Category

[asmt_metric_category]

Automatically performs these tasks when an assessment administrator edits the Filter field:
  • Associates the category to assessable records that meet the filter conditions.
  • Disassociates the category from assessable records that do not meet the filter conditions.

The Assessable records related list reflects these changes when the record is saved.

Update scheduled job on schedule change Assessment Metric Type

[asmt_metric_type]

Updates the survey creation scheduled job to reflect schedule period changes.
Validate mandatory and not applicable Assessment Metric

[asmt_metric]

Sets the Mandatory and Allow not applicable fields to false if the metric method is Script. If the metric data type is Percentage, the business rule sets the Allow not applicable field to false.
Verify min/max Assessment Metric

[asmt_metric]

Ensures that the Min is greater than or equal to zero and less than the Max. Sets the Min to 0 and the Max to 1 if the data type is Checkbox or Yes/No.
Verify value Assessment Template Definition

[asmt_template_definition]

Ensures that the metric template definition Value is:
  • Greater than or equal to zero.
  • Different from the Value for all other metric template definitions related to the template.
Verify value Assessment Metric Definition

[asmt_metric_definition]

Ensures that users can only enter a metric definition Value greater than or equal to zero. Ensures that the metric definition Value is different from the Value for all other metric definitions related to the metric.