|
|
|
|
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:
- Level 1 A General message displayed whenever one or more rules are
not satisfied for a unit..
- Level 2 General messages displayed after Level 1 message for both
Institute-wide (I/W) and Course specific (SCA) unit rules of a specific
type (corequisite, incompatible or prerequisite).
e.g. If a Level 2 General Incompatible Message rule has been defined it will generate a Level 2 General Incompatible Message whenever any Incompatible rules are not satisfied. - Level 3 General messages displayed after level 1-2 messages for either
I/W or SCA based rules of specific types (corequisite, incompatible or prerequisite).
e.g. If a Level 3 General Incompatible (SCA) Message rule has been defined it will generate a Level 2 General Incompatible Message whenever any Incompatible (SCA) rules are not satisfied, but not when Incompatible (I/W) rules not satisfied. - Level 4 Specific messages displayed after level 1-3 messages that
give details about the rule that was not satisfied and the reason why it
was not satisfied.
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.
·
A rule described as 'System Wide' applies to
all units in the system.
·
A rules described as 'Course' applies to units
within a specific course.
·
The remaining rules are specific to particular
units.
Example A
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.
Example B
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:
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 Adv. standing. |
|
SELECTABLE_UNITS_USED |
The units (including translations) required for entry, which have been passed or granted Adv. 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 Adv. 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 coreq 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 11 March 2002