Completion Message Rules

Callista uses institution definable rules to determine completion by students of Course Attempts, Course Stages and Unit Set Attempts. Completion Message Rules are used to construct the messages that are displayed in PRGF9030 when a Completion Rule Check is performed. Messages are a string of characters returned by the Message Rule and may contain text strings concatenated with data values applicable to the student.

Example
If a Student Course Attempt is tested against the Completion Rule 'Must pass 24 credit points' and the rule is failed by virtue of the student only having completed 22 credit points, a Message Rule is invoked. That Message Rule constructs a message such as 'Has achieved 22 credit points.' for display in PRGF9030, ENRR08M0, Callista Connect and Staff Connect, thus explaining the rule failure. The Message Rule determines the value '22' from the Student's Course Attempt and inserts it in the relevant text string 'Has achieved credit points.'.

A set of completion Message Rules is supplied with Callista. Institutions can modify these rules using RULF2001.

To determine which Completion Rule a particular Completion Message Rule is related to:

Example

A course version Completion Rule for a course, as displayed in CRSF1700, contains the rule 'Must pass 2 units in {MAA101, MAA103, MEA101, MEE101, MEE102}'. To locate its corresponding Message Rule, the query criteria 'Must pass%units in%' can be used in the Comments field of RULF2001. Executing this query may result in more than one record being returned, as a number of rules may contain the text strings 'Must pass' and 'units in'. Scroll through the records until the correct 'Comment' is displayed, in this case 'Must pass #NUMERIC units in #SET'. The Rule Description field identifies the Message Rule, in this case 'COMP-1586' and by using the Rule Text button, the Message Rule is displayed in the Rule Text field. The rule text in this case might be something like '`Has completed `+VALID_UNITS_USED+`. Requires `+NUMBER_OF_ADDITIONAL_UNITS_REQUD+` more units.`'.

Rule Options for Completion Message Rules

The table contains all available options. A specific Message Rule will only have a small subset of these options available to it, determined by the nature of its corresponding Completion Rule. The available options for a specific Message Rule are displayed when the rule is being edited in RULF2000.

Note: This table may not always contain the full list of rule options, as options may be added to Callista without notice. RULF2000 will always display the full set of options available to each Message Rule.

Message rules should not be cleared using the Delete button on the toolbar. This will not be possible in any case, if the rule for which the message is displayed has been applied. For message rules, use the Delete or Backspace key to clear the rule text.

