Top of RUL | Index | Table of Contents | Feedback | ![]() |
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.
Deletion of Message Rules
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. |
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. |
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