SCORM Debugging Tips

If you've integrated SCOBot into your custom SCO and are running into issues with data persistence or integrity there are several options for isolating the issue.

Isolate the issue

Decrease all the other chatter to just test a specific feature that appears to be failing.

Is the SCO Terminating early?

Something is causing that to happen which can often include a button click that could relocate the URL. That would trigger a unload event, which in turn would Terminate the session.

Is data not persisting?

All to often the 'cmi.exit' type can get switched to something other than 'suspend'. Step back thru the logs to find out if that is indeed occurring. Generate enough data, and that is something you can present back to the platform support/team to troubleshoot further.

Is data being lost?

Sometimes you can forget to commit the students attempt. Or on a bad network connection it can result in a corrupt post. There have been a number of instances where this has occurred (hotel, airport or other open hotspots). These often take deep tests and network logging to diagnose. It could even be caused server side due to headers, security, cache settings etc ...

Approach the issue on several fronts

1. Consider creating a QUnit test to automate the SCORM calls that mimic your use case.
2. Use the browsers console to trigger your own SCORM calls or interact with SCORM Runtime directly.
3. Place console messages in your code to output the before and after logs.

SCOBot has a debug (true/false) boolean which can be adjusted to increase the logging from whats occurring. This is filled with a lot of information which can saturate the console with logs.

Tip

The SCOverseer bookmarklet is a great way to see the student attempt values. It will actively seek out SCORM 1.2, SCORM 2004 or AICC to obtain several popular namespace values from the student attempt or CMI Object. It renders these in an HTML display for your review. This can often be far easier than trolling through console logs, or diagnostic reports. You can obtain free use to this bookmarklet at https://cybercussion.com/bookmarklets/SCORM