MoodleDocs - Wkład użytkownika [pl]

SCORM FAQ

2013-01-31T15:35:49Z

Aegroshek: /* Zlib warning when I add/update SCORM objects in my course */

{{SCORM}}
==What is SCORM?==

SCORM was developed as a result of collaboration in the public and private sectors. The President of the United States, Bill Clinton issued an Executive Order that created an agency (ADL) to oversee the standard for developing and distributing online learning. All Federal agencies are mandated to use programs that meet those standards. SCORM is one result of that order.

There's a really simple "What is SCORM" introduction here: http://moodle.org/mod/forum/discuss.php?d=3757#p18828

A slightly more detailed introduction here: http://www.rusticisoftware.com/resources/whatisscorm/What%20Is%20SCORM.ht

==Should I make my Moodle courses as SCORM or use Moodle's features?==
It depends how you intend to use it. If you are planning on exporting and using in another LMS then SCORM would make this easier. If you want something shiny, then a SCORM package can fit the bill. However, reporting and grading work better in Moodle and for many educators the standard features do the job perfectly and do not require learning a new program. There is a useful form post discussing the pros and cons of SCORM in Moodle here: http://moodle.org/mod/forum/discuss.php?d=200242

==SCORM Information==

Advanced Distributed Learning (ADL) is the organization that wrote the SCORM standard. You can download documentation and samples form ADL's Web site. Documentation for SCORM 1.2 in several languages is available [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201.2%2fDocumentation%20Suite%20(SCORM%201.2)&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View={4D6DFFDE-3CFC-4DD9-A21A-4B687728824A} here].

Philip Hutchison provides an AS3 and JavaScript wrapper, as well as a sample package:
http://pipwerks.com/downloads/

==SCORM Package Contents==

A SCORM package must contains in the root of zip a file named imsmanifest.xml which defines SCORM course structure, resource location and many other things. Other files used in the package, such as HTML files, XML files, multimedia files, and JavaScript for the SCORM API must be listed in this file. The LMS parses the manifest, and provides the files listed there to the content package during runtime.

==AICC Package Contents==

An AICC package is defined by several files (from 4 to 7) with defined extensions as follows:

* CRS - Course Description file (mandatory)
* AU - Assignable Unit file (mandatory)
* DES - Descriptor file (mandatory)
* CST - Course Structure file (mandatory)
* ORE - Objective Relationship file (optional)
* PRE - Prerequisites file (optional)
* CMP - Completition Requirements file (optional)

==Basic Troubleshooting==

