Skip to main content

Unistats record 2017/18 - How to use the HESA XML data entry tool

Back to C17061

Unistats record 2017/18 - How to use the HESA XML data entry tool

Version 1.0 Produced 2017-03-07

Contents: Downloading the tool | Running the tool | Creating an XML file | Navigating the display | Error validation | Updating the tool

Downloading the tool

The data entry tool can be downloaded here. This link will open the setup wizard. Follow the step-by-step instructions to download the tool on a local PC or network.

As the tool was developed using Microsoft's .Net Framework 4.5, HESA recommends using a machine with the minimum specifications published by Microsoft.

Please click here to view a guidance video for the XML data entry tool.

Error: Embedded data could not be displayed.

Running the tool

Double-click on the XML data entry tool icon located on your desktop, or alternatively select and open the file from its saved location on your PC.

You will be taken to the front page of the data entry tool:

InitialForm

From this page you can begin work on a new XML file, or you can go back to a saved XML file that you were previously working on by going to File > Open and selecting the appropriate file.

Creating an XML file

When creating a new file, codes are entered into free text box, or selected from the drop-down box next to the short name for that field.

FormWithMoreDetail

The question mark next to this will take you to the relevant page of the coding manual:

questionmark

To the right of this, the tool will indicate whether a a field is mandatory:

required

A cross next to a field indicates that an invalid entry has been made:

cross

The fields for the sub-entities of the entity being viewed (e.g. KISCourse and Location are sub-entities of the Institution entity in the KIS record) can be edited by clicking on the appropriate link. Extra sub entities can be added by clicking the "Add a new../another.." link:

addanew

Individual entities (e.g. a KISCourse or a Location) can be deleted by selecting them on the left-hand side of the tool and pressing the 'delete' button on your keyboard. A prompt will then ask for this action to be confirmed.

Once finished, the file can be saved by clicking File > Save.

Navigating the display

The tool will indicate whether or not all mandatory fields have been completed for the file in a summary at the top left of the screen. Where fields are missing it will report crosses:

invalid

Where fields have been completed with valid information, ticks will be displayed:

valid

Error validation

The kit is also able to pick up where schema errors are present in the data being collected. This will be highlighted in the bottom right of the tool:

schemaerrors

If this link is clicked on, the tool will display the detail of these errors:

schemaerrors2

Schema errors occur where there is a problem with the structure or order of the file, or an invalid character is included.

Further detail on XML can be found on the page Guidance and support with using XML.

Updating the tool

When you start the XML data entry tool it will automatically check the HESA server for updates to the schema, downloading these automatically where available. If the tool itself is updated, HESA will alert contacts, who will need to download the new version from the HESA website.


Need help?

Contact Liaison by email or on 01242 211144.