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.
Also, the file name of the archive 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.
Comments
0 comments
Please sign in to leave a comment.