Rule Options	Usage
`	Accent symbol is used before and after strings of text.
+	Plus symbol concatenates strings of text and data values. e.g. `William`+`Shakespeare` returns WilliamShakespeare.
ACHIEVED_CONCEDED_PASS_CP	The number of conceded pass credit points achieved.
ACHIEVED_CONCEDED_PASS_CP_PERCENTAGE	Displays the percentage of acheived credit points that are of grade conceded pass.
ACHIEVED_CONCEDED_PASS_UNITS_PERCENTAGE	The percentage conceded pass units achieved.
ACHIEVED_CREDIT_POINTS	Number of passed credit points plus number of granted advanced standing credit points for the Student Course Attempt. (Note: Includes credit points for recommended outcomes in some rules).
ACHIEVED_GPA	The calculated Grade Point Average for completed units in the Student Course Attempt.
ACHIEVED_WAM	The calculated Weighted Average mark for completed units in the Student Course Attempt.
ACTUAL_NUMBER_OF_UNITS	Number of units that have been achieved from the set of units specified in the Completion Rule.
ACTUAL_STUDENT_UNITS_SELECTED	The set of units selected by the Completion Rule that contribute to satisfying that rule. NOT IMPLEMENTED.
ALLOWABLE_UNIT_SETS	The allowable sets of unit sets.
COMPLETED_COURSES	The set of completed courses selected by the Completion Rule that contribute to satisfying its rule criteria.
CONCEDED_PASS_CREDIT_POINTS<	The total number of credit points attributable to units granted a conceded pass in the Student Course Attempt.
CREDIT_POINTS_IN_SET	The total number of credit points achieved for units from the set of units satisfying the Completion Rule's criteria.
CREDIT_POINTS_REQUIRED	The total number of credit points specified as a course requirement of the Student Course Attempt.
	Joins two options in an IF statement. Syntax is 'IF condition THEN text ELSE text END IF'.
END IF	Signifies the end of an IF statement. Syntax is 'IF condition THEN text ELSE text END IF'.
IF (inserts IF PREDICTIVE THEN)	Starts an IF statement specifically related to whether or not the Completion Rule is testing for actual completion or predicted completion (Predictive indicator is set in PRGF9030). Syntax is 'IF PREDICTIVE THEN text ELSE text END IF'.
IF (inserts IF)	The start of an IF statement of the form 'IF condition THEN text ELSE text END IF'.
LEVEL_CREDIT_POINTS	The number of credit points attributable to passed units at the unit level(s) specified in the Completion Rule.
MAXIMUM_CONCEDED_PASS_CREDIT_POINTS	The total number of credit points attributable to units for which a conceded pass has been granted - where the Completion Rule specifies a maximum allowable number.
MAXIMUM_CONCEDED_PASS_CP_PERCENTAGE	The maximum percentage of credit points achieved which can be of grade conceded pass.
MAXIMUM_CONCEDED _PASS_UNITS_PERCENTAGE	The maximum percentage of units passed which can be of grade conceded pass.
MAXIMUM_NUMBER_OF_CONCEDED_PASS_UNITS	The total number of units for which a conceded pass has been granted - where the Completion Rule specifies a maximum allowable number.
MINIMUM_REQUIRED_CREDIT_POINTS	The total number of credit points attributable to passed units that contribute to satisfaction of the Completion Rule - where the Completion Rule specifies a minimum requirement.
MINIMUM_REQUIRED_NUMBER_OF_UNITS	The total number of passed units that contribute to satisfaction of the Completion Rule - where the Completion Rule specifies a minimum requirement.
NUMBER_OF_ADDITIONAL_COURSES_REQUD	The calculated difference between the number of required courses completed by the student and the number of required completed courses specified by the Completion Rule.
NOT_IN_UNITS	The set of excluded units.
NUMBER_OF_ACHIEVED_CONCEDED_PASS_UNITS	The number of conceded pass units achieved.
NUMBER_OF_ADDITIONAL_CP_REQUD	The number of additional credit points required.
NUMBER_OF_ADDITIONAL_RESTRICTED_CONCEDED_CP	The number of credit points for unit attempts with a grade of conceded pass which will still count toward completion.
NUMBER_OF_ADDITIONAL_RESTRICTED_CP_LEVEL	The remaining number of credit points required from a restricted level.
NUMBER_OF_ADDITIONAL_RESTRICTED_CP_REQUD	Number of additional credit points required from a specified set of units.
NUMBER_OF_ADDITIONAL_RESTRICTED_UNITS	Number of additional credit points still required from a specified set of units.
NUMBER_OF_ADDITIONAL_UNIT_SETS_REQUD	The calculated difference between the number of required Unit Sets completed by the student and the number of required completed Unit Sets specified by the Completion Rule.
NUMBER_OF_ADDITIONAL_UNITS_REQUD	The calculated difference between the number of required units completed by the student and the number of required units specified by the Completion Rule.
NUMBER_OF_CONCEDED_PASS_UNITS	The total number of units in the Student Course Attempt that have been granted conceded passes.
NUMBER_OF_REMAINING_NO_MORE_THAN_CP_LEVEL	The remaining credit points in a restricted level that will count toward completion.
PREDICTIVE	Used in conjunction with the IF option when the related Completion Rule considers the Predictive indicator in PRGF9030.
REMAINDER_UNITS	The set of units specified in the Completion Rule, less those units that already contribute to satisfying the rule.
REMAINING_REQUIRED_CREDIT_POINTS	The number of credit points still required.
REMAINING_SET	The units remaining in the Unit Set after the units satisfying the rule have been removed.
REMAINING_UNIT_SETS	Determines the remaining unit sets from the setof unit sets defined in the rule.
REMAINING_UNITS_NO_MORE_THAN_SET	Set of units remaining from a 'no more than #Numeric Units or CP in #Set ' rule.
REQUIRED_SPECIAL_REQUIREMENT	The required Special requirement.
SET_OF_ALLOWABLE_LEVELS	The unit levels specified as criteria in the related Completion Rule.
SET_OF_UNIT_CLASSES	Displays a set of unit classes.
STUDENT_UNIT_SETS_SELECTED	Used in an IF statement. Returns True or False. Syntax is 'IF STUDENT_UNIT_SETS_SELECTED THEN text ELSE text END IF'.
STUDENT_UNITS_SELECTED	The set of units contributing to satisfaction of the related Completion Rule. May include translated units as well as units from the specified set.
TOTAL_NUMBER_OF_UNITS	The number of units selected by the criteria specified in the related Completion Rule.
VALID_UNIT_SETS_SELECTED	The set of Unit Sets contributing to satisfaction of the related Completion Rule. Can only include Unit Sets from the specified set.
VALID_UNITS_USED	The set of units contributing to satisfaction of the related Completion Rule. Can only include units from the specified set. Does not include translations.

Last Modified on 15 December, 2005