Troubleshooting Problems with Uploaded Training Content
KnowBe4's Uploaded Content feature allows you to upload custom training content (in SCORM or video format) so your users can take this training using KnowBe4's learner experience. The below article will assist with issues that may occur when uploading custom content to your KnowBe4 console.
If you are unable to fix the issue using the below information, we recommend you reach out to your e-learning authoring or publishing software's support team to identify what may be causing your particular issue.
Jump to:
Uploaded Content Requirements
Problems During SCORM Validation Process
User Issues With Uploaded Training
Additional Resources
Uploaded Content Requirements
Does your content meet the requirements listed on our main instructional guide? If you answer “No” to any of the questions below, please adjust your content to fit these requirements.
SCORM Packages
- Is the file SCORM 2004 4th Edition?
- Is the file 1 GB or less?
- Does the content track completion with a Complete/Incomplete or Passed/Failed functionality?
Videos
- Are you uploading a .mp4 file?
- Did you optimize your video for web streaming?
- Is the file 500 MB or less?
Problems During SCORM Validation Process
Automated Verification Errors
After uploading SCORM content to your KnowBe4 console, that content is automatically verified to ensure it meets the initial compatibility requirements of KnowBe4's learner experience. If something causes the file to be rejected, an error message will display. See the table below for more information.
If these troubleshooting steps don't resolve the issue, please contact support.
Error Message | Troubleshooting |
"We were unable to convert your video to SCORM format. Please ensure your video meets our uploaded content requirements." |
When uploading a video, it will be converted into a compatible SCORM file. This error occurs when a video file could not be converted. This error is typically caused by a corrupt video file. Please check that the video plays properly before uploading. If this video plays without issue before uploading it, try uploading the video again. |
"Video conversion was taking too long. Please try again or contact support." |
When uploading a video, it will be converted into a compatible SCORM file which could take over an hour. This error indicates the conversion process was stopped. It could mean that the video was too long or that the video was incompatible with our conversion process. Try uploading the video again. |
"You are using an older version of SCORM that we do not support. Review our uploaded content requirements and try again." |
Make sure that your file is SCORM 2004 4th Edition. |
"The imsmanifest.xml file was not found in the expected location. All associated files should be selected then zipped into an archive. Placing these files in an additional folder before zipping will change the file path." |
This error typically occurs if the SCORM package has been compressed incorrectly. Review the directory within the SCORM file and make sure it wasn’t saved in another folder before compressing. |
"Your imsmanifest.xml file is invalid or could not be parsed." | This error could be caused by a number of factors. Please contact support for troubleshooting assistance. |
"Suspicious content was found in #{filename}. Please run a virus scan before attempting to upload content again." |
During the automated verification, your file will be scanned for viruses. This error indicates a virus was found. Try running an anti-virus scan on your system, republish the file using your authoring tool, and upload it again. |
"The file type you attempted to upload is not supported. Please upload a SCORM file." | Verify that the files you are uploading match the requirements listed above. If they do, please contact support for further assistance. |
"The SCORM file you are uploading contains files with non-ASCII characters in their file names. Non-ASCII characters cannot be used in file names. Please rename your files and try again." |
Review the files within your SCORM package. Rename any files that use non-ASCII (American Standard Code for Information Interchange) characters. |
"Location Value Too Long: The provided value is longer than the maximum allowed size (255 characters)" |
If your SCORM package tracks user progress by using the Location element, it may be recording too much data. In KMSAT, the location value is limited to 255 characters. To track data that exceeds this limit, we recommend using the Suspend Data field. |
Common Allowed Validation Errors
The following table provides a list of allowed error codes that you may see when adding a language file. We allow these error codes because they do not impact the SCORM package. They will not prevent you from approving your language file during the manual review and require no additional action.
Note: For information about other SCORM error codes, see the SCORM Run-Time Reference Chart for SCORM 1.2 and SCORM 2004.
Error Message | Description |
113 Termination After Termination | Call to Terminate failed because Terminate was already called. |
133 Store Data After Termination | Call to SetValue failed because it was made after the call to Terminate. |
403 Data Model Element Value Not Initialized | Attempt to read a data model element that has not been initialized by the LMS or through a SetValue call. This error condition is often reached during normal execution of a SCO. |
Manual Review Troubleshooting
If you're unable to complete the Manual Review steps, review your publishing and completion tracking settings, as well as the size of your file, and attempt to correct the issue.
If you've republished or resized your file and your content is still not working, we recommend reaching out to your e-learning/authoring publishing software company for assistance.
My Video isn't Displaying as Expected
If your video is not working as expected, it could be because it wasn't optimized for web streaming.
To optimize your video from within your Knowbe4 console, follow these steps:
- From the Manually Review File page (click to view), click the Optimize Video link on the bottom left.
- From the page that opens (click to view), click Start to begin the optimization process.
- This process could take an hour or more depending on the size of the video.
I Can Launch My File, but Can't Click the Manual Review Checkboxes
If you cannot click one or more of the checkboxes as part of your manual review process, this means your content did not pass our automated verification process. You'll need to review the publishing and completion settings, as well as the size of your file, and attempt to correct the issue. Delete your language file and try again with an updated file.
User Issues With Uploaded Training
As a best practice, once your content is uploaded and published, you should enroll yourself in a training campaign to review the uploaded content within the KnowBe4 learner experience. When testing your content in this manner, you should also use a browser and operating system that the majority of your users will use. This allows you to mimic the conditions they will experience.
If you experience issues when testing the training in the learner experience, the potential causes could include, but are not limited to:
- Browser extensions or applications
- To test if this is the cause of your issue, we recommend attempting to test the training in a private window (Example: Incognito in Google Chrome, InPrivate Browsing in Internet Explorer) with all of your extensions turned off. You can then introduce them one by one until you determine which extension is causing the issue.
- Browser compatibility and settings
- We recommend using the latest version of a popular browser. Review our browser compatibility article here.
Additional Resources
Still need assistance? We recommend reaching out to your e-learning/authoring publishing software company for assistance. Below are links to various knowledge bases for some of these companies:
Comments
0 comments
Article is closed for comments.