issue/2747 Added questionModel attemptStates API

[olivermartinfoster]

#2747

To keep the previous question attempt states for use in plugins.

Requires #192 spoor pr to be saved and restored across sessions.

Added

• trackableType property throughout to list the type of the trackable attributes
• questionModel.getAttemptState Returns the raw state of the component in a format for spoor to store
• questionModel.getAttemptObject Returns a formatted state object which can be passed through to questionModel.set
• questionModel.setAttemptObject Sets the current state of the component from a state object
• questionModel.addAttemptObject Adds an attempt object to the attemptStates store
• questionModel.getAttemptObjects Returns an array of the component attempt state objects
• _spoor._tracking._shouldStoreAttempts to config.json
• Question completion automatically adds a state object to the attempt state store

Testing

• Add component 'c-60' mcq _isResetOnRevisit: "soft"
• Keep attempting 'c-60'
• Use the console to determine mcq attempts

var Adapt = require('core/js/adapt');
Adapt.findById('c-60').getAttemptObjects();

• To see states restored across sessions use spoor pr #192
• And enable _spoor._tracking._shouldStoreResponses and _spoor._tracking._shouldStoreAttempts in config.json

[cahirodoherty-learningpool]

👀

[tomgreenfield]

As discussed, should be quite easy to also store incomplete question attempts by listening to a change of _isSubmitted.

[oliverfoster]

I realised that the _userAnswers wasn't getting stored because the view is attached to change:_isSubmitted after the model and so the model would have to wait for the view to finish before saving the state. I've instead added a QuestionModel.prototype.onSubmitted function to complement the QuestionView.prototype.onSubmitted function called at the end of QuestionView.prototype.onSubmitClicked.

[cahirodoherty-learningpool]

👀

[moloko]

code 👓

[oliverfoster]

@tomgreenfield if you could re-review this one is ready to go in

Complete

[tomgreenfield]

🎈