Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: added section for workaround COREDEV-5737

Table of Contents

...

  1. Check the Scorm version (see 5440507153)
  2. Check that the course link is published (see 5440507153) (only applies to 4.2.x)
  3. Check the SCOId and Resource Id for invalid characters (see No Error (infinite loading) or "No Links Specified" in the LMS, fixed in 4.3.0)
    1. v4.5 only: verify the custom ScoId does not contain any periods or spaces (see LINK)
  4. Check the SCOManifest.js and ensure a SCOId is mapped (see 5440507153)
  5. Check the browser's Console for errors and Network tab for external calls and or errors (including 3rd party cookies and if the course is using Flash).
    1. Note: Often, Scorm courses will cancel a web request for their entry point and then re-request it.  This is very common, and hasn't been known to cause any issues (and can be reasonably ignored as the problem):
  6. Check the Scorm calls by debugging the Scorm course via the browser's Sources tab and setting break points in API.LMSGetValue and API.LMSSetValue in MarineLMS-SCORM-API.js (see 5440507153)
  7. Try and import the Scorm course locally, and debug the extraction process to ensure the course contains activities and has a valid manifest (see 5440507153)
  8. Check the package works outside the LMS by verifying the package on the Scorm Cloud (see 5440507153)

...

Note this has been fixed on NCLH by changing the CSP to use frame-src instead of script-src and whitelisting cloud.scorm.com. Additionally, this must be tested with https as external sites (e.g. cloud.scorm.com) will reject an unsecured http request. Use hotbackup for testing.

v4.5 Only: Custom ScoId is missing characters (period or space)

There is an issue with v4.5 removing periods or spaces from the custom ScoId stored in the LinkAttribute value.  If a period or space is desired as part of the custom ScoId, import the course as normal with the desired custom ScoId, then follow these steps:

  • Go to the actual Scorm course
  • Open DevTools, and click the Console tab
  • paste this in chrome's dev console (with the scope set to 'Top')
    $('.navbar.navbar-fixed-bottom').attr('style','display:block !important');
  • The admin bar should now be visible.  Click on Edit > Links.  
  • Right click the link and select Edit > Attributes
  • Manually add the period (or space) to the value of the mls_sco_id attribute and hit save.
  • Image Added

Course Is Not Viewable By Students

There is currently an issue on 4.2.x with the importScorm command, caused by 

Jira Legacy
serverSystem JIRA
serverId23f523ea-1678-3ca2-a1e8-2de53fd3b74a
keyCOREDEV-4936
.  To fix this: 

  • After running importScorm, navigate to the course itself (final link).
  • Before changing the template to the SCORM course template as you normally do, you need to Edit > Links > Publish the link.
  • Then you can change the template to the proper SCORM template. (Edit > Page > Change Template)

Currently the SCORM templates (at least SCORM.Course.Simple.cshtml) don't seem to be aware of this and so no error is shown anywhere in the console or network trace.

Debug the Scorm Extraction (ImportScorm command)

When debugging the ImportScorm command the first break point should be set in CoreClient.Scorm.cs on line 183 (CreateManifestJSFile()). If the sco_resources count is 0, the course either has multiple child activities (which isn't supported until 4.2.x

Jira Legacy
serverSystem JIRA
serverId23f523ea-1678-3ca2-a1e8-2de53fd3b74a
keyCOREDEV-4876
), or the manifest is incorrectly made/formatted.  If this method is unable to find any sco resources, the package is improperly made, and must be checked on Scorm Cloud (see next section) and/or bounced back to the client/vendor.

Known Issues with Extraction

Recently we have seen an issue were the identifier for the <item> within an <organization> used a Guid which was too long and therefore would fail trying to find the Activity.  Adjust the identifer to something smaller and re-zip the package.  E.g.:
Image Modified


Testing the Package Externally

...