adapt-contrib-assessment's Introduction

adapt-contrib-assessment

A basic assessment for the Adapt Framework which attaches to an 'article' object to group various question components (such as adapt-contrib-mcq, adapt-contrib-textInput and adapt-contrib-matching) and provide a score with feedback.

A sample JSON is given below which can be added to a single article block:

"_assessment": {
    "_isPercentageBased" : true,
    "_scoreToPass" : 60,
    "_completionMessage" : {
        "title" : "You have finished the assessment",
        "message": "You have scored [SCORE] out of [MAXSCORE].  [FEEDBACK]"
    },
    "_bands": [
        {
            "_score": 0,
            "feedback": "You must try harder"
        },
        {
            "_score": 25,
            "feedback": "I think you can do better than this"
        },
        {
            "_score": 50,
            "feedback": "Good effort, you're getting there..."
        },
        {
            "_score": 75,
            "feedback": "Excellent!"
        }
    ]
}

A description of attributes is as follows:

Attribute	Type	Description
_isPercentageBased	bool	Set this to true if the assessment should work on percentages, or false for otherwise
_scoreToPass	int	This is the 'pass' mark for the assessment. If _isPercentageBased is set to true this will be a percentage, e.g. 60 would equal 60%
_completionMessage	object	An object containing title and message string values. Note that message can contain the following placeholders: [SCORE], [MAXSCORE] and [FEEDBACK]
_bands	object array	An array of objects whose purpose is to define the score banding. The attributes required for each object are _score and feedback