About test profile settings

Test profiles allow you to customise the appearance of the Surpass test driver. This includes adding custom logos, defining colour schemes, and choosing what information and functionality is available to candidates during a test.

The Test Profiles screen is divided into seven areas:

  • Settings allows you to configure the basic settings of your test profile like name, test driver position, and test driver height.
  • Provider Logo allows you to upload a colour and a monochrome image of your chosen provider logo.
  • Client Logo allows you to upload a colour and a monochrome image of your organisation’s logo.
  • Delivery Presentation covers colour schemes including header and footer colours and additional HTML test driver options.
  • Candidate Details lets you configure what candidate details are displayed in the test driver, like name and date of birth.
  • Candidate Review allows you to configure what is displayed during a candidate review session.
  • Score Report lets you upload a score report which can be viewed by candidates after a test.

This article explains the available settings in the Test Profiles screen.

In this article

Finding the Test Profiles screen

To view the Test Profiles screen and configure test profile settings, navigate to Test Creation > Test Profiles.

Settings

Setting Description
Profile Name The test profile’s name.
Published Determines whether the test profile is available to be added to a test. For more information, read Applying a test profile to a test.
Delivery Engine Position

Determines the position of test content on candidates’ screens. The test driver’s position can be Left, Central, or Right.

TIP: It is recommended you set the delivery position to Left or Right if your test contains source material.
Delivery Engine Height

Allows you to set the height of test content on candidates’ screens. You can set the test driver’s height to fit the height of each candidate’s screen (Fit Height) or to only occupy a fixed position in the middle of the screen (Centre).

Manifest File

Allows you to upload a custom XML file to your test profile.

NOTE: For more information about manifest files, contact your Surpass Account Manager.
Supporting Information File

Allows you to upload a JSON file that can be retrieved from the TestProfile API resource.

EXAMPLE: If you are extracting information about a test session using the TestSession API, you might want to upload a file containing candidate check-in steps.
Time Remaining Alerts (HTML only)

Choose when to alert candidates of their remaining time in an HTML test. The default values are 30, 15, and 5 minutes. Enter new values into the Minutes fields to change the warning times.

You can have a minimum of one warning alert and a maximum of three warning alerts. To delete a warning alert, select Remove Warning . To add a warning alert, select Add Warning .

You can also select to Show alerts in front of all windows, such as when a candidate is viewing source material.

IMPORTANT: Time remaining alerts always display at 30, 15, and 5 minutes in legacy tests.

Provider Logo

Provider logos must meet the following requirements:

  • Resolution: 180 x 60px
  • File Type: PNG, JPEG, GIF (colour version), Transparent GIF (monochrome version)
  • File Size: 100 KB

Choose Select Image to upload a provider logo.

Client Logo

Client logos must meet the following requirements:

  • Resolution: 180 x 60px
  • File Type: PNG, JPEG, GIF (colour version), Transparent GIF (monochrome version)
  • File Size: 100 KB

Choose Select Image to upload a client logo.

Delivery Presentation

TIP: It is recommended you choose different background and text colours.

Header/Footer Colours

Setting Description
Background Colour Sets the colour of the areas at the top and bottom of the test driver. Use the colour picker to change the colour.
Text Colour Sets the text colour in the top and bottom areas of the test driver. Use the colour picker to change the colour.

 

Finish Button Colours

Setting Description
Background Colour Sets the colour of the Start Test and Finish Test buttons. Use the colour picker to change the colour.
Text Colour Sets the text colour in the Start Test and Finish Test buttons. This also changes the colour of the Agree to Terms window before the test begins. Use the colour picker to change the colour.

 

Primary Button Colours

Setting Description
Background Colour Sets the colour of OK, Confirm, Next, Back, Flag, and Introduction buttons and breadcrumbs for unattempted items. Use the colour picker to change the colour.
Text Colour Sets the text colour in OK, Confirm, Next, Back, Flag, and Introduction buttons and breadcrumbs for unattempted items. Use the colour picker to change the colour.

 

