Jump to navigation

Class: SCORMStorage

Numbas.storage.SCORMStorage

SCORM storage object - controls saving and loading of data from the LMS.

Constructor

new SCORMStorage()

Source:

Members

exam :Numbas.Exam

Reference to the Numbas.Exam object for the current exam.

Type:
Source:

lmsConnected :boolean

Indicates whether a true SCORM connection to an LMS exists.

Type:
Source:

mode

Mode the session started in:

  • ab-initio - starting a new attempt;
  • resume - loaded attempt in progress.
Source:

partIndices :Object.<number>

Dictionary mapping Numbas.parts.partpath ids to cmi.interaction indices.

Type:
Source:

questionIndices :Object.<number>

Dictionary mapping question ids (of the form qN) to cmi.objective indices.

Type:
Source:

suspendData :Numbas.storage.exam_suspend_data

The last cmi.suspend_data object.

Type:
Source:

Methods

adviceDisplayed(question)

Record that the student displayed question advice.

Parameters:
Name Type Description
question Numbas.Question
Source:

answerRevealed(question)

Record that the student revealed the answers to a question.

Parameters:
Name Type Description
question Numbas.Question
Source:

changeQuestion(question)

Call this when the student moves to a different question.

Parameters:
Name Type Description
question Numbas.Question
Source:

end()

Call this when the exam ends.

Source:
See:

get(key) → {string}

Get a SCORM data model element.

Parameters:
Name Type Description
key string

Element name. This is prepended with cmi..
Returns:
Type Description
string
  • The value of the element.
Source:

getDurationExtension() → {object}

Get an externally-set extension to the exam duration.

Returns:
Type Description
object
Source:

getEntry() → {string}

Get entry state: ab-initio, or resume.

Returns:
Type Description
string
Source:

getMode() → {string}

Get viewing mode:

  • browse - see exam info, not questions;
  • normal - sit exam;
  • review - look at completed exam.
Returns:
Type Description
string
Source:

getPartId(part) → {string}

Make an id string corresponding to a part, of the form qNpXgYsZ.

Parameters:
Name Type Description
part Numbas.parts.Part
Returns:
Type Description
string
Source:

getQuestionId(question) → {string}

Make an id string corresponding to a question, of the form qN, where N is the question's number.

Parameters:
Name Type Description
question Numbas.Question
Returns:
Type Description
string
Source:

getStudentID() → {string}

Get the student's ID.

Returns:
Type Description
string
Source:

getSuspendData() → {Numbas.storage.exam_suspend_data}

Get the suspend data from the SCORM data model.

Returns:
Type Description
Numbas.storage.exam_suspend_data
Source:

get_initial_seed() → {string}

Get the initial seed value.

Returns:
Type Description
string
Source:

get_student_name()

Load student's name and ID.

Source:

init(exam)

Initialise the SCORM data model and this storage object.

Parameters:
Name Type Description
exam Numbas.Exam
Source:

initPart(p)

Initialise a part - make an interaction for it, and set up correct responses.

Parameters:
Name Type Description
p Numbas.parts.Part
Source:

initQuestion(q)

Initialise a question - make an objective for it, and initialise all its parts.

Parameters:
Name Type Description
q Numbas.Question
Source:

load(exam) → {Numbas.storage.exam_suspend_data}

Get suspended exam info.

Parameters:
Name Type Description
exam Numbas.Exam
Returns:
Type Description
Numbas.storage.exam_suspend_data
Source:

loadPart(part) → {Numbas.storage.part_suspend_data}

Get suspended info for a part.

Parameters:
Name Type Description
part Numbas.parts.Part
Returns:
Type Description
Numbas.storage.part_suspend_data
Source:

loadQuestion(question) → {Numbas.storage.question_suspend_data}

Get suspended info for a question.

Parameters:
Name Type Description
question Numbas.Question
Returns:
Type Description
Numbas.storage.question_suspend_data
Source:

partAnswered(part)

Call this when a part is answered.

Parameters:
Name Type Description
part Numbas.parts.Part
Source:

partPath(part) → {string}

The 'interactions.N.' prefix for the given part's datamodel elements.

Parameters:
Name Type Description
part Numbas.parts.Part
Returns:
Type Description
string
Source:

pause()

Call this when the exam is paused.

Source:
See:

questionSubmitted(question)

Record that a question has been submitted.

Parameters:
Name Type Description
question Numbas.Question
Source:

resume()

Call this when the exam is resumed.

Source:
See:

reviewModeAllowed() → {boolean}

Is review mode allowed?

Returns:
Type Description
boolean
Source:

save()

Save SCORM data - call the SCORM commit method to make sure the data model is saved to the server.

Source:

saveExam(exam)

Save exam-level details.

Parameters:
Name Type Description
exam Numbas.Exam
Source:

saveQuestion(question)

Save details about a question - save score and success status.

Parameters:
Name Type Description
question Numbas.Question
Source:

set(key, value) → {boolean}

Set a SCORM data model element.

Parameters:
Name Type Description
key string

Element name. This is prepended with cmi..
value string

Element value.
Returns:
Type Description
boolean
  • Did the call succeed?
Source:

setSessionTime()

Record duration of the current session.

Source:

setSuspendData()

Save the exam suspend data using the cmi.suspend_data string.

Source:

start()

Call this when the exam is started (when Numbas.Exam#begin runs, not when the page loads).

Source:

stepsHidden(part)

Record that the student hid the steps for a part.

Parameters:
Name Type Description
part Numbas.parts.Part
Source:

stepsShown(part)

Record that the student showed the steps for a part.

Parameters:
Name Type Description
part Numbas.parts.Part
Source:

storeStagedAnswer(part)

Save the staged answer for a part. Note: this is not part of the SCORM standard, so can't rely on this being saved.

Parameters:
Name Type Description
part Numbas.parts.Part
Source: