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.
Details below:

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.
Details below:

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;
`The Unit `+P_UNIT_CODE may return The Unit KFE100

 

 

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:
Ÿ Not expand
Ÿ Expand to the first level of translation
Ÿ Expand recursively (cascade, using all translation levels).

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
[P_UNIT_CODE is common to most rules]

Co-requisite(SCA) 20009

Any co-req Unit in {Unit,..}

SET_OF_SELECTABLE_UNITS
EXPANDED_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
EXPANDED_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
SET_OF_ALLOWABLE_ORG_UNITS

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
SET_OF_VALID_UNITS
MINIMUM_REQUIRED_NUMBER_OF_UNITS
NUMBER_OF_ADDITIONAL_UNITS_REQUD
VALID_UNITS_USED

Co-requisite(SCA) 2746

Any number co-req Units in {Unit,..}

ACTUAL_NUMBER_OF_UNITS
SET_OF_VALID_UNITS
MINIMUM_REQUIRED_NUMBER_OF_UNITS
NUMBER_OF_ADDITIONAL_UNITS_REQUD
VALID_UNITS_USED

Incompatible (SCA) 20011

Incompatible with {Unit,..}

SET_OF_SELECTABLE_UNITS
ACTUAL_STUDENT_UNITS_SELECTED
EXPANDED_SELECTABLE_UNITS
SELECTABLE_UNITS_USED

Incompatible (SCA) 20010

Incompatible with achievement in {Unit,..}

SET_OF_SELECTABLE_UNITS
ACTUAL_STUDENT_UNITS_SELECTED
EXPANDED_SELECTABLE_UNITS

Incompatible (I/W) 2190

Incompatible with (IW) {Unit,..}

SET_OF_SELECTABLE_UNITS
ACTUAL_STUDENT_UNITS_SELECTED

Incompatible (I/W) 2189

Incompatible with achievement in (IW) {Unit,..}

SET_OF_SELECTABLE_UNITS
ACTUAL_STUDENT_UNITS_SELECTED

Incompatible (I/W) 2752

Incompatible with Enrolment in a (I/W) Unit Set from {Unitset,..}

SET_OF_VALID_UNIT_SETS
VALID_UNIT_SETS_SELECTED

Prerequisite (SCA) 1747

Must have course GPA equal to or greater than number

MINIMUM_REQUIRED_GPA
ACHIEVED_GPA

Prerequisite (SCA) 1748

Must have course WAM equal to or greater than number

MINIMUM_ REQUIRED_WAM
ACHIEVED_WAM

Prerequisite (SCA) 1749

Must have Enrolled in number Credit Points

MINIMUM_REQUIRED_CREDIT_POINTS
SUA_CREDIT_POINTS
ADV_STNDG_UNITS_CREDIT_POINTS
ADV_STNDG_LEVELS_CREDIT_POINTS
TOTAL_CREDIT_POINTS

Prerequisite (SCA) 20007

Must have Enrolled in a Unit in {Unit,..}

SET_OF_SELECTABLE_UNITS
EXPANDED_SELECTABLE_UNITS

Prerequisite (SCA) 1745

Must have passed number Credit Points

MINIMUM_REQUIRED_CREDIT_POINTS
ACHIEVED_CREDIT_POINTS

Prerequisite (SCA) 1831

Must have passed number Credit Points at levels{ level,..}

MINIMUM_REQUIRED_CREDIT_POINTS
SET_OF_ALLOWABLE_LEVELS
SUA_CREDIT_POINTS
ADV_STNDG_UNITS_CREDIT_POINTS
ADV_STNDG_LEVELS_CREDIT_POINTS
TOTAL_CREDIT_POINTS

Prerequisite (SCA) 1833

Must have passed number Credit Points at levels{ level,..} from Units owned by { orgunit,..}

MINIMUM_REQUIRED_CREDIT_POINTS
SET_OF_ALLOWABLE_LEVELS
SET_OF_ALLOWABLE_ORG_UNITS
SUA_CREDIT_POINTS
ADV_STNDG_UNITS_CREDIT_POINTS
TOTAL_CREDIT_POINTS

Prerequisite (SCA) 1832

Must have passed number Credit Points from Units owned by { orgunit,..}

