Support for HTML Delivery in SecureClient

About: This article will outline how to alter the settings in SecureClient so that it supports tests that are HTML compatible.

Important: THIS IS FOR TRIAL USE ONLY. Under no circumstances should the following changes be made if you are delivering live tests.



About HTML Delivery


HTML5 tests can now be run in both a web browser and SecureClient. You are only able to use this delivery method using tests that are compatible with HTML compatible items and that were built using the 'HTML Delivery' option in the Test Wizard or using tests with the 'Enable for HTML Delivery' checkbox selected in Test Creation.


HTML SecureClient
To allow HTML tests to run in SecureClient, the user will need to configure the application once it has been installed on a machine. See the instructions below on how to enact these changes.

Step 1: Locate the folder where SecureClient is installed.
This is the location in your C:\ drive where you defined that the SecureClient application should be stored during installation.

Step 2: Open the 'Surpass Secure Client. exe'
Next, you will need to open the CONFIG file in Notepad in administrator mode. The file name will either display as 'Surpass Secure Client.exe' or as 'Surpass Secure Client.exe.config' depending if Windows on your PC is configured to display file extensions.

When open, find the SERVER_ROOT key and replace the value (in bold below):
<add key="SERVER_ROOT" value="https://[name].surpass.com//secureassess//" />

Find UNIFIED_CLIENT_MODE key and replace the value (in bold below):
<add key="UNIFIED_CLIENT_MODE" value="0" />

Save the file.

Step 3: Open the 'SecureClientInitialRun.exe'
Then, open the 'SecureClientInitialRun.exe' in Notepad in administrator mode. The file name will either display as 'SecureClientInitialRun.exe' or as 'SecureClientInitialRun.exe.config', if extensions are visible.

When open, find LOCAL_URL and replicate the following:
<setting name="LOCAL_URL" serializeAs="String">
<value>https://[name].surpass.com/secureassess///secureassess.html</value>
</setting>

Step 4: Open the SecureClient shortcut properties
If you use a shortcut to open SecureClient from the desktop, right-click on the shortcut and select 'Properties'.

In the Properties window, navigate to the 'Shortcut' tab and in the 'Target' field, add "html" to the end of the text already populating that field.

Select 'Apply' and then 'OK'. You should now be able to run HTML5 tests in SecureClient.

Remember: This will alter the SecureClient installed on your PC to exclusively deliver HTML5 tests. To run Flash tests, you will need to revert the edits made or uninstall and then reinstall SecureClient.


Using the JAWS Screen Reader with HTML SecureClient


Although screen readers are not compatible with SecureClient, you can set up the HTML SecureClient so that it opens HTML web delivery, which allows the candidate to use a screen reader.

Step 1: Configure SecureClient
When configuring SecureClient for HTMl delivery (as above), you can add a parameter to the command line 'Launchbrowser', as in the example:

<<install dir>>\Surpass Secure Client.exe" isUpdaterLaunch masterconnection html localurl=http://<<localservername>>launchbrowserkeycode=[insertkeycodehere]

Step 2: Launch SecureClient
Now, when you launch SecureClient, it will bypass the keycode entry screen.
Instead, web delivery will open full-screen, so the candidate will not have access to any browser toolbars.

Note: The default browser on the candidate's device should be Internet Explorer to support the screen reader.

Step 3: During the Test
During the test, the candidate can use a screen reader and keyboard navigation.
When the candidate finishes the test and closes the browser window, SecureClient will automatically close.
For more information about accessibility, please see the 'Accessibility in Surpass' article.


Feedback and Knowledge Base