Select Unit Sets

Select Unit Sets

This section includes:

Introduction
Application Data
Examples of Screen Shots
Field Details
Tooltips
Validations
Cohort Process Window Restriction

Introduction

This function allows a student to select one or more unit sets that may be added to their enrolment. The student can select a unit set/s from a list of non enrolled unit sets. The selection/s will be returned to the Unit Set Maintenance function and the student will then add them to their enrolment. This function is accessed from Student Unit Attempt Enrolment (SUSA-ENR).

Select Unit Set

The Select Unit Set function includes a search facility that assists in refining the list of Non Enrolled Course Offering Unit Sets. Search parameters include unit set code (wild cards allowed), unit set title (wild cards allowed) and unit set category. The unit set code and title are text fields and the unit set category is a drop-down list.

Contents of the unit set category drop-down list of values is determined by the relevant Course Offering Unit Sets and the unit set categories that are available for self-enrolment. Categories that aren’t available but which are used for course offering unit set records that have a unit set self serve enrolment available value of ‘Available’, are also included in the list.

The option to ‘Select’ a particular unit set only appears next to unit sets that are available to the student to enrol in. Unit sets that are displayed without the 'Add' option are:

Unit Sets that require authorisation
Unit Sets that are restricted to one or more Course Offering Options of the student’s course but which the student is not enrolled in
Unit Sets from which the student is excluded due to an encumbrance.

Unit Set Superiors

This page is accessed via the Select Unit Set page when a Unit Set has Superiors.

Add Parent Unit Set

Unit Sets that are subordinates require a parent unit set. This function allows for a parent unit set to be selected. This functionality is accessed via Student Unit Set Attempt Enrolment (SUSA-ENR).

The Select Unit Set function includes the option of inquiring on possible parents (i.e. superior unit sets) for each subordinate unit set. The list includes any unit sets that are superior; both eligible and ineligible.

Application Data

Table or View Name	Alias	Comments	Data Diagram
Student_ Course_ Attempt	SCA	.	ENR - STUDENT COURSE ATTEMPT
Student_ Unit_Set_Attempt	SUSA	.	CRS-ENR - UNIT SETS
CRS_OFF_ UNIT_SET_ RELATIONSHIP	COUSR	.	CRS-ENR - UNIT SETS
Course_Offering_Unit_Set	COUS	.	CRS-ENR - UNIT SETS
course_version	CRV	.	CRS- COURSE VERSION
unit_set	US	.	CRS-ENR - UNIT SETS
unit_set_cat	USC	.	CRS-ENR - UNIT SETS
UNIT_SET_COURSE_TYPE	USCT	.	CRS-ENR - UNIT SETS
Course_ Offering	CO	.	CRS- COURSE OFFERING OPTION
SUSA_ENR_CACHE_ITEM	SUSAECI	New Table – the latest actions and changes done by the student	SSF – STUDENT UNIT SET ATTEMPT ENR
SSF_SEARCH	SSFS	New Table – identifies the latest Search Data	SSF – STUDENT UNIT SET ATTEMPT ENR
SSF_SEARCH_RESULTS	SSFSR	New Table – holds the latest Search data	SSF – STUDENT UNIT SET ATTEMPT ENR

Examples of Screen Shots

Select Unit Set Search Area

Select Unit Set Search Results

Unit Set Superiors

Add Parent Unit Set

Field Details