MINIMUM_REQUIRED_CREDIT_POINTS
SET_OF_ALLOWABLE_ORG_UNITS
SUA_CREDIT_POINTS
ADV_STNDG_UNITS_CREDIT_POINTS
TOTAL_CREDIT_POINTS

Prerequisite (SCA) 1834

Must have passed number Credit Points with a grade of at least schema.grade

MINIMUM_REQUIRED_CREDIT_POINTS
MINIMUM_REQUIRED_GRADE
ACHIEVED_CREDIT_POINTS

Prerequisite (SCA) 1829

Must have passed number Units in {Unit,..}

MINIMUM_REQUIRED_NUMBER_OF_UNITS
SET_OF_SELECTABLE_UNITS
NUMBER_OF_FURTHER_UNITS_REQUIRED
ACTUAL_STUDENT_UNITS_SELECTED
REMAINDER_UNITS
SELECTABLE_UNITS_USED

Prerequisite (SCA) 1830

Must have passed number Units in {Unit,..} with a grade of at least schema.grade

MINIMUM_REQUIRED_NUMBER_OF_UNITS
SET_OF_SELECTABLE_UNITS
MINIMUM_REQUIRED_GRADE
NUMBER_OF_FURTHER_UNITS_REQUIRED
ACTUAL_STUDENT_UNITS_SELECTED
REMAINDER_UNITS
SELECTABLE_UNITS_USED

Prerequisite (SCA) 20006

Must have passed a Unit in {Unit,..}

SET_OF_SELECTABLE_UNITS
EXPANDED_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
SET_OF_SELECTABLE_UNITS
MINIMUM_REQUIRED_GRADE
NUMBER_OF_FURTHER_UNITS_REQUIRED
ACTUAL_STUDENT_UNITS_SELECTED
REMAINDER_UNITS
SELECTABLE_UNITS_USED

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
ACHIEVED_CREDIT_POINTS

Prerequisite (I/W) 2199

Must have passed number (IW) Credit Points at levels{ level,..}

MINIMUM_REQUIRED_CREDIT_POINTS
SET_OF_ALLOWABLE_LEVELS
SUA_CREDIT_POINTS
ADV_STNDG_UNITS_CREDIT_POINTS
ADV_STNDG_LEVELS_CREDIT_POINTS
TOTAL_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
SET_OF_ALLOWABLE_LEVELS
SET_OF_ALLOWABLE_ORG_UNITS
SUA_CREDIT_POINTS
ADV_STNDG_UNITS_CREDIT_POINTS
TOTAL_CREDIT_POINTS

Prerequisite (I/W) 2200

Must have passed number Credit Points from Units owned by{ orgunit,..}

MINIMUM_REQUIRED_CREDIT_POINTS
SET_OF_ALLOWABLE_ORG_UNITS
SUA_CREDIT_POINTS
ADV_STNDG_UNITS_CREDIT_POINTS
TOTAL_CREDIT_POINTS

Prerequisite (I/W) 2202

Must have passed number Credit Points with grade of at least schema.grade

MINIMUM_REQUIRED_CREDIT_POINTS
MINIMUM_REQUIRED_GRADE
ACHIEVED_CREDIT_POINTS

Prerequisite (I/W) 2197

Must have passed number Units in{ Unit,..}

MINIMUM_REQUIRED_NUMBER_OF_UNITS
SET_OF_SELECTABLE_UNITS
NUMBER_OF_FURTHER_UNITS_REQUIRED
ACTUAL_STUDENT_UNITS_SELECTED
REMAINDER_UNITS
SELECTABLE_UNITS_USED

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
MINIMUM_REQUIRED_CREDIT_POINTS
SET_OF_ALLOWABLE_LEVELS

System Wide (I/W) 2743

Level {Unit level,…} Units require number (I/W) pass(es) from Unit(s) from {Unit,..}

ACTUAL_NUMBER_OF_UNITS
ACTUAL_STUDENT_UNITS_SELECTED
SET_OF_VALID_UNITS
MINIMUM_REQUIRED_NUMBER_OF_UNITS
NUMBER_OF_ADDITIONAL_UNITS_REQUD
REMAINDER_UNITS
SET_OF_ALLOWABLE_LEVELS
VALID_UNITS_USED

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