* Make sure you are running Moodle 2.1 or higher, a large number of SCORM related bugs are present in previous versions.
* Make sure your SCORM object is SCORM compliant - check it in an external SCORM player like [https://docs.moodle.org/en/Tools_for_creating_SCORM_content#Reload Reload] to see if it works there.
* Upload a copy of your SCORM object to a [http://en.wikipedia.org/wiki/File_hosting_service File Hosting Service] and post a message asking for help in the forums, linking to your SCORM object explaining exactly what you expect to happen, and what is happening instead.
* Read Dan Marsden's blog post [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle here] (Maintainer of SCORM Module in Moodle)

==Does Moodle Generate SCORM Content?==

Moodle '''does not''' generate scorm content. Moodle presents the content in SCORM packages to learners, and saves data from learner interactions with the SCORM package.

==Supported Versions==

* SCORM 1.2 is supported in Moodle 2.1(or higher) and passes all the tests in the ADL Conformance test suite 1.2.7 for SCORM 1.2. The best place for information on SCORM 1.2 conformance is the [http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Previous%20Versions/SCORM%201.2/Conformance%20Test%20Suite%20(SCORM%201.2)/SCORM_1.2_ConformanceReq.pdf SCORM Comformance Requirements documentation (PDF 3.4MB)].

* SCORM 2004 is not completely supported in Moodle at this stage. Parts of the API have been implemented, but others such as Navigation and Sequencing are not yet supported. If you require a fully certified SCORM 2004 Player in Moodle, [http://www.scorm.com Rustici Software] have a [http://support.scorm.com/entries/20394726-scorm-cloud-moodle-module Moodle plugin] which connects to their commercial [http://www.scorm.com/scorm-solved/scorm-cloud/ SCORM Cloud] service turning Moodle into a fully compliant SCORM 2004 LMS.
:''Moodle Core SCORM 2004 development requires funding!'' See [http://danmarsden.com/blog/2009/05/23/scorm-2004-in-moodle/ SCORM 2004 in Moodle] for details.

* AICC objects are supported in Moodle 2.1 and higher.

* SCORM 2.0 has not been released yet by ADL, and Moodle does not support any of it at this stage.

==Asking for Help in the SCORM Forum==

When trying to engage the community to help with a problem you are facing, you will get a better response if you follow a few simple guidelines:

* Always start your report with '''version information''' - preferably the information displayed on the Admin -> Environment panel eg. http://localhost/moodle/admin/environment.php where http://localhost/moodle is your particular prefix. With this it will be clear how you are running your Moodle instance, on what platform, and at which version. This will quickly expose issues where a simple upgrade will solve your problem.

* Be prepared to '''provide the SCORM package''' that illustrates your problem - if you don't then it will be very difficult for anyone offering assistance to recreate your situation - a real barrier to help.

* '''Screenshots''' are very helpful. Provide a screenshot of all error messages, and any instance where something seems to go wrong in the interface.

* Run your problematic SCORM package through '''debugging''' (see below) and include the text of that API log with your post. That way we can see right away if the right function calls are not taking place.

* If you're using a content development suite which publishes to SCORM, such as Articulate, Captivate, Lectora, LessonBuilder, Udutu, or some other product, then include that in your post. Every authoring software has its ticks, and if you've run into one, it's likely that someone else has also dealt with it, and will recognize it. However, please keep in mind that '''this is a place to get help with Moodle issues, not help with your SCORM package authoring suite'''.

==Debugging ==

# Debugging settings are located at Settings > Site Administration > Plugins > Activities > Scorm.
# Check the checkbox for '''Activate API debug...'''
# Set the api mask. You can use the mask to enable debugging under certain conditions. For example, if you are logged in using the admin user (username admin) you can set the api mask to: <cite>admin.*</cite> Users not logged in as admin will not see the debugging log. The "Default" api mask is <cite>.*</cite>

==What does the debugging log mean?==

The SCO commonly sends the following communications through the API:

* '''LMSInitialize();''' opens the connection between the SCO and Moodle
* '''LMSGetValue( 'valuename' );''' gets a value from Moodle
* '''LMSSetValue( 'valuename' , 'value' );''' sends a value to Moodle
* '''LMSCommit();''' saves values sent to Moodle via LMSSetValue() and should be called after every LMSSetValue()
* '''LMSFinish()''' saves values sent to Moodle and closes the connection between the SCO And Moodle

Red lines in the debugging log means there was an error in the communication through the API.

If LMSInitialize() fails, returns an error, then no subsequent values sent to Moodle will be saved.

Click through the entire SCORM package. Then access the scorm report for your attempt, and compare the saved values in the debugging log with Moodle's report of the attempt. If the values set in the debug log do not match the values saved to Moodle, then there may be a problem with Moodle. Otherwise it's likely to be an issue with the SCO or the SCORM activity settings not giving you the functionality you need.

==SCORM and the Gradebook==
Please see [https://docs.moodle.org/en/SCORM_FAQ#My_SCORM_Module_doesn.27t_function_properly FAQ:My SCORM Module doesn't function properly] and [https://docs.moodle.org/en/SCORM_FAQ#Handling_of_Multiple_Attempts FAQ:Handling of Multiple Attempts]

Some SCORM packages report both cmi.core.lesson_status and cmi.core.score.raw. Others report only cmi.core.lesson_status, or only cmi.core.score.raw. The '''Grading Method''' setting for SCORM objects is meant to account for that.

If you have the '''Grading Method''' set to '''Highest grade''', '''Average grade''', or '''Sum grade''', and your learning object does not report a score, only, cmi.core.lesson_status, then there will be no numerical score to pass to the gradebook.

If your SCOs do not report cmi.core.score.raw, then the best '''Grading Method''' setting is '''Learning Objects'''. This reports either a 1 or a 0 as a score for each learning object. The gradebook value for that SCORM activity is the percent of scos in the package for which learners got a 1.

On the other hand, if your SCOs do not report a lesson_status, then select one of the score-based '''Grading Method''' options, such as '''Highest grade''', '''Average grade''', or '''Sum grade''', and not '''Learning Objects'''.

If you do not know what your SCOs are reporting to the LMS, then run them through to completion with debugging on.

Much of the way SCORM objects are graded is controlled inside the SCORM Authoring process before it is packaged for use in an LMS like Moodle - make sure all your grading settings are set correctly. Moodle 2.0 contains some new controls that allow a teacher to override the behaviour as set by the SCORM object to allow for greater, more flexible control. (see MDL-11501 for more information on this)

==SCORM Administration Options==

See [[SCORM settings]]

==Common Solutions==

===Difficulty Displaying a SCORM Package===
If you have difficulty displaying a SCORM, try loading the SCORM in [http://www.reload.ac.uk Reload] and re-saving it, then save the folder as a .zip package and try again.

===Character Display Errors===
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.

===slash arguments warning when I add/update SCORM objects in my course===
SCORM forces what is referred to as "slash arguments" - Unfortunately, some PHP servers don't allow this method and your SCORM objects may not display. This affects IIS 5 and earlier, and some Apache servers. Under IIS 5 and earlier, a workaround using an [http://www.isapirewrite.com/ ISAPI re-write] tool can be used, Apache users should look at this link: https://docs.moodle.org/en/Installation_FAQ#Uploaded_files_give_.22File_not_found.22 - A check on the admin/tool/health/index.php page is also made to see if slasharguments is supported - visit http://yourmoodlesite/admin/tool/health/index.php to check to see the status of slasharguments on your server.

===SCORM doesn't work on Godaddy Host===
Godaddy hosts give a 404 file not found error - this is because by default they do not allow slash arguments which SCORM requires. The best way to test this is to visit http://yourmoodlesite/admin/tool/health/index.php - but the fix involves adding a php.ini or php5.ini file with the following text:
AcceptPathInfo
cgi.fix_pathinfo=1

===My Flash-Based Content Loads, then Stalls===
This issue is most commonly associated with zlib compression. Classic presentation is that the base HTML file and SWF are loaded into the SCORM player, but the SWF is not able to load any audio or video assets, and therefore stalls. You can watch the loading of SWFs and assets using Chrome's Developer Tools or other.

Check your site's zlib compression settings as an admin by loading up the Server > phpinfo page. zlib compression is not a Moodle setting but a server setting, so you'll need a server admin to disable it. Be sure to Purge All Caches, and clear browser caches, before confirming the change.

===Zlib warning when I add/update SCORM objects in my course===
Zlib is a php compression setting made in a websites PHP configuration - unfortunately some browsers don't handle this well (especially Internet Explorer 6) Some webhosts enable this setting, but it will likely cause issues for your users when they attempt to view/use the SCORM object. You will need to contact your server administrator to turn this off. The setting to change in php configuration is "zlib.output_compression"

===Incorrect file package - missing imsmanifest.xml or AICC structure===
This means that Moodle cannot find a file called imsmanifest.xml inside the SCORM object. Reasons for this could be:
* imsmanifest.xml needs to be immediately inside the scorm directory, NOT inside a directory inside of that. So if the zipped scorm package is package.zip, the unzipped package directory should contain immediately inside of it the imsmanifest.xml. This is a common mistake and normally occurs when a SCORM author creates a package themselves and then selects that folder to compress. This places the content folder inside of another folder, The imsmanifest.xml is there, but it is 2 directories deep. To avoid this problem when zipping scorm content into a package, go INSIDE of the exported scorm folder, select all files inside, and compress them while all are selected. The resultant compressed directory has the imsmanifest.xml file in the first directory, immediately available to the moodle scorm loading process.
* when using linux based systems the filename imsmanifest.xml must be all in lowercase not IMSmanifest.xml or Imsmanifest.XML
* The SCORM authoring tool Articulate sometimes fails to create the imsmanifest.xml -Try exporting the package again and see if the manifest is generated.
* The SCORM authoring tool Articulate Presenter will publish packages where the imsmanifest.xml file is in the correct place, but there are several lines of white space in the manifest file if you do not fill out the Reporting and Tracking Options in Articulate Presenter for Keywords and LMS Description. Moodle will give a "Manifest not found" error when encountering this. To fix this problem select the Reporting and Tracking Options in the Articulate Presenter publish dialog and fill in the LMS Description and Keywords.

===File not found error===
You have this error if the scorm package is created in moodle, and the scorm menu loads, but inside of the viewing area for the scorm content, you get a page with a 404 file not found error, usually showing the current Moodle theme.

What this means is that one of the files listed in the imsmanifest.xml is not in the scorm package or not in the correct directory.

Download and unzip the package, open up imsmanifest.xml. At the bottom of the xml file, below any metadata, you'll find a place where organizations and resources for those organizations are designated:

<code xml>

<organizations default="TOC1">
<organization identifier="TOC1">
<title>SCORM Test</title>
<item identifier="I_SCO0" identifierref="SCO0">
<title>Library Quiz</title>
<adlcp:masteryscore>0</adlcp:masteryscore>
</item>
</organization>
</organizations>
<resources>
<resource identifier="SCO0" type="webcontent" adlcp:scormtype="sco" href="scorm.html">
<file href="scorm.html"/>
<dependency identifierref="ALLRESOURCES" />
</resource>
<resource identifier="ALLRESOURCES" type="webcontent" adlcp:scormtype="asset">
<file href="scorm.html" />
<file href="scorm.js" />
<file href="swfobject.js" />
<file href="scorm.swf" />
<file href="scormwrapper.js" />
</resource>
</resources>
</manifest>
</code>

In this xml, we have a single organization, and in that organization is a single resource, a single sco. There are 5 files necessary for that resource to work correctly. The scorm.html file is loaded first. It loads 3 external js files and a swf.

What you need to do now is go to the directory containing imsmanifest.xml, and check that all of those listed files are available at the correct path from imsmanfiest.xml, as listed in imsmanifest.xml. If any one of those files is missing (especially the html file or the swf), or if the paths in imsmanifest.xml are incorrect, then it's very likely that the scorm object won't be able to load at all.

Sometimes the files aren't missing, but are simply misnamed in the manifest, or placed in the wrong directory. You can fix this by moving the files to the correct places, or updating their names so that the imsmanifest and the actual file names match up. In the case of a misnamed file, change the manifest rather than the actual file names, since the the files also reference one another in other places!

===Unzip issues===
If you get a blank page after filling in the title, description, and selecting a large SCORM file, it's likely you haven't installed the PHP-zip lib which is required for Moodle 2.x for more info see [[admin/environment/php_extension/zip]]

===Clear an Attempt===
To clear attempts by a student:

# Go to the SCORM activity and select the link "View reports for x users"
# Select the attempt or attempts you want to clear using the checkbox
# Select Delete in the drop-down box at the bottom of the page

===Handling of Multiple Attempts===
SCORM is designed to allow a learner to exit and return at a later date to the same point they left from. This means that each time they enter the SCORM they are using the same single attempt. Some SCORM packages are intelligent about handling re-entry, many are not. What this means is that if the learner re-enters an existing attempt, if the SCORM content does not have internal logic to avoid overwriting cmi.core.lesson_status and cmi.core.score.raw, they can be overwritten by a lower score, confusing the learner.

When a SCORM sets the cmi.core.lesson_status value to 'completed', 'passed' or 'failed' then Moodle allows the user to create a new attempt by adding a '''Start new attempt''' checkbox to the entry page. If cmi.core.lesson_status is set to 'incomplete', 'browsed' or 'notattempted' the learner can only re-enter the existing attempt. If you are using the setting 'Student skip content structure page', this checkbox will never be shown to the user.

Moodle provides a range of settings to allow this to be controlled, some of these settings are hidden by default as advanced options.
* Number of attempts
:This allows the teacher to set how many SCORM attempts the learner may create - this is not how many times a learner can re-enter a SCORM attempt.
* Attempts grading
:This allows the teacher to set how multiple SCORM attempts(not re-entries) are graded. It is important to note that a 'failed' cmi.core_lesson_status allows a new attempt to be generated but the attempts grading setting "last completed attempt" only includes 'completed' and 'passed' values in it's calculations.
* Display attempt status
:This displays a users SCORM attempts and how their final grade is calculated on the SCORM entry page and the My Moodle page for the learner.
* Force completed
:This is a setting that can be used to force a SCORM package to report a 'completed' cmi.core.lesson_status if it doesn't currently set the value.
* Force new attempt
:This hides the '''Start new attempt''' checkbox and will force a new attempt if the previous attempt has cmi.core.lesson_status value to either 'completed' or 'passed' - this setting can also be used to make sure a new attempt is generated when the 'Student skip content structure page' setting is used.
* Lock after final attempt
:This prevents access to the SCORM after the total number of attempts have been used - if this is not set the learner can re-enter their last attempt and potentially change/overwrite their score each time depending on how the SCORM package supports multiple re-entries.

===Reducing Load Time with Captivate===
* Modify the percent that must be downloaded before the content starts to play. In Captivate 4, there's a setting in: Preferences / Project / Start and End / Preload. Reduce that to 50%.
* If you use audio in your Cp file (as background or element attachment), try to put a gap of 0,1 second at the beginning of each element including audio on your slides. If you don't do that, Cp merge all the audio files in one big audio file it need to download before playing the project. This problem have been report many times from the Cp community.

===Moodle changes cmi.core.lesson_status from "completed" or "passed" to "failed"===
Many SCORM authorware suites generate a masteryscore node in the imsmanifest.xml by default. This node is not necessary to the XML file. But when it is there, the SCORM standard designates specific behavior with regard to the value set there.

Here's what is in the scorm standard, on page 35 of 155 in SCORM_1.2_ConformanceReq.pdf, numbered page 2-19 ([http://www.adlnet.gov/Technologies/scorm/SCORMSDocuments/Forms/AllItems.aspx?RootFolder=%2fTechnologies%2fscorm%2fSCORMSDocuments%2fPrevious%20Versions%2fSCORM%201%2e2%2fDocumentation%20Suite%20%28SCORM%201%2e2%29&FolderCTID=0x0120007F801FCD5325044C89D91240519482D7&View=%7b4D6DFFDE%2d3CFC%2d4DD9%2dA21A%2d4B687728824A%7d SCORM Version 1.2 Conformance Requirements Version 1.2]):
<blockquote>
If the value for this element is not set to “incomplete” by the SCO, then the LMS shall re-evaluate and change the value based on the following:<ul>
<li>If there is no mastery score in the Manifest, and the SCO sets a score (cmi.core.score.raw) and the lesson_status (cmi.core.lesson_status) then the LMS shall not override the SCO determined status.</li>
<li>If there is a mastery score in the Manifest, the LMS can change the status to either passed or failed depending on the student's score (cmi.core.score.raw) compared to the mastery score.</li>
<li>If the student is taking the SCO for no-credit, (cmi.core.credit = “no-credit”) there is no change to the lesson_status, with one exception. If the lesson_mode (cmi.core.lesson_mode) is "browse", the lesson_status may change to "browsed" even if the cmi.core.credit is set to no-credit.</li>
</ul>
</blockquote>
This can result in some functionality you don't intend. You can fix the problem by removing the mastery score node from your imsmanifest.xml file. You will also want to find out what options you have, within your authorware suite, for the writing of that node into the manifest file, and change your authoring process accordingly.

===Player Look 'n Feel===
You should be able to adjust height and width settings for the SCORM player window '''so long as''' your theme is based on/not too much of an aberration from one of the standard themes which ship with Moodle 2.

If your site or course theme isn't closely based on one of the standard M2 themes, then it's possible that your theme CSS is overriding local height and width settings for the SCORM player. Have a Web developer (or a Moodle Partner) examine how your theme is interacting with the player layout, and make changes to your theme as needed.

'''Why can't I just change it locally?''' You can change height and width per individual SCORM package, and you can set defaults for these local height and width values ( [[SCORM Admin Options]] ). Other things, such as colors, shading, borders, backgrounds, are controlled by CSS, just like everything else on the site.

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?id=1951 SCORM forum]
* [http://danmarsden.com/blog/2012/08/08/scorm-doesnt-work-in-moodle SCORM doesn't work] blog post from developer Dan Marsden
* [http://danmarsden.com/blog/2009/05/23/scorm-2004-in-moodle/ SCORM 2004 in Moodle] blog post from developer Dan Marsden
* [https://docs.moodle.org/dev/SCORM_schema Internal SCORM Schema]
* The official standard: [http://www.adlnet.gov/Technologies/scorm/default.aspx Advanced Distributed Learning - SCORM]

Online resources
* [http://www.scormcourse.com/ SCORMCourse.com] serves the SCORM and ADL community as an educational resource for SCORM technology.
* [http://www.eduworks.com/index.php/Publications/Learning-Object-Tutorial.html Learning Object Tutorial]
* [http://elearningweekly.wordpress.com/2007/04/12/tutorial-build-scorm-compatible-lesson-templates-for-your-lms/ Tutorial: Build SCORM-Compatible Lesson Templates for Your LMS]

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=3757 Simple introduction to SCORM]
*[http://moodle.org/mod/forum/discuss.php?d=57059 Are there any sugestions for scorm authoring with Microsoft word / or any other easy (maybe free) scorm authoring tool?]
*[http://moodle.org/mod/forum/discuss.php?d=95946 Is SCORM worth it?]
*[http://moodle.org/mod/forum/discuss.php?d=207964 Updating an Object]

[[Category:FAQ]]
[[de:Lernpaket FAQ]]

Using SCORM

2011-07-14T20:57:10Z

Aegroshek: /* SCORM Reports Screen */

{{SCORM}}
'''Please refer to [[TOC_with_notes#SCORM|these notes]] before editing this page.'''

Like a Moodle course, each SCORM package will vary with the modules used in its construction by the teacher and by the SCORM activity settings established by the teacher.

==Features of Student View==
*Preview and review mode options
*Checkboxes to indicate whether sections have been accessed previously
*Start new attempt
*Reset

==Features of Teacher View==

===Access SCORM Reports===
To access the scorm reports, first go to the content structure page with a user that has teacher permissions. Select the '''Results''' tab.
[[Image:M2-scorm-results-tab.png|center|thumb|500px|SCORM Results Tab]]

===SCORM Reports Screen===
The reports page shows a table of attempts for the SCORM activty. If you have the SCORM activity set up to allow multiple attempts, there may be more than one attempt for some users.
* '''Delete Attemtps:''' Delete attempts by selecting the attempt checkbox, and then selecting the '''Delete selected attempts''' button.
* '''Export Attempts:''' Select one of the export options to download attempts in various formats.
* '''Single Attempt Data:''' Select the number in the attempt column to view a detailed report for a specific user attempt.
[[Image:M2-scorm-report.png|center|500px|thumb|SCORM report table]]

[[Image:View attempt.png|center|500px]]

Select the Track Details link to view the specific SCORM values recorded to the LMS by the SCORM object.

[[Image:Track details.png|center|500px|Track details view of SCORM report for a single user]]

Note that the tracked details depend heavily upon what the SCORM object itself is programmed to report. Many SCORM packages created with authoring suites use the suspend_data field to record important information, instead of the traditional SCORM values. This makes deciphering the recorded data extremely difficult.

===Clear an Attempt===
To clear attempts by a student:

# Go to the SCORM activity and select the link "View reports for x users"
# Select the attempt or attempts you want to clear using the checkbox
# Select Delete in the drop-down box at the bottom of the page

==See also==

[[Category:Teacher]]
[[Category:SCORM]]

[[fr:Voir un SCORM]]
[[ja:SCORMを表示する]]
[[de:Lernpaket ansehen]]

Using SCORM

2011-07-14T20:55:22Z

Aegroshek: /* Export SCORM Reports */

{{SCORM}}
'''Please refer to [[TOC_with_notes#SCORM|these notes]] before editing this page.'''

Like a Moodle course, each SCORM package will vary with the modules used in its construction by the teacher and by the SCORM activity settings established by the teacher.

==Features of Student View==
*Preview and review mode options
*Checkboxes to indicate whether sections have been accessed previously
*Start new attempt
*Reset

==Features of Teacher View==

===Access SCORM Reports===
To access the scorm reports, first go to the content structure page with a user that has teacher permissions. Select the '''Results''' tab.
[[Image:M2-scorm-results-tab.png|center|thumb|500px|SCORM Results Tab]]

===SCORM Reports Screen===
The reports page shows a table of attempts for the SCORM activty. If you have the SCORM activity set up to allow multiple attempts, there may be more than one attempt for some users.
* Delete attempts by selecting the attempt checkbox, and then selecting the '''Delete selected attempts''' button.
* Select one of the export options to download attempts in various formats.
* Select the number in the attempt column to view a detailed report for a specific user attempt.
[[Image:M2-scorm-report.png|center|500px|thumb|SCORM report table]]

[[Image:View attempt.png|center|500px]]

Select the Track Details link to view the specific SCORM values recorded to the LMS by the SCORM object.

[[Image:Track details.png|center|500px|Track details view of SCORM report for a single user]]

Note that the tracked details depend heavily upon what the SCORM object itself is programmed to report. Many SCORM packages created with authoring suites use the suspend_data field to record important information, instead of the traditional SCORM values. This makes deciphering the recorded data extremely difficult.

===Clear an Attempt===
To clear attempts by a student:

# Go to the SCORM activity and select the link "View reports for x users"
# Select the attempt or attempts you want to clear using the checkbox
# Select Delete in the drop-down box at the bottom of the page

==See also==

[[Category:Teacher]]
[[Category:SCORM]]

[[fr:Voir un SCORM]]
[[ja:SCORMを表示する]]
[[de:Lernpaket ansehen]]

Using SCORM

2011-07-14T16:06:58Z

2011-07-14T15:57:54Z

Aegroshek: /* Access SCORM Reports */

{{SCORM}}
'''Please refer to [[TOC_with_notes#SCORM|these notes]] before editing this page.'''

Like a Moodle course, each SCORM package will vary with the modules used in its construction by the teacher and by the SCORM activity settings established by the teacher.

==Features of Student View==
*Preview and review mode options
*Checkboxes to indicate whether sections have been accessed previously
*Start new attempt
*Reset

==Features of Teacher View==

===Access SCORM Reports===
To access the scorm reports, first go to the content structure page with a user that has teacher permissions. Select the '''Results''' tab.
[[Image:M2-scorm-results-tab.png|center|500px]]

===SCORM Reports Screen===
The reports page shows a table of results for each SCORM section. Sections may be marked browsed, incomplete, completed or failed. The time spent on each section is also displayed. If a section includes questions then the score is displayed. Clicking on each time spent link you can see the learning object tracking details.

[[Image:Moodle scorm reports.png|center|500px]]

From this screen, you can delete attempts by selecting the attempt checkbox, and then selecting Delete in the drop down menu below the attempts table.

[[Image:Delete scorm attempt.png|center|600px]]

Select the number in the attempt column to view a detailed report for a specific user attempt.

[[Image:View attempt.png|center|500px]]

Select the Track Details link to view the specific SCORM values recorded to the LMS by the SCORM object.

[[Image:Track details.png|center|500px|Track details view of SCORM report for a single user]]

Note that the tracked details depend heavily upon what the SCORM object itself is programmed to report. Many SCORM packages created with authoring suites use the suspend_data field to record important information, instead of the traditional SCORM values. This makes deciphering the recorded data extremely difficult.

===Export SCORM Reports===

===Clear an Attempt===
To clear attempts by a student:

# Go to the SCORM activity and select the link "View reports for x users"
# Select the attempt or attempts you want to clear using the checkbox
# Select Delete in the drop-down box at the bottom of the page

==See also==

[[Category:Teacher]]
[[Category:SCORM]]

[[fr:Voir un SCORM]]
[[ja:SCORMを表示する]]
[[de:Lernpaket ansehen]]

2011-07-14T15:23:11Z

Aegroshek: /* Save settings */

{{SCORM}}
'''Please refer to [[TOC_with_notes#SCORM|these notes]] before editing this page.'''
To edit or add a SCORM to a course, turn on the course edit mode as a teacher with editing privileges.

The SCORM activity can also be used to add AICC content running using AICC HACP (HTTP AICC Communication Protocol "Appendix A"), see CMI001 - AICC/CMI Guidelines For Interoperability [http://www.aicc.org/pages/down-docs-index.htm#cmi001]

==Adding==
# While logged in as a teacher, select [[Image:Turn edit on button.JPG]] at the top right of a course homepage or in the course admin menu. See [[Turn_editing_on]].
# in one of the '''Add an activity...''' drop down menus that appear, select '''SCORM package'''.

==Editing==
If the SCORM/AICC package has already been added, you can edit it by clicking the edit icon (pen) in the resource/activity list on front page of the course. If you are in the SCORM page, you can click the '''Update this SCORM''' button. Both these methods bring you to the settings page.

==Settings==
On the Setting page, the teacher can view the 3 settings areas, along with the save options buttons.
[[Image:M2-blank-settings.png|thumb|400px|center|Moodle 2.0 SCORM Setting Page ]]

===General settings===
*'''Name''' field records the short name of the activity. This appears in the navigation breadcrumb.
*'''Description''' text is only seen after the name in the list shown when you choose "activities > Scorm"
*'''Package file''' setting determines what SCORM package is used by this SCORM activity. To select the SCORM package, first select the '''Choose''' button to launch the file picker.
[[Image:M2-scorm-settings.png|thumb|400px|center|Launch file picker]]
With the file picker launched, you can navigate to an existing file, or select the '''Choose''' button in the file picker to upload a new file.
[[Image:M2-scorm-file-picker-choose.png|thumb|400px|center|Launch file picker]]
Browse to the new SCORM package on your local machine and select it. When you are returned to the file picker, select '''Upload'''.
[[Image:M2-scorm-upload-file-to-site.png|thumb|400px|center|Launch file picker]]
If selecting files is difficult, you might want to learn more about the [[File picker]].

:''Tip:'' Additional '''Package file''' settings are available when configured globally. See '''Admin settings''' below.

===Other settings===
Pressing the advance button will reveal all the choices below.
[[Image:SCORM_settings_other_19.png|thumb|300px|right|Moodle 1.9 SCORM Other Settings block - advanced shown ]]
*'''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. ''Tip:'' 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. ''Tip:'' 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 Moodle will calculate the average of all scores.
**Sum grade - With this mode all the scores will be added.
*'''Maximum grade''' - Not applicable if Grading Method is Learning objects. Usual setting is 100. If your SCO 's high score is something other than 100, you should adjust this value appropriately. When grading Method is one of the score settings, then the gradebook grade is package score divided by this number.
*'''Number of attempts''' - 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.
*'''Attempts grading''' - When you permit multiple attempts for students, you can choose how to record the result in gradebook by first, last, average or highest settings.
*'''Width''' - Stage size width as a css value, either % or pixels. Default is 100%. You can change to a different percentage by putting a % symbol after the number (ex. 80%). You can also set to a pixels value by entering a number higher than 100 (ex. 800).
*'''Height''' - Stage size height as a css value, either % or pixels. Default is 500 pixels. You can change to a percentage by putting a % symbol after the number (ex. 80%). You can also set to a pixels value by entering a number higher than 100 (ex. 800).
*'''Display package''' - in current or new window
*'''Options''' - There are a series of check boxes for:Allow the window to be resized ad scrolled, displaying directory links, location bar, menu bar, toolbar and/or status.
*'''Student skip content structure page''' - never, first access, always
*'''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 student 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
*'''Course structure display''' - Table of Contents display
*'''Hide navigation buttons'''
*'''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.
:''TIP:'' Auto-Continue will only to move from one SCORM to the next in the same topic.

*'''Display package''' - Allow the window to be resized, Allow the window to be scrolled, Show the directory links, Show the location bar, Show the menu bar, Show the toolbar, Show the status bar.

{{Moodle 2.0}}In Moodle 2.0 onwards, the following additional settings influencing player/package interaction are available:
* Display attempt status
* Display course structure
* Force completed
* Force new attempt
* Lock after final attempt

===Common module settings===
See [[Common module settings]]

[[Image:SCORM_setting_common_19.png|thumb|300px|right|Moodle 1.9 SCORM Common settings block - advanced shown ]]

===Save settings===
As in most activities there are 3 save button choices. '''Cancel''', '''Save and return to course''' and '''Save changes''' buttons. The Save changes button will take the teacher back to the SCORM "stage" page.
[[Image:SCORM_activity_homepage_teacher_19.png|thumb|300px|right|Moodle 1.9 SCORM Teacher staging area ]]

==Admin Settings==
These options are available to the site admin in the '''Settings''' menu: Site Administration > Plugins > Activity Modules > SCORM Package.

Many of the settings available here simply set the default value for the SCORM activity module setup options provided within courses. This will cover the options provided which '''do not''' simply set a default value for the SCORM activity editing page view.

'''Synchronization time:''' For SCORM packages that have the auto-update setting to 'Every Day' this defines what time the process should run.

'''Enable external package type:''' If selected, presents a text field to paste a URL to a remote imsmanifest.xml (in an unzipped remote SCORM package), as well as the file picker option provided by default. Note that the content is played from the designated location, and not unpacked into the Moodle file system. So any reporting data will not be saved via the SCORM API in to Moodle.

'''Enable downloaded package type:''' If selected, presents a text field to paste a URL to a remove package.zip SCORM package. Package is downloaded and unzipped into the Moodle file system.

'''Enable IMS package type:''' Enables a package to be selected from within an IMS repository

'''Force users to enable JavaScript:''' Since the SCORM API uses JavaScript to save data to Moodle, this is a great idea!

'''Activate API debug and tracing (set the capture mask with apidebugmask):''' Turns on debugging for SCORM activities. In Moodle 2 you no longer have to also turn on debugging in the developer options.

'''API debug capture mask - use a simple regex on <username>:<activityname> e.g. admin:.* will debug for admin user only:''' You can use the mask to enable debugging under certain conditions. For example, if you are logged in using the admin user (username admin) you can set the api mask to: '''admin.*''' Users not logged in as admin will not see the debugging log. The "Default" api mask is '''.*''' which translates roughly to '''everybody'''.

==Tips and tricks==
*Please note that Moodle can't create SCORM packages - the SCORM module is simply for deploying SCORM packages. If you wish to create SCORM packages please see the [[SCORM#External links | links to SCORM tools]].
* If you have difficulty displaying a SCORM, try loading the SCORM in [http://www.reload.ac.uk Reload] and re-saving it, then save the folder as a .zip package and try again.
* 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.

==See also==

[[Category:Teacher]]
[[Category:SCORM]]

[[fr:Ajouter/modifier un SCORM]]
[[ja:SCORMを追加/編集する]]
[[de:Lernpaket anlegen]]

2011-07-14T14:54:05Z

Aegroshek:

2011-07-14T14:47:04Z

Aegroshek: /* General settings */

{{SCORM}}
'''Please refer to [[TOC_with_notes#SCORM|these notes]] before editing this page.'''
To edit or add a SCORM to a course, turn on the course edit mode as a teacher with editing privileges.

The SCORM activity can also be used to add AICC content running using AICC HACP (HTTP AICC Communication Protocol "Appendix A"), see CMI001 - AICC/CMI Guidelines For Interoperability [http://www.aicc.org/pages/down-docs-index.htm#cmi001]

==Adding==
# While logged in as a teacher, select [[Image:Turn edit on button.JPG]] at the top right of a course homepage or in the course admin menu. See [[Turn_editing_on]].
# in one of the '''Add an activity...''' drop down menus that appear, select '''SCORM package'''.

==Editing==
If the SCORM/AICC package has already been added, you can edit it by clicking the edit icon (pen) in the resource/activity list on front page of the course. If you are in the SCORM page, you can click the '''Update this SCORM''' button. Both these methods bring you to the settings page.

==Settings==
On the Setting page, the teacher can view the 3 settings areas, along with the save options buttons.
[[Image:M2-blank-settings.png|thumb|400px|center|Moodle 2.0 SCORM Setting Page ]]

===General settings===
[[Image:m2-scorm-settings.png|thumb|500px|center|Launch file picker]]
*'''Name''' field records the short name of the activity. This appears in the navigation breadcrumb.
*'''Description''' text is only seen after the name in the list shown when you choose "activities > Scorm"
*'''Package file''' button to open the course Files area. Locate the zipped SCORM package (otherwise upload it to the server before continuing).
** Use the '''choose''' link (NOT the Unzip link) to select the package.
Some people are confused by this, and they think that "choose" means that you select the checkbox to the left of the file name. This is not the case. You may need to increase the size of the file browser window to see the Choose link, or scroll to the right.
[[Image:Picture-3.jpg|thumb|500px|center|File browser window, arrow points to Choose link]]
A SCORM package must contains in the root of zip a file named imsmanifest.xml that define SCORM course structure, resource location and many other things.

An AICC package is defined by several files (from 4 to 7) with defined extensions as follows:

* CRS - Course Description file (mandatory)
* AU - Assignable Unit file (mandatory)
* DES - Descriptor file (mandatory)
* CST - Course Structure file (mandatory)
* ORE - Objective Relationship file (optional)
* PRE - Prerequisites file (optional)
* CMP - Completition Requirements file (optional)

:''Tip:'' If the Choose link is not visible - close the pop-up window and click the "Choose or upload a file" button again.
:''Tip:'' As an alternative to the previous two steps, you may paste a URL into the Package file field that references a zip file or imsmanifest.xml file hosted on an external repository.

===Other settings===
Pressing the advance button will reveal all the choices below.
[[Image:SCORM_settings_other_19.png|thumb|300px|right|Moodle 1.9 SCORM Other Settings block - advanced shown ]]
*'''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.
*** Note that 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.
*** Note that 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 Moodle will calculate the average of all scores.
**Sum grade - With this mode all the scores will be added.
*'''Maximum grade'''
*'''Number of attempts''' - This define 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.
*'''Attempts grading''' - When you permit multiple attempts for students, you can choose how to record the result in gradebook by first, last, average or highest settings.
*'''Window''' - Stage size width, Stage size height
*'''Display package''' - in current or new window
*'''Options''' - There are a series of check boxes for:Allow the window to be resized ad scrolled, displaying directory links, location bar, menu bar, toolbar and/or status.
*'''Student skip content structure page''' - never, first access, always
*'''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 student 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
*'''Course structure display''' - Table of Contents display
*'''Hide navigation buttons'''
*'''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.
:''TIP:'' Auto-Continue will only to move from one SCORM to the next in the same topic.

*'''Display package''' - Allow the window to be resized, Allow the window to be scrolled, Show the directory links, Show the location bar, Show the menu bar, Show the toolbar, Show the status bar.

{{Moodle 2.0}}In Moodle 2.0 onwards, the following additional settings influencing player/package interaction are available:
* Display attempt status
* Display course structure
* Force completed
* Force new attempt
* Lock after final attempt

===Common module settings===
See [[Common module settings]]

[[Image:SCORM_setting_common_19.png|thumb|300px|right|Moodle 1.9 SCORM Common settings block - advanced shown ]]

===Save settings===
As in most activities there are 3 save button choices. "Cancel", "Save and return to course" and "Save changes" buttons. The Save changes button will take the teacher back to the SCORM "stage" page.
[[Image:SCORM_activity_homepage_teacher_19.png|thumb|300px|right|Moodle 1.9 SCORM Teacher staging area ]]

==Admin Settings==
These options are available to the site admin in the '''Settings''' menu: Site Administration > Plugins > Activity Modules > SCORM Package.

Many of the settings available here simply set the default value for the SCORM activity module setup options provided within courses. This will cover the options provided which '''do not''' simply set a default value for the SCORM activity editing page view.

'''Synchronization time:''' For SCORM packages that have the auto-update setting to 'Every Day' this defines what time the process should run.

'''Enable external package type:''' If selected, presents a text field to paste a URL to a remote imsmanifest.xml (in an unzipped remote SCORM package), as well as the file picker option provided by default. Note that the content is played from the designated location, and not unpacked into the Moodle file system. So any reporting data will not be saved via the SCORM API in to Moodle.

'''Enable downloaded package type:''' If selected, presents a text field to paste a URL to a remove package.zip SCORM package. Package is downloaded and unzipped into the Moodle file system.

'''Enable IMS package type:''' Enables a package to be selected from within an IMS repository

'''Force users to enable JavaScript:''' Since the SCORM API uses JavaScript to save data to Moodle, this is a great idea!

'''Activate API debug and tracing (set the capture mask with apidebugmask):''' Turns on debugging for SCORM activities. In Moodle 2 you no longer have to also turn on debugging in the developer options.

'''API debug capture mask - use a simple regex on <username>:<activityname> e.g. admin:.* will debug for admin user only:''' You can use the mask to enable debugging under certain conditions. For example, if you are logged in using the admin user (username admin) you can set the api mask to: '''admin.*''' Users not logged in as admin will not see the debugging log. The "Default" api mask is '''.*''' which translates roughly to '''everybody'''.

==Tips and tricks==
*Please note that Moodle can't create SCORM packages - the SCORM module is simply for deploying SCORM packages. If you wish to create SCORM packages please see the [[SCORM#External links | links to SCORM tools]].
* If you have difficulty displaying a SCORM, try loading the SCORM in [http://www.reload.ac.uk Reload] and re-saving it, then save the folder as a .zip package and try again.
* 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.

==See also==

[[Category:Teacher]]
[[Category:SCORM]]

[[fr:Ajouter/modifier un SCORM]]
[[ja:SCORMを追加/編集する]]
[[de:Lernpaket anlegen]]