Compatible SCORM versions

Teach on Mars applications are compatible with both SCORM version 1.2 and 2004 (1st, 2nd, 3rd and 4th editions). In order to know which version your content is based on, you can test your content on SCORM Cloud. Once you have added the content in your Library, you will be able to see the following abstract:

The Learning Standard line will tell you which version the content is based on. 

 

Upload in Mission Center

A SCORM content must be integrated as a web activity and you need to be extra careful as to how your SCORM package is built. The file imsmanifest.xml mus be placed at the root of the zip archive (and not in a containing folder). Otherwise the Mission Center will not recognize the content as as SCORM package.

 

Do not compress the whole folder

 

Compress the files inside the folder

 

The package that are exported from SCORM authoring tools are usually formatted correctly.

Note: be aware that the name of all the files inside the content - as well as the archive name - must not include spaces or any special characters, otherwise, it will be rejected by the Mission Center.

Special requirements

In order to be fully compatible with the Teach on Mars applications, a SCORM content requires a few more specifications which we will go over in this section.

Adaptive display

Requirement: responsive or adaptive display

The content will be browsed on multiple devices with different screen sizes. The content must be usable on both mobile phones and desktop browsers.

Most modern SCORM compatible authoring tools now produce responsive (or adaptive) content. You can consult our list of certified Authoring Tools.

Content display and navigation

Requirement: Exit button in the content

SCORM contents in a Teach on Mars application are displayed fullscreen, with no controls. Which means no control is provided to close the content on the Teach on Mars interface.

Most SCORM authoring tools provide a way to add an Exit  button in the content. Such a button is required in any SCORM content to be integrated in a Teach on Mars application.

 

Content weight

The training course that contains one or more SCORM contents cannot weigh more than 200 Mo. So be careful with the size of the media you're using in your content.

 

Content translations

In the 'Parameters' section, click on the 'Allow importing once file per language'. Back in the 'Content' section, select your second language (different than the default language). You can choose between :

• Using the same .zip file than the main language's one for this other language. Click on the 'Use the main language Zip file for this language'. 
• Using a different .zip file than the main language's one for this other language. Click on the 'Use a new Zip file for this language'. You can drop the new .zip file. 

Note: The size of the entire formation must not exceed 250MB for the publication to work, and this includes the sum of all the zip archives.

 

Tracking management 

In this section, we will cover which SCORM values are actually implemented in Teach on Mars, how they are stored in the Mission Center, and what you can expect to see in the export from the Mission Center.

A word about sessions

Tracking data in the Teach on Mars platform is recorded in sessions containing data like time spent, progress percentage, score, etc. These sessions are gathered and consolidated to be displayed in the analytics. 

Each time a SCORM Terminate() or LMSFinish() function is called, a session is sent to the Mission Center with the values that has been recorded using SetValue() or LMSSetValue(). Each session generates an attempt in SCORM language.

SCORM values

The Teach on Mars application automatically transforms SCORM values into values used into the Mission Center, so there is no need to adapt the SCORM values that are set in the content.

For more information on SCORM values format, you may browse this reference.

 

Configuration in the Mission Center

In the configuration tab of the web activity, you can notice an option This web activity sends score data (the activity will appear in the results report)

If this box is checked, the activity will appear in the Scored Activities report, and the score and success values will be featured in the Export by activity.

Score and success values sent by the SCORM content are always stored, but this option will activate the display of these values.

 

SCORM 1.2

For each SCORM value that the content sets, some values are set in the session that will be sent to the Mission Center. This table shows how each SCORM value affects the Teach on Mars sessions.

LMSSetValue	Value	Values set in Mission Center
cmi.core.session_time	type: Timespan	time: The time spent on the session is added to the time spent previously on the activity.
cmi.core.lesson_status	not attempted	No specific value is set
	browsed	No specific value is set
	incomplete	No specific value is set
	failed	progress: 100 success: false
	completed	progress: 100 success: true
	passed	progress: 100 success: true
