Restore assessment state - adaptlearning/adapt-contrib-assessment GitHub Wiki

If a course is connected to an LMS and Spoor is enabled, Adapt can restore the learner's answers in assessments. See below how this can be achieved.

Prerequisites

• adapt-contrib-spoor must be installed and enabled.

• The course must be connected to an LMS.

Note: The developer may test this behaviour without an LMS. To do so, launch the course with the command grunt server-scorm. This will run the course using scorm_test_harness.html instead of index.html. Question and assessment state will be stored in a browser cookie.

Usage

Configuration

In config.json in the settings for _spoor, set _shouldStoreResponses to true.
Example snippet:

"_spoor": {
	"_isEnabled": true,
	"_tracking": {
		"_requireCourseCompleted": true,
		"_requireAssessmentPassed": true,
		"_shouldSubmitScore": false,
		"_shouldStoreResponses": true,
		"_shouldRecordInteractions": true
	},

In articles.json in your configuration of _assessment, set _isResetOnRevisit to false.
Example snippet:

"_assessment": {
    "_isEnabled":true,
    "_id": "Assessment 1",
    "_banks": {
        "_isEnabled": true,
        "_split": "2,1",
        "_randomisation": false
   },
   "_assessmentWeight": 1,
   "_isResetOnRevisit": false,

Behaviour

With the above settings, the behaviour of Assessment is as follows:

• Exit the course without completing the assessment. Upon return, answers that have been submitted are restored so that the learner's progress in the assessment is not lost.

• Exit the course with a completed but failed assessment. Upon return, the assessment is always reset (if further attempts are still available).

• Exit the course with a completed and passed assessment. Upon return, the assessment is restored with the learner's answers.