Java Applet - NHS e-Referral Service

This method is no longer a supported route to access NHS e-Referral Service (e-RS), it is a legacy option. The NHS Credential Management software is quicker and easier to install and users are recommended to move across to this method for future e-RS use.

The following errors could be reported for the Java Applet mechanism within the e-RS.

The 'Java is not enabled' error indicates that Java Runtime Environment (JRE) has not been installed on the user's computer.

Java is not required to use e-RS unless the organisation has adopted the Java Applet alternative configuration.

The 'The Java Applet is not enabled' error indicates that a Java Runtime Environment (JRE) has not been installed on the user's computer, or the Java Applet has not been successfully loaded into the browser.

This message may occur if the JRE security configuration is preventing the Java Applet from running, or if the user does not accept or cancels a JRE dialog.

For example, the first time the Java Applet runs, the dialog below will be shown asking the user's permission to run the Java Applet. If the dialog is closed or cancelled at this point, the message will be displayed.

This dialog box will be shown every time the Java Applet is loaded unless the user selects the ‘Do Not Show Again’ checkbox. 

Another possible cause of this message is that the GATicket.jar file is not present on the computer.

This can occur when the JRE is updated or installed after the original installation of the Identity Agent. For further information on how to check and fix this issue please see the 'Troubleshooting' section in the Administration Guide included in the installation files (HSCN access required to access this link).

The Java Applet is designed to run with the default JRE settings. This guidance does not cover the advanced settings organisations may be using on their computers which could prevent the Java Applet from loading.

If this message is displayed - and is not explained by the reasons above - use the debug capabilities of the Java Console along with the Java Console application to determine which security setting is preventing the Java Applet from running.

The 'The Java Applet is loaded but cannot login to e-RS' error indicates that the Java Applet is running correctly but an error has occurred whilst attempting to check whether the Identity Agent has already logged in the user.

This may occur if:

• the Identity Agent is not running
• the user did not in fact login to the Identity Agent before starting the test
• the user logged out of the Identity Agent before completing the test
• the Identity Agent login was unsuccessful

For guidance on dealing with authentication issues with the Identity Agent please see the 'Troubleshooting' section in the Administration Guide included in the installation files (HSCN access required to access this link).

If the above reasons have been eliminated, then you can get further assistance by calling the National Service Desk on 0300 3035035 or raising a call using the National Service Desk tool.