Staff record 2018/19 - Validation Overview
Version 1.0 Produced 2018-11-12
HESA has developed extensive quality assurance procedures and runs a range of validation checks against all submissions. The nature of some of these checks changes with the move to XML. This document describes the validation checks and the stages at which they take place.
XML files must be encoded with UTF-8 if they contain characters beyond the standard ASCII character set. Higher education providers (HEPs) are advised to specify the encoding used in their XML files (i.e. <?xml version="1.0" encoding="UTF-8" ?>) and to ensure that their files are actually saved with that encoding. Files with an explicit encoding declaration other than UTF-8 will be rejected. Files with undeclared encoding will be assumed to be UTF-8. If encoding is not specified or does not match the actual file encoding, HEPs are warned that there is a risk that data contained in the files may be changed on submission to HESA.
Business stage validation (previously INSERT-stage validation) are checks on the structure and logic of an individual submission. There are two types of validation checks carried out at business stage:
Checks that the XML is 'well formed' and that it conforms to the rules of the schema definition (the XSD files)
Business stage quality rules
A set of rules to check the business logic of the submission.
Note that business stage quality rules can only be carried out when all structural errors (schema checks) have been resolved.
HESA provide a downloadable validation kit to assist providers in the preparation of their data. The validation kit provides some basic structural and 'sense' checks prior to data submission with the aim of reducing the number of errors encountered when submitting data to the data collection system. The validation kit performs the two different types of business stage validation.
Business stage quality rules can be switched off when running data through the validation kit, both locally and at HESA. Schema checks can never be switched off.
A further stage of validation will run when data is submitted to the data collection system. Exception stage validation (previously COMMIT-stage validation) includes quality rules that require comparisons with data across an entire return and/or against reference data held at HESA. These checks cannot be run within the validation kit for this reason.
A validation kit is available for download as an MSI installation file. To install the software you simply need to run the MSI file on a Windows PC. If you do not have access to a Windows PC, please contact Liaison ([email protected]) for further instructions.
When the validation program is opened it automatically checks the HESA web server for the latest set of rules and updates the package if appropriate.
A quick start guide is included in the application.
The kit utilises the Microsoft .NET framework. This is likely to already be installed on many computers as it is required by much of Microsoft's own software. You can download the .Net framework from Microsoft's website.
Contact Liaison by email or on +44 (0)1242 388 531.