Secondary Button Colours

Setting Description
Background Colour Sets the colour of System Check and Preferences buttons on the keycode screen and breadcrumbs for attempted items. Use the colour picker to change the colour.
Text Colour Sets the colour of text in System Check and Preferences buttons on the keycode screen and breadcrumbs for attempted items. Use the colour picker to change the colour.

 

Header Options

IMPORTANT: These settings only apply to HTML tests.
Setting Description
Question Information Show or Hide question information in the test header.
Question Information Options

Toggle between item name (Name) and numerical question counter (Counter) in the test header.

NOTE: This setting requires Question Information to be set to Show.
Section Information Show or Hide section information in the test header.
Finish Test Button

Show or Hide the Finish Test button. If hidden, candidates must wait until the test timer expires.

NOTE: In untimed tests delivered in a web browser, the Finish Test button is only available on the final item.

 

Multiple Choice, Multiple Response, Either/Or Options

Setting Description
Checkboxes Show or Hide checkboxes in delivery for Multiple Choice, Multiple Response, and Either/Or items, and Multiple Choice and Multiple Response survey items.

Source Material Options

IMPORTANT: These settings only apply to HTML tests delivered in SecureClient.
Setting Description

HTML Browser Navigation

Enable or Disable browser navigation for HTML source material.

NOTE: If enabled, HTML source material has a home screen, forward and backward navigation, and refresh.

Close Docked Source Material

Enable or Disable the Close button in the Surpass PDF viewer.

NOTE: The Close button is only available in tests delivered in HTML SecureClient. For more information, read About the Surpass PDF Viewer.

Test Navigation Options

IMPORTANT: These settings only apply to HTML tests.
Setting Description
Section Tabs

Show or Hide section tabs.

NOTE: This only applies to tests with timed sections with standard navigation.
Item Set Numbering Enable or Disable item set grouping in navigation breadcrumbs. If enabled, items in an item set appear together in a decimal format.
Item Set Header

Show or Hide the item set header. This appears at the top of each item set to help candidates identify items within the set. If set to Show, you can configure the visible Item Set Label (for example, ‘Case study’) and Item Label (for example, ‘Scenario’).

NOTE: This setting requires Item Set Numbering to be enabled.

Footer Options

IMPORTANT: These settings only apply to HTML tests.
Setting Description
Introduction Button Show or Hide the Introduction button during a test. Introduction lets candidates return to the Introduction Page during a test.
Preferences Button

Show or Hide the Preferences  button during a test. Preferences lets candidates choose the text colour and colour scheme of the test.

Section Review Button Show or Hide the Section Review button. Section Review lets candidates view detailed information on the status of items.
Flag Button

Show or Hide the Flag button. Flag lets candidates highlight items that require further attention.

NOTE: The Flag button is unavailable in forward only tests.
Next Button Show or Hide the Next button on the last item in forward only tests.

Test Profile CSS

You can upload a CSS file to customise the appearance of HTML items in delivery. If you have uploaded a custom CSS file in Site Settings, you can select the file in the CSS File menu. For more information, read About Site Settings options.

Candidate Details

You can choose to display the following candidate details:

  • First Name
  • Last Name
  • Candidate Ref
  • Gender
  • Date of Birth

Use Select All to select all candidate details.

Candidate Review

WARNING: These settings are retired and have no impact on Candidate Review sessions.
Setting Description
Correct Items Show or Hide items that the candidate answered correctly.
Incorrect Items Show or Hide items that the candidate answered incorrectly.
Unattempted Items Show or Hide items that the candidate did not attempt.
Candidate’s Response Show or Hide the candidate’s response to an item.
Correct Answers Show or Hide the item’s correct answer.
Candidate Feedback Show or Hide candidate feedback.

Score Report

Select Upload to upload an HTML template for your custom score report. Select Download Sample HTML to download a sample HTML template.

NOTE: This setting only applies if Test Feedback options are not enabled in Test Form Details. For more information, read About test form settings.

Further reading