Kiosk Control {SKIOSK-4}

This option is used in the Student iEnabler and Kiosk Subsystems. If a student uses the Student iEnabler or KIOSK Sub-system, a check will be done to verify if the student is registered for a qualification in any of the calendar years as specified in block 3 "Student Registered". It is very important to remember that although a subject’s marks are indicated here as being available between certain dates, as in block 1 "Exam Marks", the "suppress" function in {SMNT-2} System Control Cycle - Exams will be affected by the validation 'KS' on {SMNT-1}.

If validation 'KS' is switched on, the exam results will be suppressed, as indicated on {SMNT-2b2} for cycle 'E', irrespective of the start and end dates on block 1 of {SKIOSK-4}.
If validation 'KS' is switched off, the program uses only the start and end dates on block 1 of {SKIOSK-4} to determine whether to suppress exam results or not.

The "suppress" function for the Academic Record checks only against {SMNT-2b2} for cycle 'E'.

Block 1: Kiosk Control: Exam Marks

The start and end dates for availability of marks might differ between subjects. Each subject will therefore have a record in this option. {SKIOSK-5} will create a default record for each subject in this option.

Field	Type & Length	Description
Exam Year	YYYY	The examination year.
Exam Month	N2	The <LIST> function will display all allowed values.
Offering Type	N2	The Offering Type for which the record is valid.
Faculty	N4	The <LIST> function will display all allowed values.
Department	N4	The <LIST> function will display all values allowed.
Subject Code	A7	The subject code.
Start Date	DD-MON-YYYY	The day on which the results will become available for this subject on the Examination Result application, as well as the Academic Record.
End Date	DD-MON-YYYY	The last day that the results will be available for this subject on the Examination Result application, as well as the Academic Record.

Example:

Block 2: Kiosk Control: Timetable

The examination timetable for a specific month and exam code can be made available as soon as it is finalised.

Field	Type & Length	Description
Exam Year	YYYY	The examination year.
Exam Code	N2	The examination Code.
Start Date	DD-MON-YYYY	The first day on which the timetable can be displayed.
End Date	DD-MON-YYYY	The last day on which the timetable can be displayed.

Example:

Block 3: Kiosk Control: Student Registered

This is the year in which the students are registered. A student is allowed to use the Kiosk Sub-system if his / her registration year is the same as specified in the table below.

Field	Type & Length	Description
Exam Year	YYYY	The registration year

Example:

Block 4: IVR / SMS File Transfers

This block is used for the generation of IVR and / or SMS files. The format of the files will differ. SMS files are .Rsms and IVR files are .Rtxt files.

When "SMS / IVR Facility for Results?" is:

'S' - Only SMS (.Rsms) Results should be generated, if "Published date" is before today's date then generate with 100 times "xxxxx <help desk number>", IVR (.Rtxt) file should be generate with 100 times "xxxxx <help desk number>".
'I' - Only IVR (.Rtxt) Results should be generated, if "Published date is before today's date, then generate with 100 times "xxxxx <help desk number>", SMS (.Rsms) file should be generate with 100 times "xxxxx <help desk number>".
'B' - SMS (.Rsms) and IVR (.Rtxt) Results should be generated, if "Published date is before today's date then generate both files with 100 times "xxxxx <help desk number>".
'N' - generate both Result files (.Rtxt)(.Rsms) with 100 times "xxxxx <help desk number>".

When "SMS / IVR Facility for Balance?" is:

'S' - Only SMS (.Bsms) Balances should be printed, if "Generate Balance File" = 'N' generate file with 100 times "xxxxx <help desk number>", IVR (.Btxt) file should be generate with 100 times "xxxxx <help desk number>".
'I' - Only IVR (.Btxt) Balances should be printed, if "Generate Balance File" = 'N' generate file with 100 times "xxxxx <help desk number>", SMS (.Bsms) file should be generate with 100 times "xxxxx <help desk number>".
'B' - SMS (.Bsms) and IVR (.Btxt) Balances should be printed, if "Generate Balance File" = 'N' generate both files with 100 times "xxxxx <help desk number>".
'N' - generate both Balance files (.Btxt)(.Bsms) with 100 times "xxxxx <help desk number>".

Field	Type & Length	Description
Exam Year	YYYY	The examination year.
Exam Month	N2	The examination month.
Start Publishing Date	DD-MON-YYYY	The date from which student information will be available.
End Publishing Date	DD-MON-YYYY	The date up until which the Student information will be available.
SMS / IVR Facility for Results	A1	Will SMS / IVR facility for results be used? ((S)MS / (I)VR / (B)oth / (N)o).
Generate Balance File	DD-MON-YYYY	Should Result Code File be Generated? (N)o, (A)ll, (D)ebit or (C)redit.
SMS / IVR Facility for Balances	A1	Will SMS / IVR facility for balances be used? ((S)MS / (I)VR / (B)oth / (N)o).
Help Desk Phone Numbers for Results	A15	Enter the Telephone Number.
Help Desk Phone Number for Balances	A15	Enter the Telephone Number.
Request Pin Number for Results	A1	Should a Pin be used to obtain Results?
Request Pin Number for Balances	A1	Should a Pin be used to obtain Balances?

