Top of STA | Index | Table of Contents | Feedback |
STAJ8050 - Create VET FEE-HELP Submission Snapshot - VET only
Purpose |
To identify and extract student records for inclusion in the VETStudent Loans Government Submission files. |
|
SubSystem |
Statistics |
|
Sector | VET | |
Normally Run By | Set to run as a standing request through the Job Scheduler, or may be requested by an Statistics specialist, as required. | |
Anticipated Frequency | Must be run once for each Government Submission but is likely to
be run a number of times for each submission in order to identify missing or
errant data. May be run to reproduce previous exception reports.
|
|
Structure | Block | Create VET Government Statistics Snapshot |
Tab | Parameters | |
Buttons | Create File |
This job identifies and extracts student records for inclusion in the VET Student Loans Government Submission files for government statistics reporting. The eligibility rules to determine whether a student/unit is eligible for VET FEE-HELP and is therefore reported, are as follows:
Note: If a student is not eligible then they may be ignored entirely by the reporting process and therefore not listed as an exception. The job may be run for one of the following at any one time:
For more information about the VET FEE-HELP Reporting process, see Understanding VET Statistics. The snapshot consists of data collected from throughout Callista and is stored in the following three snapshot tables based on whether the data is at a student, course or unit level:
Record Reporting Statuses: Each snapshot record has one of the following Reporting Statuses. Statuses for each record are maintained in Maintain VET FEE-HELP Snapshot (STAF8050).
For more information, see Record Reporting Statuses. An administrator can record a comment against the system log for each run of the snapshot job. EFTSL Calculation: The process also calculates EFTSL (Equivalent Full Time Study Load) for VET FEE-HELP reporting using contact hours (instead of credit points which are used for HE reporting). For more information, see EFTSL - Equivalent Full-Time Student Load. At an appropriate time after the Census Date, the snapshot is used to produce the VET FEE-HELP Government Submission File (STAJ8850). The following jobs in the VET FEE-HELP statistics process are run after running STAJ8050:
For more information on the statistics process and the various jobs and forms involved, see Understanding VET Statistics. This form is accessed through Statistics/VET Statistics Reports and Jobs from the main menu. |
The Create VET Enrolment Statistics Snapshot block contains: Parameters Tab
|
Rules/Notes: Previous Log Creation Date: Used for re-processing previously Excepted students and re-generating the log file. Other parameters are not required when this parameter is used. This option enables the administrator to avoid re-running the entire snapshot and instead run it only for previously excepted students. If further exceptions are created, a new error log is created. The Create File button is used to create an XML file of the selected log. The user is asked to save the file to their local file system. Submission Year: Specifiies the submission year. This field is mandatory unless a value is specified in the Previous Log Creation Date. If the function is run for an existing submission period, the system recognises existing records created previously for that submission period and updates them where necessary. System Submission Type: (Mandatory.) Specifies the type of submission for the specified Submission Year. e.g.
For VS-CMP_CRS and VS-CMP-UNT, the job must be run the year following the completion of the VS-RPT submission (for example, a 2010 VS-CMP_CRS file is created in 2011.) Data for the Unit Completions snapshots is extracted from the Reporting snapshots, so for VS-CMP-UNT Submissions, it is important that the Submission Start/End dates (entered into STAF1350) for VS-CMP-UNT Submissions coincide with those for the VS-RPT Submissions, for the same Reporting year. The type of submission will be controlled by the Submission Types specified in Maintain Government Snapshot Control form (STAF1350), along with parameters provided for the job. Submission Number: Specify a submission number to run the job for only those records with the specified submission number. This field is mandatory unless a value is specified in the Previous Log Creation Date. Run for RE-PROCESS Records: Select this checkbox to run the job only for records that have a Reporting Status of RE-PROCESS. This field is mandatory unless a value is specified in the Previous Log Creation Date or the Run for Previously Excepted Students check box is selected. Run for Previously Excepted Students: Used to run the snapshot only for students who created an error on a previous job run. Previous Log Creation Date: Used for re-processing previously Excepted students and re-generating the XML file. Exception Log Comment: Used to record a comment against the snapshot for later reference. The comment is also included in the Exception Log key for display in the List of Values for the Previous Log Creation Date parameter. The comments recorded in the Exception Log Comment field when creating a new submission, are viewable in the LOV for the Previous Log Creation Date field next to the relevant date. Validations:
A course can only be recorded in the snapshot if the course has a course category of GOVT-RPT. Reportable Course and Unit Code A Reference Code Type for Course and Unit Versions allows institutions to define a Reportable Code against a Course Version or a Unit Version. When creating the snapshot, this function captures the Reference Code (if it exists) as the Reportable Code. If no Reference Code of that type is recorded against a Course Version or a Unit Version, then the snapshot captures the 10 right-most characters of the Course or Unit Code. (for example, if no Reference Code exists for Course Code ABCDE123456 then it is captured as ABCDE123456 in the Course Code field of the snapshot, but is captured as BCDE123456 in the Reportable Course Code Field.) |
Exception Log: The Exception Log records details of students who could not be included in a particular Government Submission Snapshot. Messages are produced to Callista’s log files where appropriate. There are two types of messages:
When the snapshot process is run, an exception log is created in the tables, and a file is generated in the format specified by the log type. This file is able to be selected and created independently of the snapshot creation process. Parameters allow the administrator to re-run the snapshot only for students who created an error on a previous job run. The administrator can select from any existing log records that have been created for VET Submission or VET Course Completions, using the comments created at the time of submission as a guide. When run in this mode, the current submission parameters are not required. |
Rules/Notes: This job produces an Exception Log. When reprocessing for exceptions, the administrator is able to record a comment against the system log for each run of the snapshot job for later reference. Exceptions produced by the job can also be reported via GENJ1100 - Generate XML file from System Log.
|
The snapshot data is stored in the following three snapshot tables based on whether the data is at a student, course or unit level:
GOVT_SNAPSHOT_PE | Description: |
SUBMISSION_YR | The Submission Year, as four digits numeric. For example, 2005.Submission Year in STAF8050. |
SUBMISSION_NUMBER | The Submission Number, up to three digits numeric. For example, 401 or simply 1. Submission Number in STAF8050. |
S_SUBMISSION_TYPE | The type of submission.Submission Type in STAF8050. |
PERSON_ID | The Person ID of the student's enrolment or advanced standing. |
REPORTING_YR | The year for which the snapshot is being run and reported. |
BIRTH_DT | The date of birth of the student. |
SEX | Student's gender. |
TITLE | The student's title. |
SURNAME | The student's surname. |
GIVEN_NAME | The student's given name or first name. |
OTHER_NAMES | The student's middle or other names. |
ABORIG_TORRES_CD | The Aboriginal and Torres Strait Islander code that identifies the student as being of Aboriginial and/or Torres Strait Islander descent. |
GOVT_ABORIG_TORRES_CD | The government Aboriginal and Torres Strait Islander code |
CITIZENSHIP_CD | The student's citizen/resident code |
GOVT_CITIZENSHIP_CD | The government citizen/resident code |
HOME_LOCATION | The location of the student's permanent home residence |
GOVT_HOME_LOCATION | The Government Location code of the student's permanent home residence |
TERM_LOCATION | The location of the student's home residence during the term or semester |
GOVT_TERM_LOCATION | The Govt Location code of the student's home residence during the term or semester |
BIRTH_COUNTRY_CD | The Country of birth code for the student's country of birth. |
GOVT_BIRTH_COUNTRY_CD | The government country of birth code. |
YR_ARRIVAL | The year the student arrived in Australia if the student was born overseas. |
HOME_LANGUAGE_CD | The code for the language that the student speaks at home. |
GOVT_HOME_LANGUAGE_CD | The government language spoken at home code. |
GOVT_DISABILITY | The government disability code that relates to the student's disability if the student has a disability. |
COMMENCING LOCATION | Commencing location postcode of the student's permanent home residence |
COMMENCING_GEOGRAPHIC_LOCATION | The name of the commencing location of the student's permanent home residence |
HIGHEST_ATTAINMENT | The student's highest qualification |
POSTAL_ADDRESS_LINE_1 | The first line of the student's postal address |
POSTAL_ADDRESS_LINE_2 | The second line of the student's postal address |
POSTAL_ADDRESS_SUBURB | The suburb of the student's postal address |
POSTAL_ADDRESS_STATE | The state of the student's postal address |
POSTAL_ADDRESS_POSTCODE | The postcode of the student's postal address |
POSTAL_ADDRESS_COUNTRY | The country of the student's postal address |
RESIDENTIAL_ADDRESS_LINE_1 | The first line of the student's residential address |
RESIDENTIAL_ADDRESS_LINE_2 | The second line of the student's residential address |
RESIDENTIAL_ADDRESS_SUBURB | The suburb in which the student lives |
RESIDENTIAL_ADDRESS_STATE | The state in which the student lives |
RESIDENTIAL_ADDRESS_POSTCODE | The postcode of the suburb in which the student lives |
RESIDENTIAL_ADDRESS_COUNTRY | The country in which the student lives |
CHESSN | The student's CHESSN number |
S_REPORTING_STATUS | The record reporting status (specified for the snapshot record in STAF8050). |
UPDATE_WHO | The name of the user who last updated the record |
UPDATE_ON | The date and time the record was last updated |
COMMENCING_STUDENT_IND | The commencing student indicator (Note: This is used for internal purposes - it is not a government reporting element.) |
PERSON_USI | The Unique Student Identifier for the student. The Unique student identifier uniquely identifies an individual who accesses vocational education and training over his or her lifetime. A warning is generated when a student has an Exemption Person USI record (e.g. INTOFF, SHORT or INDIV) as these are not valid for the reporting of VET FEE-HELP Students to HEIMS. |
REVISION_TYPE | A value is generated in this field for records created in a Revision Submission Snapshot job (STAJ8055). The codes used are listed below. PC = Person and/or Course Level (excluding Course Commencement Date) changes CCD = Course Commencement Date change STD = SUA change (new, update, delete) Combinations can also be represented by listing the Revision Type Codes separated by a | symbol. e.g. PC|STD. For further information see STAJ8055. |
Each record in the GOVT_SNAPSHOT_SCA snapshot must have a unique combination of values for:
GOVT_SNAPSHOT_SCA | Description: |
SUBMISSION_YR | The submission year as four digits numeric. For example, 2005. Source is govt_snapshot_ctl.submission_yr |
SUBMISSION_NUMBER | The submission number up to three digits numeric. For example, 401 or simply 1. Source d from govt_snapshot_ctl.submission_num |
S_SUBMISSION_TYPE | The type of submission. From govt_snapshot_ctl.s_submission_typ |
PERSON_ID | The person ID of the student's enrolment or Advanced Standing. From student_course_attempt.person_id |
COURSE_CD | Course code. From the student course attempt. |
CRV_VERSION_NUMBER | The course version number. From student_course_attempt.version number |
REPORTING_YR | The reporting year. Derived from the unit census date: YEAR | submission. For example: 20101 – first 6 months of 2010 20102 – second half of 2010 (1 SCA record per unique reporting year – derived data as at the end date of the relevant submission.) |
REPORTED_COURSE_CD | The reportable course code for the reported course |
ATTENDANCE_TYPE | The student's type of attendance, for example, on-campus or distance education. |
GOVT_ATTENDANCE_TYPE | The government code for the student's type of attendance |
COMMENCEMENT_DT | The date the student commenced their course of study (i.e. Course Commencement Date.) |
BASIS_FOR_ADMISSION_TYPE | The basis for the student's admission to the course |
GOVT_BASIS_FOR_ADMISSION | Govt code mapped to the basis for admission above |
PRIOR_STUDIES_EXEMPTION | Cumulative total EFTSL value of Advanced Standing and RPL towards the total requirements of the course. This includes Contact Hours for RPL Units recorded in SUA. See ** below for more detail. |
EXEMPTION_INSTITUTION_CD | Major Exemption Institution field for the Advanced Standing in ADVF4200.For RPL units recorded in ENRF3000 this will be blank. |
GOVT_EXEMPTION_INSTITUTION | Govt code mapped to the Major Exemption Institution above. For RPL units recorded in ENRF3000 this will be 0000. |
GOVT_CREDIT_USED |
Cumulative total EFTSL value of Advanced Standing and RPL used towards the requirements of the course. This includes Contact Hours for RPL Units recorded in SUA. See ** below for more detail |
GOVT_CREDIT_BASIS | Government Credit Basis field value in ADMF4200. |
VTE_FIELD_OF_EDUCATION | VET Field of Education value in ADVF4200. |
VTE_LEVEL_DETAIL | VET Level Detail value in ADMF4200. |
GOVT_VTE_PROVIDER_TYPE | Government VET Provider field in ADMF4200. |
VARIATION_REASON_CD | Derived value for use in Revisions reporting |
STUDY_REASON_ID | The student course attempt study reason code Defaults to 99 if the the study reason identifier is not available. |
LABOUR_FORCE_STATUS_ID | The person's VET statistics government employment category |
CHESSN | The student's CHESSN number |
S_REPORTING_STATUS | The record reporting status (specified for the snapshot record in STAF8050) |
UPDATE_WHO | The name of the user who last updated the record. |
UPDATE_ON | The date and time the record was last updated. |
COMMENCING_STUDENT_IND | The commencing student indicator (Note: This is used for internal purposes - it is not a govt reporting element.) |
REVISION_TYPE | A value is generated in this field for records created in a Revision Submission Snapshot job (STAJ8055). The codes used are listed below. PC = Person and/or Course Level (excluding Course Commencement Date) changes CCD = Course Commencement Date change STD = SUA change (new, update, delete) Combinations can also be represented by listing the Revision Type Codes separated by a | symbol. e.g. PC|STD. For further information see STAJ8055. |
** PRIOR_STUDIES_EXEMPTION is the Credit Offered value (element 565) reported and GOVT_CREDIT_USED is the Credit Used value (element 560) reported. These values are determined by the following formula:
[(Successfully passed VFH RPL supervised contact hours + granted Credit Transfer supervised contact hours + granted RPL supervised contact hours) / ((Full time Completion / 10) * Course Contact Hours)] * 1000
Note that from 2015 onwards, VET reporting of data for these two elements is optional. VET providers may submit null values (spaces) instead of any of the listed codes. However, Callista’s clients have indicated that they would like the values reported. Whilst an error message will not be raised if either element is null, the calculation will occur on all students with VET FEE-HELP RPL, and Advanced Standing (including RPL).
Note also that it is assumed that student unit attempts granted RPL and being done under VET FEE-HELP, will be enrolled in ENRF3000 – Record Enrolments regardless of the tuition fees being charged.
The GOVT_SNAPSHOT_SUA table contains details on any unit of study undertaken by an eligible student (as defined above). Each record in the GOVT_SNAPSHOT_SUA must have a unique combination of values for:
GOVT_SNAPSHOT_SUA | Description: |
SUBMISSION_YR | Describes the submission year as four digits numeric. For example, 2005. Ffrom govt_snapshot_ctl.submission_yr |
SUBMISSION_NUMBER | Describes the submission number up to three digits numeric. For example, 401 or simply 1. From govt_snapshot_ctl.submission_num |
S_SUBMISSION_TYPE | Describes the type of submission. From govt_snapshot_ctl.s_submission_type. |
PERSON_ID | The Person ID of the student's enrolment or Advanced Standing. From student_unit_attempt.person_id |
COURSE_CD | From student_unit_attempt.course_cd |
CRV_VERSION_NUMBER | Course Version Number. From student_course_attempt.version_number |
UNIT_CD | Unit code. From student_unit_attempt.unit_cd |
UV_VERSION_NUMBER | Unit Version Number. From student_unit_attempt.version_number |
UNIT_CENSUS_DT | The Unit Census date |
TR_ORG_UNIT_CD | The training org. unit code. |
TR_ORG_UNIT_START_DT | The training org. unit start date. |
GOVT_ORG_UNIT_CD | Government organisation unit code. The default value 'aou' is used for VET FEE-HELP reporting. |
CAL_TYPE | Calendar Type for the teaching calendar in which the unit is offered. |
CI_SEQUENCE_NUMBER | Sequence number for this teaching calendar instance |
REPORTED_COURSE_CD | Reported Course Code.
If a Course Reference Code with a System Reference Code Type of RPT-CODE has been defined for the Course Version then that value is the Reported Course Code. Otherwise, if a Course Reference Code with a System Reference Code Type of QUAL has been defined for the Course Version, and is 10 characters or less in length, then this is the Reported Course Code. Otherwise, if the Course Version Course Code is 10 characters or less in length then this is the Reported Course Code. |
REPORTED_UNIT_CD | Reported Unit code.
If a Unit Reference Code with a System Reference Code Type of RPT-CODE has been defined for the Unit Version, then this value is used as the Reported Unit Code. Otherwise, if the Unit Version Unit Code is 10 characters or less in length, then this value is used as the Reported Unit Code. Otherwise, the 10 right-most characters of the Unit Version Unit Code is used as the Reported Unit Code. Note: If a Unit Offering Option exists with a Delivery Type that has the 'RPL VET FEE-HELP' indicator set to YES, then reverse the Unit code e.g. CU123 would be reported as 321UC) |
UNIT_OF_STUDY_CMPLTN_STATUS | Derived value determined by result. Withdrawn = 1, Failed = 2, Passed = 3, 4 = Not determined, 5 = Completed RPL Unit (i.e. Where the Unit Offering Option has a Delivery Type that has the ‘RPL VET FEE-HELP’ indicator selected). |
DISCIPLINE_GROUP_CD | Discipline group code for the unit. From unit_discipline.discipline_group_cd |
GOVT_DISCIPLINE_GROUP_CD | Government discipline group code. From discipline.govt_discipline_group_cd |
ATTENDANCE_MODE | If a unit offering option exists with a delivery type that has the ‘RPL VET FEE-HELP’ indicator selected, then the unit mode mapped to the unit class in CRSF2160 is used. |
GOVT_ATTENDANCE_MODE | Govt attendance mode to which the attendance mode above is mapped |
TOTAL_EFTSL | EFTSL Value derived from ENRK_PRC_LOAD_VET.ENRP_CLC_SUA_CH_EFTSL |
STUDENT_STATUS | Student Status. Derived NVL (student_unit_student_status_snapshot, student_unit_student_status, student_course_hecs_option.hecs_payment_option, hecs_payment_option) |
GOVT_STUDENT_STATUS | Government student status. Derived from hecs_payment_option.govt_hecs_payment_option of student status |
VARIATION_REASON_CD | Derived value |
NEW_RECORD_IND | New record ID. Determined in revisions processing. |
AUTHORISING_OFFICER_PERSON_ID | ID of the authorising officer. Only applicable to Revisions processing. |
CAMPUS_LOCATION | Campus location. Derived from unit mode. |
TOTAL_AMOUNT_CHARGED | Total amount charged derived by STAP_GET_AMT_PD_CHRGD_LN_FEE |
AMOUNT_PAID_UPFRONT | Amount paid up-front derived by STAP_GET_AMT_PD_CHRGD_LN_FEE |
LOAN_FEE | Derived value. See STAP_GET_AMT_PD_CHRGD_LN_FEE |
UNIT_OF_STUDY_HELP_DEBT | Unit of study fee help debt amount. |
CHESSN | The student's CHESSN number. |
S_REPORTING_STATUS | The record reporting status (specified for the snapshot record in STAF8050). |
UPDATE_WHO | The name of the user who last updated the record. |
UPDATE_ON | The date and time the record was last updated. |
PRIOR_LEARNING_RECOGNITION_CD | If a Unit Offering Option exists with a Delivery Type that has the ‘RPL VET FEE-HELP’ seleced, then set to ‘1 – Unit of study consists wholly of RPL’. |
REVISION_TYPE | A value is generated in this field for records created in a Revision Submission Snapshot job (STAJ8055). The codes used are listed below. PC = Person and/or Course Level (excluding Course Commencement Date) changes CCD = Course Commencement Date change STD = SUA change (new, update, delete) Combinations can also be represented by listing the Revision Type Codes separated by a | symbol. e.g. PC|STD. For further information see STAJ8055. |
Last Modified on 11-Jan-2018 3:43 PM
History Information
Release Information | Project | Change to Document |
19.1.0.3 & 20.0.0.2 | 2235 - Calipso 43694 | Added note re Submission Start/End dates (in STAF1350) for VS-CMP-UNT Submissions. |
19.0.0.3, 19.1.0.3 & 20.0.0.2 | 2262 - Compliance - VET FEE-HELP Course Revisions | Added the REVISION_TYPE field to each of the snapshot tables. |
19.0.0.3, 19.1.0.3 & 20.0.0.2 | 2173 - Compliance INDIV USI Exceptions | Added new validation for Students with INTOFF or SHORT validations. |
18.0.0.3, 18.1.0.3 & 19.0.0.1 | 2173 - Compliance AVETMISS 7 | Added information about new values that can be recorded for the Unique Student Identifier for exempt students. |
17.0.0.3, 17.1.0.3 & 18.0.0.1 | 2090 - PC 396 | Added info for PRIOR_STUDIES_EXEMPTION and GOVT_CREDIT_USED in the GOVT_SNAPSHOT_SCA. |
17.0.0.3, 17.1.0.2 & 18.0.0.1 | 2062 - USI | Added PERSON_USI to GOVT_SNAPSHOT_PE. |
17.0.0.2 | 1953 - VET RPL | Multiple updates to snapshot table information |
14.0.0.3, 15.0.0.3, 15.1.0.2, 16.0 | 1842 - Calipso 35716 | Additional note for DIISRTE VET Unit Completions. |
13.1 | 1323 - Online Help consolidation | Added VET label. Updated links. |
12.1.0.3 | 1708 - Compliance 2011 | Added note relating to STUDY_REASON_ID field. |
12.0.0.3 | 1646 - Skills VIC Fee-Help Reporting | New page |