Troubleshooting
Tips and error codes for troubleshooting the Items API
Items API will log error occurrences to the JavaScript console of the browser. These errors can be checked by running the following command in the console: LearnosityItems.errors.
| Error | Message for users | Message for developers |
|---|---|---|
Error code: 20013 | Requested items could not be retrieved | Make sure that every item in the items Array are existing and have been published. |
Error code: 41001 | Invalid parameter length | Ensure that your Consumer Key and Consumer Secret are correct as per those provided by Learnosity. |
Error code: 41002 | Not a valid consumer | Ensure that your Consumer Key is correct as per those provided by Learnosity. |
Error code: 41003 | Signatures do not match | Ensure that your Consumer Key and secret and domain are correct as per those provided by Learnosity, and ensure that your signature generation matches that provided in the Quick Start (SDK) or Security and Authentication section. |
Error code: 41004 | Timestamp out of valid range | Ensure that your timestamp is within a 3 hour period of current UTC Time. |
Error code: 50001 | DOM element missing | Make sure that the required DOM hooks are rendered in the page (one of each item for inline rendering type and one for Assess API for assess rendering type
See DOM hooks for more info. |
Error code: 50002 | Item not found error | Make sure that every item in the items Array are existing and have been published. |
Error code: 50003 | publishEvent() is not available | events must be enabled in the request object
See enabling events for more info. |
Error code: 50004 | Items API initialization failed | Possible Error Details:
|
Error code: 50005 | Rendering type error | The rendering_type you provided is not valid.
See rendering types for more info. |
Error code: 50006 | Adaptive error | This error can occur when fetching adaptive items. Please contact your administrator or Learnosity support |
Error code: 50007 | Public method not supported for this activity type | The public method called is not available for the loaded activity type.
See public methods for more info. |
Error code: 50008 | Cannot submit this activity type | Feedback activities cannot be submitted, use save instead.
See activity types for more info. |
Error code: 50009 | Wrong parameter type | This error is called when a public method is called with a wrong parameter type.
See public methods for more info. |
Error code: 50010 | Empty Array error | This error is called when an unexpected empty Array is passed, typically an empty items Array.
See items array for more info. |
Error code: 50011 | Unknown error | |
Error code: 50012 | Duplicate item(s) error. The following item(s) have duplicates - | This error happens when calling addItems and when one or more items are already in the activity.
See addItems for more info. |
Error code: 50013 | getTags error | Error specific to getTags public method when items tags is undefined. Make sure that request.retrieve_tags is set to true.
See retrieve_tags for more info. |
Error code: 50014 | Loading modules failed | Make sure you are connected to internet or contact your administrator. |
| Error | Message for users | Message for developers |
|---|---|---|
Error code: 20001Display: Dialog | An error occurred while fetching items. | Make sure you are connected to internet or contact your administrator. |
Error code: 20002Display: Dialog | An error occurred while initializing the idle timeout. | Make sure the initialization options for idle_timeout are correct.
|
Error code: 20003 | The version of Questions API you are using does not support getQuestions.
| Upgrade your Questions API version. |
Error code: 20004 | Adding Items is only allowed in dynamic activities. | Change the activity to dynamic, or only add items in dynamic activities. |
Error code: 20005 | Adding Items failed. The version of Questions API you are using does not support append.
| Upgrade your Questions API version. |
Error code: 20006 | The element you passed to initialize assess is not in the DOM. | Add a DOM hook that the Assess App instance can hook into. |
Error code: 20007 | Accessibility public methods disabled in Assess API configuration. | Enable the accessibility public methods in Assess API configuration. |
Error code: 20008Display: Console | An error occurred in Events API module. | Make sure you are connected to internet or contact your administrator. |
Error code: 20009Display: Dialog | Save and submit are not allowed in local_practice.
| Change the type to submit_practice.
|
Error code: 20010Display: Dialog | An error occurred while lazy loading widgets. | Make sure you are connected to internet or contact your administrator. |
Error code: 20011 | The setHeight method is only usable if scrollable_option is enabled.
| Enable the scrollable_options under the items region.
|
Error code: 20015 | Loading modules failed | Make sure you are connected to internet or contact your administrator. |
The error codes below can affect the assessment in the following ways:
- Global UI Error - this is a fatal error that will stop the Learnosity app from working and is not recoverable. Users will see an error message printed out on the screen explaining the error. They will have to try loading the assessment again or report the issue.
- Question UI Error - this is a fatal error that only applies to an individual problematic Question instance. Other Question instances are not affected and will continue to work as expected.
- Alert Only - this is a recoverable error where the user can retry their last action before the error occured. For example, failing to save due to no network connectivity.
| Error | Message for users | Error type |
|---|---|---|
Error code: 10001 | Failed validating activity / format error | Global UI Error |
Error code: 10002 | Response id conflict | Global UI Error |
Error code: 10003 | Failed authentication | Global UI Error |
Error code: 10004 | Submit / save responses failed | Alert Only |
Error code: 10005 | Response not found | Question UI Error |
Error code: 10006 | Audio save to server failed | Alert Only |
Error code: 10007 | Authorisation failed | Question UI Error |
Error code: 10008 | Audio asset failed to load | Alert Only |
Error code: 10009 | Audio asset temporarily not available | Alert Only |
Error code: 10010 | Audio asset expired | Question UI Error |
Error code: 10011 | Your device does not support audio-capture functionality | Alert Only |
Error code: 10012 | No microphone found | Alert Only |
Error code: 10013 | Unable to save, question validation failed | Alert Only |
Error code: 10014 | Audio asset format not supported | Alert Only |
Error code: 10015 | Browser not supported | Global UI Error |
Error code: 10016 | Failed capturing questions | Global UI Error |
Error code: 10017 | Failed loading Questions API, can't load required modules | Alert Only |
Error code: 10018 | Browser running in an unsupported compatibility view | Global UI Error |
Error code: 10019 | Failed validating math | Alert Only |
Error code: 10020 | Failed validating appended elements | Alert Only |
Error code: 10021 | Discard responses failed | Alert Only |
Error code: 10022 | Audio playback failed | Alert Only |
Error code: 10023 | Unable to render latex | Alert Only |
Error code: 10024 | Failed loading external resource | Alert Only |
Error code: 10025 | Failed resuming activity, network connectivity error | Alert Only |
Error code: 10026 | Cannot set response metadata on empty response | Alert Only |
Error code: 10027 | Failed pushing offline data to server | Alert Only |
Error code: 10028 | Called needs pushing with incorrect parameters | Alert Only |
Error code: 10029 | Asset could not be uploaded | Alert Only |
Error code: 10030 | Error in third-party adaptive backend | Alert Only |
Error code: 10031 | Public method called with invalid arguments | Alert Only |
Error code: 10032 | Public method was called on an app stub that was initialized without an activity object | Alert Only |