Example:

A comma-delimited file will be sent to the Cell Phone Service Provider and will consist of the following:

Field	Field Length	Type
Student Number	N9	This field will always be 9 digits. Some student numbers will be 7 digits.
Subject Code	A7	These vary from institution to institution in format, but will always be alphanumeric. This field is to be read out to the caller.
Result	N3	This will be expressed as a percentage.
Result Code	A2	Each institution will have its own codes. Each code will have a description. The description will be read out per subject.
Re-examination date	N8	Year, month and day. e.g. 20000625 = 10 June 2000. This field is only read out if it contains data. If not ignored.
Year / Month of Exam	N6	Year and month of the exam written e.g. 200006 "June exam 2000". This must be as part of the result introduction: "Your results for the June 2000 exam.
Institution Code	N4	This is a numeric field that contains a unique number per tertiary institution.
Exception Code	N4	If there is an exception code the following will be read to the caller (only one record will be created), except code 993 which will be per subject. 990 - "Results withheld due to Financial reasons" - (FW action code). 991 - "Results withheld due to Administration reasons"- (PW action code). 992 - "Results withheld due to Library reasons" (LW action code). 993 - "Result not available".
Pin Code (if required)	A4	If a pin code exists the student will be required to enter this pin code before any results are read. Otherwise, 'NPNP" ignored. If the pin code is 'XXX' - message should be: - "pin code is required, please contact the following number < results help desk number >.
Date File Created	N8	This will be the date on which the file was created and sent to Vodacom. The following will be read out to the caller: "Your exam results as on 30 June 2000", if the date was 20000630.
Telephone Number of Help Desk	N15	This will be the number that the student can call if he / she has any queries about his / her results. The following will be read out to the caller at the end of all the results: "If you have any queries, please contact the following number < help desk number > ".

The following Examination detail will be read out to the student:

Detail	Description
Subject	Only the subject code.
Percentage	The % achieved for the subject - final mark.
Result Code	This depends on the Result Code set up by the user. The full description will be read out. e.g. "PD" will be read out as "Pass with Distinction". The codes will only be recorded once before the results are published.
Re-Exam Date	If the student has to write a supplementary, the date of the exam will be read out.
Exception Code	If the Exception Code is present, the results will not be published.
Telephone Number	Only the subject code.

The following Financial details will be read out to the student:

Field	Field Length	Type
Institution Code	N4	This is a numeric field that contains a unique number per tertiary institution.
Student Number	N9	This field will always be 9 digits. Some student numbers will be 7 digits.
Balance	N11.2	The total balance for the student. No currency will be read.
Pin Code (if required)	A4	If the pin code exists, the student will be required to enter this pin code before any results are read. Otherwise, 'NPNP" ignored. If the pin code is 'XXX' message should be: "pin code is required, please contact the following number < results help desk number >.
Date File Created	N8	This will be the date the file was created and sent to Vodacom. The following will be read out to the caller: "Your balance on 30 June 2000." if the date of the call is 30 June 2000.
Telephone Number of Help Desk	N15	This will be the number that the student can call if he / she has any queries about his / her balance. The following will be read out to the caller at the end of all the balances: "If you have any queries, please contact the following number < help desk number > ".

Date	System Version	By Whom	Job	Description
30-Jul-2007	v01.0.0.0	Magda van der Westhuizen	T137175	New manual format.
14-Nov-2007	v01.0.0.0	Melanie Zeelie	T137175	New detail regarding IVR files.
13-May-2008	v01.0.0.0	Melanie Zeelie	T150047	New detail regarding IVR / SMS files.
17-Nov-2008	v01.0.0.0	Magda van der Westhuizen	T151713	Update manual: Language Editing: Juliet Gillies.
25-Apr-2013	v02.0.0.0	Amanda van Emmenis	T190360	Update manual with validation 'KS', from F151513.
29-Apr-2013	v02.0.0.1	Amanda van Emmenis	T189813	Update manual. Fix spelling errors.
06-Dec-2016	v04.0.0.0	Dimakatso Mampuru	T217314	Add new Image for block 2 (Time Table).
17-Feb-2023	v04.1.0.0	Elmarie Roos	T258535	Replace forms images with ADF images
12-Feb-2024	v04.1.0.1	Sarah Seeletse	T262208	Update images