Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

Run the command locally against the imsmanifest.xml to find problematic files.  Once found, rename the asset on disk, and update the imsmanifest.xml reference with the updated file name (with the offending character removed).  Re-zip and importScorm again.

File Reference Not Found During Search:

In some cases, SCORM courses built with different course creation tools may encode file names as Base64 strings. As a result, searching by file name might not return results.

Resolution: 

  1. Get the base 64 string it is usually located here "scormcontent\locales\und.js"

    Image Added

    This file contains base 64 string which looks like this: __resolveJsonp("course:und","SBase64String")
  2. Decode the Base64 string using an online tool (e.g., https://www.base64decode.org).
  3. Update the file name to include only valid characters.
  4. Re-encode the file name as Base64 and update it in the course files.

Invisible Invalid Characters in File Names:

At times, the file name might appear valid at first glance, but SCORM validation commands can flag hidden invalid characters.

For example, the sequence %E2%80%8B represents a zero-width space (Unicode character U+200B), which can cause issues. Following file contains invisible illegal character.

Image Added

Resolution:

  1. Rename the file to remove the invalid characters.
  2. Update all references to the renamed file within the SCORM package.
  3. Use the CheckScormPackageForIllegalFileNames command to identify and address such issues.

No Error (infinite loading) or "No Links Specified" in the LMS

...

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

Scorm 2004 Standards

Sometimes, when a course is repackaged for Scorm version 1.2, it may still contain Scorm 2004 pieces, almost always as xml tags in the imanifest.xml at the root of the scorm package. Example:

...