Top of ADM | Index | Table of Contents | Feedback | ![]() |
Enrolment Message Rules
Callista uses institution definable rules to check the Enrolment of students in Units. These rules include Pre-requisite, Co-Requisite, Incompatible, Quota and Equivalent Unit checking. Enrolment Message Rules are used to construct the messages that can be displayed in ENRF3000 and in student self Enrolment, when an Enrolment rule is failed. Messages are a string of characters returned by the Message Rule and may contain text strings concatenated with data values applicable to the student and the Unit being enrolled.
Enrolment Message Rules can be viewed in RULF2001. These rules make up the MSG-GEN and MSG-SPEC subgroups of the Enrolment Rule Group and are used to define the content and format of the messages displayed in the Callista ENRF3000 Student Unit Attempt screen and the Callista Connect Self Enrolment facility when Unit Enrolment rules are not satisfied.
Four levels of messaging are available:
Note: Institution-wide (I/W) messages relate to Unit rules that consider all of a Students Course Attempts. Course specific (SCA) messages relate to Unit rules that consider only the context Course Attempt.
In this section:
An Example of Both SCA and I/W Rules
An institution using both SCA and I/W rules, utilising Levels 1, 3 and 4 messages might set up rule messages as shown below.
Message Rule |
Message Text |
Level 1General Message |
Unit
rule warnings/breaches found for Unit KFE102. |
Level 2 General Incompatible Message |
|
Level 3 General Incompatible (Institute Wide) Message |
Unit KFE102 is incompatible with another passed or Enrolled Unit in this or another course. |
Level 3 General Incompatible (SCA) Message |
Unit KFE is incompatible with another passed or Enrolled Unit in this course |
(Level 4) Incompatible (I/W) 2189: Unit Not Compatible with Achievement in Unit from Set of Units |
Cannot enrol in Unit KFE102 if any of the Units {KFE103,KFE104} have already been passed in any course. The Unit/s {KFE103} has/have already been passed. |
(Level 4) Incompatible (SCA) 20010 Incompatible with Achievement in Unit from Set of Units |
Cannot enrol in Unit KFE102 if any Units {KFE103,KFE104} have already been passed in this course. The Unit/s {KRE103} has/have already been passed. |
If a student does not satisfy an I/W incompatible rule, the following message text may be generated:
Unit rule warnings/breaches found for Unit KFE102
Details below:
Unit KFE is incompatible with another passed or enrolled Unit in this course
Cannot enroll in Unit KFE102 if any Units {KFE103,KFE104} have already been passed in this course. The Unit/s {KRE103} has/have already been passed
An Example of Not using I/W Rules
Alternatively, an institution which does not use (I/W) rules might set up the following messages.
Message Rule |
Message Text |
Level 1General Message for all Unit Rules |
Unit
rule warnings/breaches found for Unit KFE102. |
Level 2 General Incompatible Message |
KFE102 is incompatible with another passed or Enrolled Unit. |
Level 3 General Incompatible (Institute Wide) Message |
|
Level 3 General Incompatible (SCA) Message |
|
(Level 4) Incompatible (I/W) 2189: Unit Not Compatible with Achievement in Unit from Sets of Units |
|
(Level 4) Incompatible (SCA) 20010: Incompatible with Achievement in Unit from Sets of Units |
Cannot Enroll in Unit KFE102 if any of the Units {KFE103,KFE104} have already been passed in this course. The Unit/s {KRE103} has/have been passed. |
If a student fails an I/W incompatible rule, the following message text may be generated:
Unit rule warnings/breaches found for Unit KFE102.
Details below:
KFE102 is incompatible with another passed or enrolled Unit.
Cannot enrol in Unit KFE102 if any of the Units {KFE103,KFE104} have already been passed in this course. The Unit/s {KRE103} has/have been passed.
Important Note: If related Message Rules are not created at a particular level then no message for that level is displayed. If no Message Rules (at any level) are related to a particular rule failure, then no message will be displayed - The message box/window will be empty. If messaging is not required, the CHKVALIDTY Enrolment step should be removed from the relevant Enrolment categories.
Level 1-3 rules are maintained in the Enrolment/MSG-GEN Rule Subgroup in RULF2001. Rules for level 4 are maintained in the Enrolment/MSG-SPEC Rule Subgroup in the same form.
At each level messages may be constructed by combining strings of text with values for selectable rule options in the Enrolment Rule.
e.g. The rule `Unit `+P_UNIT_CODE+`is incompatible with the Units`+SET_OF_SELECTABLE_UNITS +`.`might return the message: Unit MAA104 is incompatible with the Units {MEE103,MLC103}.
In this case MAA104 is the Unit in which Enrolment is attempted (value of P_UNIT_CODE) and {MEE103,MLC103} form the list of incompatible Units(value of SET_OF_SELECTABLE_UNITS).
Rule Options Available to All MSG-GEN and MSG-SPEC Rules. (levels 1,2,3 and 4)
Rule Option |
|
`text` |
Accent symbol used to delimit a string of text. ` INCOMPATIBLE ` returns INCOMPATIBLE |
P_UNIT_CODE |
Code for Unit in which Enrolment is attempted. |
+ |
Plus symbol used to join two rule options e.g.
`WILLIAM`+`SHAKESPEARE` returns WILLIAMSHAKESPEARE; |
Rule Options Available to Selected MESSAGE Rules (level 4 only)
*See Rule Options Available table for detail about which Rule options are available for each Level 4 rule.
Rule Option |
|
ACHIEVED_GPA |
Actual Student Course Attempt GPA. |
ACHIEVED_WAM |
Actual Student Course Attempt WAM. |
SUA_CREDIT_POINTS |
Enrolled Credit Points/ Credit points gained by completion of SUA's. |
ADV_STNDG_UNITS_CREDIT_POINTS |
Actual Credit Points for granted Advanced Standing. |
ADV_STNDG_LEVELS_CREDIT_POINTS |
Actual Credit Points for granted Advanced Standing Unit levels. |
TOTAL_CREDIT_POINTS |
Total Credit Points for SCA. (SUA_CREDIT_POINTS + ASU_CREDIT_POINTS + ASUL_CREDIT_POINTS). |
ACHIEVED_CREDIT_POINTS |
Equivalent to TOTAL_CREDIT_POINTS. |
REMAINDER_UNITS |
The Units required for entry but not yet passed or granted Advanced Standing. |
SELECTABLE_UNITS_USED |
The Units (including translations) required for entry, which have been passed or granted Advanced Standing. |
ACTUAL_STUDENT_UNITS_SELECTED |
The Units (including translations) required for entry, in which the student has enrolled. |
NUMBER_OF_FURTHER_UNITS_REQUIRED |
The minimum number of further Units to be passed, or granted Advanced Standing in, from the nominated set. |
SET_OF_COURSE_CODES |
The set of Course Codes specified in rules for this Unit. e.g. For rule 'Must be enrolled in course version {M300.1}', SET_OF_COURSE_CODES = { M300.1} |
SET_OF_COURSE_TYPES |
The set of Course Types specified in rules for this Unit. e.g. For rule 'Must be enrolled in course type {10}', SET_OF_COURSE_TYPES = BACHELOR'S PASS |
SET_OF_SELECTABLE_UNIT_SETS |
The set of Unit Sets specified in rules for this Unit. e.g. For rule 'Any co-req Unit set in {ACMN }', SET_OF_SELECTABLE_UNIT_SETS = ACCOUNTANCY MINOR. |
SET_OF_ALLOWABLE_LEVELS |
The set of Unit levels specified in rules for this Unit. e.g. For rule 'Must have passed 8 Credit Points at levels {2,3}', SET_OF_ALLOWABLE_LEVELS = {2,3} |
SET_OF_ALLOWABLE_ORG_UNITS |
The set of Org Units specified in rules for this Unit. e.g. For rule 'Must have passed 12 Credit Points from Units owned by {01 }', SET_OF_ALLOWABLE_ORG_UNITS = FACULTY OF BUSINESS AND LAW. |
SET_OF_SELECTABLE_UNITS |
The set of Units specified in rules for this Unit. e.g. For rule 'Must have passed 2 Units in {MAA102,MAA103,MAA104}', SET_OF_SELECTABLE_UNITS = {MAA101,MAA102,MAA103} |
EXPANDED_SELECTABLE_UNITS |
The set of Units, including translated Units, specified in rules for this Unit. e.g. For Unit rule 'Must have passed 2 Units in {MAA102,MAA103,MAA104}', if a Unit Translation rule exists for MAA102 - 'Unit was previously coded as {ACC100}', then EXPANDED_SELECTABLE _UNITS = {ACC100,MAA102,MAA103,MAA104}. Note:
The contents of the expanded set are also determined by the System-wide
Translation Expansion Set rule. It is used to define the level of translation
expansion that should occur for all rules that use sets of Units. When
the translation of Units is performed, the original set of Units is
always included in the expanded set. The rule has options to: |
MINIMUM_REQUIRED_GPA |
The minimum required Course GPA specified in rules for this Unit. e.g. For Unit rule 'Must have Course GPA equal to or greater than 6', MINIMUM_GPA =6. |
MINIMUM_REQUIRED_CREDIT_POINTS |
The minimum achieved CP in course specified in rules for this Unit e.g. For Unit rule 'Must have passed 12 Credit Points', MINIMUM_REQUIRED_CREDIT_POINTS = 12 |
MINIMUM_ REQUIRED_WAM |
The minimum required Course WAM specified in rules for this Unit. e.g. For Unit rule 'Must have Course WAM equal to or greater than 70', MINIMUM_WAM =70 |
UNIT_SET_CATEGORY |
The Unit Set Category specified in rules for this Unit. e.g. For Unit rule 'Any co-req Unit sets of category MAJOR', UNIT_SET_CATEGORY = MAJOR |
MINIMUM_REQUIRED_GRADE |
The minimum Passing Grade required for the number of Units/Credit Points specified in rules for this Unit. e.g. For Unit rule 'Must have passed 6 Credit Points with a grade of at least STANDARD.HD', MINIMUM_REQUIRED_GRADE = STANDARD.HD |
MINIMUM_REQUIRED_NUMBER_OF_UNITS |
The minimum number of Units required (passed or granted Adv. Standing) from the set of Units specified in rules for this Unit. e.g. For Unit rule 'Must have passed 2 Units in {MEE101,MEE102,MEE103}', MINIMUM_REQUIRED_NUMBER_OF_UNITS = 2 |
SET_OF_CONFLICTING_UNITS |
Those Units which are equivalent to the Unit to be enrolled in. Used for Unit translation set rule checking. |
Rule Options Available for Each Type of Rule Message.
Message Number |
Relates to failure of rule form |
>Available
Rule Options |
Co-requisite(SCA) 20009 |
Any co-req Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Co-requisite(SCA) 1777 |
Any co-req Unit set in { Unitset,..} |
SET_OF_SELECTABLE_UNIT_SETS |
Co-requisite(SCA) 1778 |
Any co-req Unit sets of category category |
UNIT_SET_CATEGORY |
Co-requisite(SCA) 20008 |
Any passed co-req Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Co-requisite(SCA) 1773 |
Must be Enrolled in Course owned by {orgunit} |
SET_OF_ALLOWABLE_ORG_UNITS |
Co-requisite(SCA) 1774 |
Must be Enrolled in Course Type {coursetype,..} |
SET_OF_COURSE_TYPES |
Co-requisite(SCA) 1775 |
Must be enrolled in course type {coursetype,..} owned by {orgunit,..} |
SET_OF_COURSE_TYPES |
Co-requisite(SCA) 1776 |
Must be Enrolled in Course Version {coursecode.version,..} |
SET_OF_COURSE_CODES |
Co-requisite(I/W) 2187 |
Any co-req (IW) Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Co-requisite(I/W) 2182 |
Any co-req (IW) Unit set in {Unitset,..} |
SET_OF_SELECTABLE_UNIT_SETS |
Co-requisite(I/W) 2183 |
Any co-req (IW) Unit sets of Category category |
UNIT_SET_CATEGORY |
Co-requisite(I/W) 2663 |
Any passed co-req (I/W) Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Co-requisite(I/W) 2749 |
Any number (I/W) co-req Units in {Unit,..} |
ACTUAL_NUMBER_OF_UNITS |
Co-requisite(SCA) 2746 |
Any number co-req Units in {Unit,..} |
ACTUAL_NUMBER_OF_UNITS |
Incompatible (SCA) 20011 |
Incompatible with {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Incompatible (SCA) 20010 |
Incompatible with achievement in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Incompatible (I/W) 2190 |
Incompatible with (IW) {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Incompatible (I/W) 2189 |
Incompatible with achievement in (IW) {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Incompatible (I/W) 2752 |
Incompatible with Enrolment in a (I/W) Unit Set from {Unitset,..} |
SET_OF_VALID_UNIT_SETS |
Prerequisite (SCA) 1747 |
Must have course GPA equal to or greater than number |
MINIMUM_REQUIRED_GPA |
Prerequisite (SCA) 1748 |
Must have course WAM equal to or greater than number |
MINIMUM_
REQUIRED_WAM |
Prerequisite (SCA) 1749 |
Must have Enrolled in number Credit Points |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (SCA) 20007 |
Must have Enrolled in a Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Prerequisite (SCA) 1745 |
Must have passed number Credit Points |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (SCA) 1831 |
Must have passed number Credit Points at levels{ level,..} |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (SCA) 1833 |
Must have passed number Credit Points at levels{ level,..} from Units owned by { orgunit,..} |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (SCA) 1832 |
Must have passed number Credit Points from Units owned by { orgunit,..} |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (SCA) 1834 |
Must have passed number Credit Points with a grade of at least schema.grade |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (SCA) 1829 |
Must have passed number Units in {Unit,..} |
MINIMUM_REQUIRED_NUMBER_OF_UNITS |
Prerequisite (SCA) 1830 |
Must have passed number Units in {Unit,..} with a grade of at least schema.grade |
MINIMUM_REQUIRED_NUMBER_OF_UNITS |
Prerequisite (SCA) 20006 |
Must have passed a Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Prerequisite (I/W) 2198 |
Must have passed number (I/W) Units in {Unit,..} with grade of at least schema.grade |
MINIMUM_REQUIRED_NUMBER_OF_UNITS |
Prerequisite (I/W) 2204 |
Must have Enrolled in an (IW) Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Prerequisite (I/W) 2196 |
Must have passed number (IW) Credit Points |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (I/W) 2199 |
Must have passed number (IW) Credit Points at levels{ level,..} |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (I/W) 2201 |
Must have passed number (IW) Credit Points at levels{ level,..} from Units owned by{ orgunit,..} |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (I/W) 2200 |
Must have passed number Credit Points from Units owned by{ orgunit,..} |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (I/W) 2202 |
Must have passed number Credit Points with grade of at least schema.grade |
MINIMUM_REQUIRED_CREDIT_POINTS |
Prerequisite (I/W) 2197 |
Must have passed number Units in{ Unit,..} |
MINIMUM_REQUIRED_NUMBER_OF_UNITS |
Prerequisite (I/W) 2203 |
Must have passed an (IW) Unit in {Unit,..} |
SET_OF_SELECTABLE_UNITS |
Quotas on 2777 |
Quotas on |
- |
System Wide (I/W) 2729 |
Incompatible with number previous (I/W) failures in context Unit |
MINIMUM_TIMES_FAILED |
System Wide (I/W) 2740 |
Level {Unit level,…} Units require number (I/W) Credit Points |
ACHIEVED_CREDIT_POINTS |
System Wide (I/W) 2743 |
Level {Unit level,…} Units require number (I/W) pass(es) from Unit(s) from {Unit,..} |
ACTUAL_NUMBER_OF_UNITS |
System Wide 20104: Equivalent Unit Checking | Completed a Unit which translates to a Unit incompatible with the one being enrolled in. |
SET_OF_CONFLICTING_UNITS |
Tip:
To insert a blank line before a message start the rule text with a space followed by a carriage return. To insert a blank line after a message, end the rule text with a carriage return followed by a space.
For example, the following rule text:
`<space¿ >To enrol in Unit `+P_UNIT_CODE+`, must have a course WAM of at least `MINIMUM_REQUIRED_WAM`. Actual course WAM=`+ACTUAL_WAM+`<¿space >`
will cause a blank line to be displayed before and after the message. (The symbols < and > indicate inserted text and are not part of the rule text.)
Last modified on 19 January, 2004