cmi.core.lesson_location	String	Not available in the export, but value can be retrieve during another session.
cmi.suspend_data	Type: String	Not available in the export, but value can be retrieve during another session.
cmi.exit
cmi.core.score_min cmi.core.score_max cmi.core.score_raw		The score_raw value is used to set score score: value from 0 to 100
tom.data.session_points	Type: Integer (>= 0)	The points earned on the session is added to the points earned previously on the activity.

 

This table sums up the values the content can expect when calling LMSGetValue().

LMSGetValue	Value returned by SCORM function
cmi.core.total_time	Total time spent in previous sessions
cmi.core.lesson_mode	normal
cmi.core.entry
cmi.core.student_id	The learnerId of the current learner Ex: 265c3e6b-1fef-4945-807b-42aca5885365
cmi.core.student_name	The last name and first name of the current learner Ex: Doe, John
cmi.core.lesson_location	The last value recorded value by this learner on this activity.
cmi.suspend_data	The last value recorded value by this learner on this activity.
cmi.student_preference.language	The code of the language selected by the learner in the application.
cmi.core.score_min cmi.core.score_max cmi.core.score_raw	score_min: 0 score_max: 100 score_raw: the score as a percentage (0 to 100)
tom.data.total_points	Total points earned in previous sessions

 

SCORM 2004

For each SCORM value that the content sets, some values are set in the session that will be sent to the Mission Center. This table shows how each SCORM value affects the Teach on Mars sessions.

SetValue	Value	Values set in Mission Center
cmi.session_time	Timespan	time: The time spent on the session is added to the time spent previously on the activity.
cmi.success_status	unknown	No specific value is set in this case
	passed	progress: 100 success: true
	failed	progress: 100 success: false
cmi.completion_status	unknown	progress: 0
	not attempted	progress: 0
	incomplete	progress: 0
	completed	progress: 100
cmi.location		Not available in the export, but value can be retrieve during another session.
cmi.suspend_data		Not available in the export, but value can be retrieve during another session.
cmi.exit
cmi.score_min cmi.score_max cmi.score_raw cmi.score_scaled		score_scaled is used and transformed to a percentage. score: value from 0 to 100
cmi.progress_measure		progress: The value passed in the variable.
tom.data.session_points	Integer (>= 0)	The points earned on the session is added to the points earned previously on the activity.

 

This table sums up the values the content can expect when calling GetValue().

GetValue	Value returned by SCORM function
cmi.total_time	Total time spent in previous sessions
cmi.mode	normal
cmi.entry	Not implemented
cmi.learner_id	The learnerId of the current learner Ex: 265c3e6b-1fef-4945-807b-42aca5885365
cmi.learner_name	The last name and first name Ex: Doe, John
cmi.location	The returned value is the last value recorded value by this learner on this activity.
cmi.suspend_data	The returned value is the last value recorded value by this learner on this activity.
cmi.exit	Not implemented
cmi.progress_measure	The returned value is the max of the progress values recorded by this learner on this activity
cmi.success_status	If progress < 100: returned value is unknown If progress = 100:      and success = false: returned value is failed     and success = true: returned value is passed
cmi.completion_status	If progress = 0: returned value is not attempted If progress = 100: returned value is completed Otherwise: returned value is incomplete
cmi.learner_preference.language	The returned value is the code of the language selected by the learner in the application.
tom.data.total_points	Total points earned in previous sessions

 

Technical details

SCORM API discovery

Here's where the SCORM should expect to find the SCORM 1.2 and 2004 API objects. 

Platform	SCORM 1.2	SCORM 2004
Webapp	window.parent.API	window.parent.API_1484_11
iOS	window.API	window.API_1484_11
Android	window.API	window.API_1484_11

So, depending on the platform the content is played on, the API object will be accessible at a different place. You need to be aware of that when using an API discovery algorithm. For instance, some API discovery algorithms don't look for the API directly in the window object, and this may cause compatibility issues on the mobile platforms.

Commit behavior

The Commit() and LMSCommit() functions are not implemented in the Teach on Mars platform. To make sure that the data is recorded and sent to the Mission Center, a Terminate() (or LMSFinish()) is required.

Some content only make use of Commit and imply that the data will be saved without using Terminate. This is not currently the case in the Teach on Mars platform.