Progression Validation functions (i8bpkg)

This package contains functions that are available as standard for use in the Progression Validation process (PRGV).

Validation functions are linked to progression validation rules that are defined in {SSTUDP-10}.

One function can be used for more than 1 validation rule where different parameter values are apply.

The functions are executed in the progression validation program {SSTUDP-12}.

Validation rules may have parameters that can be used to link particular values for that parameter. These values are compared with the student’s value.

The logic that will determine the outcome of a rule is 'hard coded' into the function.

A new rule can be defined and an existing function linked to the rule with different values for the different parameters.

If a new function is linked to a new rule, users must remember that the logic for the rule must be programmed before the rule can be applied in the application validation process.

Validations have four possible outcomes. An outcome of ‘D’ or ‘N’ will result in a ‘failed’ rule outcome.

Not applicable (A). This means that the rule does not apply to the particular student scenario.
Data Problem (D). The function expects parameter values but it does not exist. Users must define the parameter values before the progression stage rule can be excuted.
Not successful (N). The student did not comply with the requirements of the rule.
Successful (Y). The student complies with all the requirements of the rule.

The definition of Passed credits is as follows:

Subjects linked to the Qualification of the same Approved qualification
Qualification and Subject registration is not cancelled
Subject is Passed or Exempted
Attend only Subjects are excluded
Each subject is counted only once

The Validation rules are processed as follows:

Each functions first performs a check to determine if the parameters used have values defined for parameters where it expects values.
When the progression validation process starts, a result record is created for each active validation.
The validaton results and detail for each failed rule can be viewed for a student with {SSTUDP-13}.

Function Name/ Rule/ Detail displayed	Procedure	Rule Set up
VALIDATION_MAIN_FUNCTION	The function manages the processing of all active progression validations rules as defined in {SSTUDP-10} and linked to active stage of PRGV process in {SSTUDP-11}. It performs the following actions for each rule: It will process the function linked to the student. The linked function will use the user entered values for the parameters of each rule to evaluate the student for the rule. The outcome of each rule evaluated and associated detail is displayed in {SSTUDP-13}	{SSTUDP-10} Define Progression Validation Rules {SSTUDP-11} Link Progression Validation Rules
CHECK_SP_CREDITS Rule Z500 Credit Type Subject Credits Obtained	Does the student have enough passed registration credits for the Offering type, study period combination? If the Subject Credits Obtained for the student has at least the Minimum Registration Credits of Type of Credits for the Qualification, Offering type and study period combination on Registration. If true, set Result Success to Not successful (N) if not true, set Result Success to Successful (Y)	{SSTUDP-10} Type of Credits 1-Stats {SACADO-17} Credit 2-National {SACADO-10} National Credit 3 {SACADO-10} Internal Credit {SACADO-5} Minimum Registration Credits
CHECK_NUM_SUBJECTS_SP Rule Z501 Number of subject passed	Does student have enough passed subject? if the student passed at least Number of Subjects to Pass. If true, set Result Success to Not successful (N) if not true, set Result Success to Successful (Y)	{SSTUDD-2} Number of Subjects to Pass

History of Changes

Date	System Version	By Whom	Job	Description
07-Jul-2020	v04.1.0.0	Rofhiwa Nemauluma	T243997	New Manual
28-Jun-2022	v04.1.0.1	Rofhiwa Nemauluma	T254589	Expand on existing manual