The SCORM/AICC module is a course activity which allows you to upload any SCORM or AICC package to your course.
Unenrolled users and site admins are excluded from the activity level SCORM report however they will be included in the SCORM report source when using Report Builder.
What is SCORM?
SCORM (Sharable Content Object Reference Model) is a collection of specifications that enable interoperability, accessibility and reusability of web-based learning content. SCORM content can be delivered to learners via any SCORM compliant Learning Management System (LMS) using the same version of SCORM.
SCORM definition from Wikipedia.
Using SCORM in Totara
Totara Learn fully supports the AICC and SCORM 1.2 specifications. It also supports the SCORM 2004 specification, with the exception of these extensions:
- Content Aggregation Model
- The Run-Time Environment
- Sequencing and Navigation
SCORM 2004 packages that do not use these extensions should function correctly in Totara Learn.
- When you notice there is a problem displaying characters correctly, it could be a misconfiguration of your server. Make sure that both httpd.conf (when using Apache) and php.ini are set to DefaultCharacterset = utf8 or switch the sending of a default character set off.
- A SCORM package must contains in the root of the ZIP a file named imsmanifest.xml that defines the SCORM course structure.
Totara Learn can't create SCORM packages - the SCORM module is simply for deploying SCORM packages.
Creating a SCORM Activity
- Click Turn editing on.
- Click SCORM from the Add an activity menu.
- Enter an activity name, this appears on the course page for learners.
- Enter an activity summary.
- Click Choose or upload file.
- Select the zipped SCORM package (click upload file upload the package into the files area if not already done) by clicking Choose.
- Set the SCORM/AICC Settings (see below to learn more).
- Set the Activity completion settings if required.
- Click Save and return to course or Save and display.
Alternatively, once you are happy with the default settings for SCORM packages in your course, you can instead drag and drop the zipped SCORM package directly into the course (providing editing is turned on).
Next, select Add a SCORM package from the dialogue box and select Upload. Once you have uploaded your SCORM package you can still edit the settings as normal.
Updating SCORM packages
There may be times when you need to update a SCORM package but need to retain the completion data and current learners' progress. For example, you may have updated text in an elearning module without adding new content. In order to retain this data, you need to ensure that the new SCORM package's IMS manifest file has the same item identifier as the current SCORM package.
If you need to update a SCORM package that is used in multiple courses, it is useful to turn on auto-updating. You can do this by following these steps:
- Within the required course, Turn editing on.
- Select SCORM from the Add an activity menu.
- Enter a name and description.
- Select the Add button () and select the repository containing your SCORM files.
- Select the zipped SCORM file.
- Select the Create an alias/shortcut to the file radio button, then Select this file.
- Set the Auto-update frequency setting.
- Select Save and display.
Now the SCORM activity will automatically check the selected repository (depending on the Auto-update frequency you selected) and update the activity with the latest ZIP file.
If you use the automatic update method described above, you still need to check that the current and new SCORM packages have the same item identifier in their IMS manifest files. If the new package has a different number, regardless of whether you update the SCORM automatically or manually, you will lose your completion and progress data.
When using the single activity course format a number of SCORM activity options (for example the Learner skip content structure page setting) will not be available.
|Name||The name of the SCORM activity as it will appear on the course page. It should be concise and descriptive.||-|
|Description||A description of the SCORM activity, this is a good place to include any instructions and to give a brief summary of the purpose of the activity.||-|
|Display description on course page||If enabled, the description above will be displayed on the course page just below the link to the activity or resource.||-|
This is where you will need to upload the SCORM package file, either by dragging and dropping it into the upload area or by clicking the upload icon () and browsing for the file.
This allows the external package to be automatically downloaded and updated:
In Current or New window, we recommend using the New window option to avoid learners closing the site when they may just want to close the SCORM.
|Width||Stage size width in either percent or pixels. To use a percentage you will need to put a percentage sign (%) after the number, e.g. 80%.||Might be only viewable if you click Show more.|
|Height||Stage size height in either percent or pixels. To use a percentage you will need to put a percentage sign (%) after the number, e.g. 50%.||Might be only viewable if you click Show more.|
|Options||There are a series of check boxes for; Allow the window to be scrolled, Show the directory links, Show the location bar, Show the menu bar, Show the toolbar, and Status.||Might be only viewable if you click Show more.|
|Display activity name||Whether or not to display the activity name above the SCORM player.||Might be only viewable if you click Show more.|
|Learner skip content structure page||Choose from; Never, first access, and always.||Might be only viewable if you click Show more.|
|Disable preview mode||If this option is set to Yes, the Preview button in the view page of a SCORM/AICC Package activity will be hidden. The learner can choose to preview (browse mode) the activity or attempt it in the normal mode.|
When a Learning Object is completed in preview (browse) mode, it's marked with browsed icon.
Might be only viewable if you click Show more.
|Display course structure on entry page||How the table of contents is displayed in the SCORM player.||Might be only viewable if you click Show more.|
|Display course structure in player||How the table of contents is displayed in the SCORM player||Might be only viewable if you click Show more.|
|Hide navigation buttons||Hide or display the buttons to go to content in the SCORM.||Might be only viewable if you click Show more.|
This setting specifies whether to show or hide the navigation buttons and their position.
There are three options:
|Might be only viewable if you click Show more.|
|From left||If you choose Floating as the Show navigation option you can then set how many pixels from the left you wish for it to be displayed.||Might be only viewable if you click Show more.|
|From right||If you choose Floating as the Show navigation option you can then set how many pixels from the right you wish for it to be displayed.||Might be only viewable if you click Show more.|
|Display attempt Status||This preference allows a summary of the users attempts to show in the course overview block in My home and/or the SCORM entry page.|
Even when a SCORM package is completed, there can be a message that reads, You have SCORM packages that need attention on the My Learning page. This message is displayed by default for the course it's related to and the SCORM entry page. You can turn it off by editing the SCORM package and changing the option Display attempt status to No or Entry page only. This is currently expected behaviour.
|Available from||You can set a date and time that the SCORM activity will be available from. You will need to check the Enable box to use this.||-|
|Available to||You can set a date and time that the SCORM activity will be available until. You will need to check the Enable box to use this.||-|
|Grading method||Learning Objects: This mode shows the number of completed/passed Learning Objects for the activity. The max value is the number of Package's Learning Objects.|
If your SCORM package does report cmi.core.lesson_status, and does not report cmi.core.score.raw, then you should use this setting.
|Highest grade: The grade page will display the highest score obtained by users in all passed Learning Objects.|
If your SCORM package does report cmi.core.score.raw, and does not report cmi.core.lesson_status, then you should use this setting, Average grade, or Sum grade.
|Average grade: If you choose this mode Totara will calculate the average of all scores.||-|
|Sum grade: With this mode all the scores will be added.||-|
|Maximum grade||Allows you to set the maximum grade available for this SCORM activity.||-|
|Number of attempts|
This defines the number of attempts permitted to users. It works only with SCORM 1.2 and AICC packages. SCORM2004 has its own max attempts definition.
|The option to start a new attempt is provided by a checkbox above the Enter button on the content structure page, so be sure you're providing access to that page if you want to allow more than one attempt. An attempt is not complete until the cmi.core.lesson_status for the attempt is set to either completed or passed. After that, the Start new attempt checkbox is available to the learner.|
When you permit multiple attempts for learners, you can choose how to record the result in gradebook by first, last, average, or highest settings.
|Force new attempt|
If Yes, hides the Start new attempt checkbox and prevents review mode.
If No then SCORM allows a learner to return to the same attempt at any point and a new attempt is not possible unless the previous attempt has been set as; completed, passed, or failed. If the SCORM package does not do this, the learner will always re-enter the same attempt.
An attempt is not complete until the cmi.core.lesson_status for the attempt is set to either completed or passed. After that, the Start new attempt checkbox is available to the learner.
|Lock after final attempt|
When set to Yes this prevents the learner from running the SCORM lesson once they have used all all their allowed attempts.
An attempt is only considered finished if the SCORM package has a cmi.core.lesson_status of passed, failed, or completed.
|If enabled, the status of the current attempt is forced to completed.||Only applicable to SCORM 1.2 packages.|
|Auto-continue||If Auto-continue is set to Yes, when a Learning Object calls the close communication method, the next available Learning Object is launched automatically. If it is set to No, the users must use the Continue button to go on.||Auto-Continue will only move from one SCORM to the next in the same topic.|
|Auto-commit||If enabled, SCORM data is automatically saved to the database. Useful for SCORM objects which do not save their data regularly.||-|
|Mastery score overrides status||If enabled and a mastery score is provided, then when Finish is called and if a raw score has been determined, then status will be recalculated using the raw score and mastery score, and any status provided by the SCORM (including incomplete) will be overridden.||Only applicable to SCORM 1.2 packages.|
Common module settings
See Common Module Settings to learn more.
Most of these setting are standard, for these please see Activity completion to learn more.
However, listed below are some additional setting options for SCORM activities.
|Require minimum score|
Enabling this setting will require a user to have at least the minimum score entered to be marked complete in this SCORM activity, as well as any other Activity Completion requirements.
|Require status||Checking one or more statuses will require a user to achieve at least one of the checked statuses in order to be marked complete in this SCORM activity, as well as any other Activity Completion requirements.||-|
|Require all scos to return completion status||Some SCORM packages contain multiple components or 'scos'. When this is enabled all scos within the package must return the relevant lesson_status for this activity to be flagged complete.|
Limiting access to SCORM files
From Totara v11.8+ it is now possible to limit the viewing and launching of SCORM files using capabilities. The capabilities mod/scorm:launch and mod/scorm:view allow you to decide which roles can launch and/or view SCORM activities.
See Restrict Access to learn more.
See Tags to learn more.
Once learners have started to take the SCORM activity you will be able to see reports on the usage of the package by clicking the Reports tab.
There are four different reports to view:
- Basic report: Shows how many attempts each user has made, when they first and most recently accessed the activity.
- Graph report: Shows a bar chart of number of users and the percentage secured (how far they have gotten in their attempt).
- Interactions report: Allows you to see a summary of learners attempts along with questions, responses (given by the learner), right answers, and results.
- Objectives report: If a SCORM package is set up to report course objectives then they will be reported on here.
All reports (except the Graph report) can be filtered and exported to either ODS, Excel or text format.
As a site administrator you can set default values for the SCORM activity settings and also configure admin settings. This can be done under Site administration > Plugins > Activity modules > SCORM package.
Alongside configuring preferred default settings you can define the following admin settings:
Disabling this setting allows Totara to store more data than the SCORM 1.2 specification allows. If your SCORM packages allow users to enter large amounts of text or if your package tries to store large amounts of data in the suspend_data field disable this.
You can choose to add an externally hosted SCORM package, either via URL.
|You will still see the file picker option as well.|
If enabled this allows a direct URL to a simple AICC package.
If enabled this allows AICC HACP external communication without requiring user login for post requests from the external AICC package.
Length of time in minutes that an external AICC HACP session can remain open.
Length of time in days to keep the external AICC HACP session data (a high setting will fill up the table with old data but may be useful when debugging).
The AICC standard for usernames is very restrictive compared with Totara, and allows for alphanumeric characters, dash and underscore only. Periods, spaces and the @ symbol are not permitted. If enabled, user ID numbers are passed to the AICC package instead of usernames.
|Set a mask for the debug, so that the debug log only appears under certain conditions. For example, you can use a simple regex on <username>:<activityname> e.g. admin:.* will debug for admin user only.||-|
If enabled, SCORM packages can be downloaded only if the user has the course:manageactivities capability. If disabled, SCORM packages can always be downloaded (by mobile or other means).