Prompt	Field Source	Field Type	Data Type, Length and Format Mask	Default	Comments
Unit Set Code	US.UNIT_SET_CD	Input Field	VARCHAR(10)	%	Mandatory. This field will have the asterisk functionality. This field may contain ‘%’ but cannot be left NULL.
Unit Set Title	enrp_get_us_title	Input Field	VARCHAR(90)	%	Mandatory. This field will have the asterisk functionality. This field may contain ‘%’ but cannot be left NULL. N.B. The view obtains the title from enrp_get_us_title
Unit Set Category	US.UNIT_SET_CAT	Input Field with lookup	VARCHAR(10)	‘ALL’	Select: usc.unit_set_cat From: unit_set_cat usc Where: usc.avail_self_enr_ind = ‘Y’ and there is a COUS of the same category (for the context course attempt crs version) set to AVAILABLE or DEFAULT, then show the category Union Select: usc.unit_set_cat From: unit_set_cat usc Where: usc.avail_self_enr_ind = 'N' and there is a COUS of the same category set to AVAILABLE (for the context course attempt crs version), then show the category ORDER BY 1 asc
Search	.	Button	. .	.	When the 'Search' button is pressed the Search area will be hidden and the search results will be displayed
Unit Set Code	US.UNIT_SET_CD	Display Field	VARCHAR(10)	null	.
Version	US.VERSION_NUMBER	Display Field	NUMBER(3)	null	.
Title	US.TITLE or COUS.OVERRIDE_TITLE	Display Field	VARCHAR(90)	null	N.B. The title is obtained from enrp_get_us_title
Category	US.UNIT_SET_CAT	Display Field	VARCHAR(10)	null	.
Status	SUSAECI_PARENT_V.SUSA_STATUS	Tooltip	VARCHAR(22)	null	The status is derived in the view. If the Unit Set is not available for Self Enrolment then the Status will be “NOT AVAILABLE’. If the Unit Set is available for Self Enrolment then the Status will determine what is displayed. If the Status is ‘CONFIRM’ then ‘MARKED FOR ENROLMENT’, if ‘REINSTATE’ then ‘MARKED FOR REINSTATEMENT’, if ‘REMOVE’ then ‘MARKED FOR REMOVAL’, if ‘END’ then ‘MARKED FOR END’, otherwise it will be ‘SELECTED FOR ENROLMENT’ This is a hover tooltip. This means that the tooltip displays when the mouse moves over the status link and disappears again when the mouse moves away from the link. The tooltip text should be hard-coded into the template. The text to be displayed is located in a table below that provides the Description for the Status.
Add	.	Checkbox	VARCHAR(1)	‘N’	.
Unavailable	.	Popup	.	.	This is a link is a Tooltip. The student can click on the tooltip to display the reason why the tooltip is unavailable and must press the close box to close the Tooltip window. It is displayed in the 'Add' column when the Unit Set is not available to be added.
Display Superior(s)	.	Button	.	.	The button is displayed once for each Unit Set that has superiors. If this button is pressed then US-SELECT is called again in context of the Unit Set to display the Unit Sets Superiors. Sufficient parameters should also be passed so that when the 'Back' button is pressed in 'Unit Set Superiors', the state of the search results returns to that of the previous page (the Select Unit Set Search Results display again).
Prev	.	Link	.	.	.
1, etc.	.	Link	.	.	.
Next	.	Link	.	.	.
Add	.	Button	.	.	This button performs a DoSubmit to SUSA-ENR. The Unit Sets that have had the 'Add' checkbox checked on the current screen will be passed as parameters. Other Unit Sets that have had the 'Add' checkbox checked on different screens will have had their statuses updated in the SSF_SEARCH_RESULTS table and SUSA-ENR will obtain those by passing the SSF_SEARCH_RESULTS.SSFS_SEQUENCE_NUMBER.
New Search	.	Button	.	.	Displayed after initial search
Cancel	.	Button	.	.	The cancel button from the Select Unit Set search screen or the Add Parent Unit Set screen returns control to SUSA-ENR. The cancel button from the Select Unit Set search results screen deletes existing SSF_SEARCH_RESULTS records and returns control to the Select Unit Set search area.

Tooltips

Tooltips should be available for the Status and the Unavailable link. Clients wish to have the option to be able to customise the Tooltip text. The Status comes from the cursor but the Tooltip text that corresponds to that Status is specified in the template so that clients can customise the text.

The Status Tooltips should not have a close option (cross in the top corner), the Status Tooltips appear when the user hovers their mouse over the link and disappear when the mouse moves away from the link.

However, the Unavailable Tooltips will have the close option. These are ‘sticky’ tooltips that the student must click to display the tooltip and click the close box to hide the Tooltip.

The following table provides the default definition for each of the Statuses. These statuses should be put in a Javascript array. Clients can then have the ability to change the definition in the array if they so wish.

Status	Definition
NOT ENROLLED	Not enrolled in Unit Set or the unit set has not been selected for enrolment through ‘Select Unit Set’
ENDED	Unit Set has been ended and no action has been selected
UNCONFIRMED	Unit Set is currently unconfirmed and no action has been selected
COMPLETED	Unit Set has been completed
ENROLLED	Unit Set is currently enrolled
SELECTED FOR ENROLMENT	Unit Set has been selected for enrolment through ‘Select Unit Set’
MARKED FOR REINSTATEMENT	Unit Set has been ended but the Reinstatement action has been selected
MARKED FOR ENDING	Unit Set is currently enrolled but the End action has been selected
MARKED FOR ENROLMENT	Unit Set is currently unconfirmed but the Confirm action has been selected
MARKED FOR REMOVAL	Unit Set has the Remove action selected
NOT AVAILABLE	The Unit Set has been ended, but not voluntarily, or, The Unit Set is unconfirmed and cannot be confirmed via this facility because authorisation is required or the Unit Set is not available for Self Management and as a result can not be selected as a parent Unit Set.

Validations

Validations include:

Display an error message if any of the mandatory search fields are blank
Display an error if the Maximum Selection Number or Maximum Display Selection Number have not been specified
Display an error if more than one Unit Set is selected to be added in the ‘Add Parent Unit Set’ screen
If the student selects one or more Unit Sets and then presses the “New Search” button without having pressed the “Add” button then a message should warn the student that they have not yet added the Unit Sets.

Cohort Process Window Restrictions

System Process Type	SUSA-ENR
System Process Type Description	STUDENT UNIT SET ATTEMPT ENROLMENT PROCESS
System Calendar Category	USERDEF
Rule Call Code	COHORT-SCA
Restriction Type	Access Restriction
Comments	This restriction is being created as part of SUSA-ENR and should be used for US-SELECT also. If no Cohort is defined, then students will still be able to enter application. When coming through Enrolment Steps, and a valid SUSA-ENR Cohort Process Window does not exist, then do not show any actions or allow any updating. However, students should be able to view the Unit Sets. When coming through Standalone mode, and a valid SUSA-ENR Cohort Process Window does not exist, then do not allow the student into the application.

Last Modified on 21 December, 2005