Packaging test forms

WARNING: This article refers to an area of Surpass that uses Flash, which is no longer supported by web browsers. Use the Surpass Viewer to view this area of Surpass. For more information, read Installing the Surpass Viewer.

A packaged test form is a ZIP file containing all the files that make up a test, which can be uploaded to a website in order to host the test on the website. Additionally, SCORM (Flash only) packages can be used in a Virtual Learning Environment (VLE).

You can use packaged test forms to view the test as the candidate would, for quality review purposes, or to view candidate responses. A packaged test can be hosted on websites so that candidates can access a practice test ahead of an exam session, allowing them to familiarise themselves with the Surpass test driver.

NOTE: Contact your system administrator for assistance in packaging and hosting a test.

This article explains how to package and host a test form.

1. Go to the Test Forms screen

Navigate to the Test Creation tab and then select Test Forms.

TIP: For more information about Test Forms, read About the Test Forms screen.

2. Select Package Test Form

Select the test form you want to package in the Test Forms grid, then select Package Test Form.

3. Choose a package format

Choose the package format you want to export in the menu.

Format	Description
Stand-alone	Produces a packaged test that functions independently without the need to be plugged into any other software. You can run the test by running the contained HTML file.
SCORM 1.2 (Flash only)	Produces a package compliant with the SCORM 1.2 format that can be plugged into a VLE (such as Moodle) that supports this version of SCORM.
SCORM 2004 (Flash only)	Produces a package compliant with the SCORM 2004 format, that can be plugged into a VLE (such as Moodle) that supports this version of SCORM.

Select OK to create the package.

4. Download and extract the package

When the package has been created, select Download to save the ZIP file to your device.

Extract all files from the downloaded ZIP file. Right-click on the ZIP file and select Extract All.

Specify where you want to save the files and select Extract.

5. Access your File Transfer Protocol (FTP)

Access your FTP server. FTP servers allow files to be transferred to other computers via the internet.

Enter your server details into your chosen FTP and select connect. Once successfully connected, the files and folders that make up your website are visible.

NOTE: The server details normally include: protocol, host, username, and password.

Downloading Filezilla

TIP: There are multiple FTP servers available to use. Filezilla is an open source and free to download FTP.

6. Identify the root folder

Identify your root folder, this is the top-most directory of the website. Your packaged test can be in the root folder or any subdirectory of the root folder. The root folder aligns with your website’s URL.

Contact your website system administrator for further assistance in locating the root folder.

EXAMPLE:

help.surpass.com – this is the root directory, derived from the root folder.
help.surpass.com/one – one is a subdirectory derived from a subfolder within the root folder, named ‘one’.
help.surpass.com/one/two – two is a further subdirectory derived from a subfolder within the subfolder ‘one’, named ‘two’.

7. Upload extracted files via FTP

In the FTP client, create a new folder within the root folder. Name the folder suitably as this forms part of your test’s URL. For this example, our folder is named ‘package-test-sample’.

Open your extracted packaged test form (for more information, read ‘Download and extract the package’). This shows various files and folders. Move these files into your new folder. This process may vary dependent on the FTP being used.

TIP: Filezilla lets you click and drag the folders from Windows File Explorer into Filezilla.

8. Launch the packaged test

Your packaged test is now live. The launch_html_delivery file is the final part of the URL for your packaged test.

The URL to view your packaged test is: [your main website URL]/[subdirectory folder name]/launch_html_delivery.html

There is no limit to the amount of times the test can be taken.

EXAMPLE: You can access our sample packaged test here: https://help.surpass.com/package-test-sample/launch_html_delivery.html.

Limitations of packaged test forms

There are some limitations to the features supported in packaged test forms:

No item-level information (such as user responses) is stored in the data model or communicated back to the Surpass server.
Packaged tests cannot be resumed if exited while in progress.

NOTE: To enable end of test summary feedback in packaged test forms, speak to your Surpass Customer Success Manager.

IMPORTANT: If the test is a legacy (Flash) test, the website the packaged test is hosted on needs to be whitelisted on the Surpass Viewer. The test can then only be accessed via the Surpass Viewer. Contact support@surpass.com with your new hosted test URL.

About SCORM tests (Flash only)

IMPORTANT: If hosting a SCORM packaged test on a VLE, the VLE’s URL needs to be whitelisted on the Surpass Viewer. Contact support@surpass.com with your new hosted URL. The test can then only be accessed in the Surpass Viewer. For more information, read Installing the Surpass Viewer.

SCORM tests produce packages compliant with the 1.2 or 2004 formats. These can be plugged into a VLE (such as Moodle) which supports the appropriate version of SCORM.

The data model of SCORM tests packaged from Test Creation supports a limited subset of calls.

NAME	Data model: SCORM 1.2	Data model: SCORM 2004	Notes
Student Name	cmi.learner_name	cmi.core.student_name	Picked up at the start of the test for display purposes in the user interface.
Minimum Score	cmi.score.min	cmi.core.score.min	Always set to `0` when starting the course.
Maximum Score	cmi.score.max	cmi.core.score.max	Set to the maximum score at the start of the test.
User Score	cmi.score.raw	cmi.core.score.raw	Set to the user’s score at the end of the test.
Status	cmi.success_status	cmi.core.lesson_status	Sets whether the user has passed or failed the test at the end of the test (supports ‘passed’ & ‘failed’ only).