Documentation

mAuthor offers the possibility of exporting each presentation's resources individually to a package that implements the Experience API SCORM Profile. These packages can be later imported back to the platform in case of any emergency event.

Exporting

To perform the export, select the "Export xAPI/offline" option from the drop-down menu Export in the top-right toolbar. The presentation export will run in background, and you will receive a notification email when it is completed. Click on a given link, choose a name for your file, and save it to a convenient place on your computer.

Importing

Check the "Importing" section for SCORM Packages.

Package size

Check the "Page size" section for SCORM Packages.

xAPI SCORM profile package contents

Appart from the standard contents of our SCORM Packages, the xAPI package contains the following:

• tincan.js – a client library implemented by RusticiSoftware
• xapi.js – Experience API SCORM Profile implementation on top of tincan.js provided by Learnetic SA
• index.html – an example of how to embed the whole lesson and send proper xAPI statements

xAPI SCORM profile package initialization

This article defines the allowed methods of launching and initializing the xAPI SCORM Profile. Our solution provides capability to launch "Web-Based Activities" which basically allow the setup through the URL encoded parameters and "Out-of-Band Configuration" by configuring the xapi.js library itself on initialization.

The following parameters are configured by default during export:

• lessonIRI
• lessonTitle
• lessonDescription

The following parameters need to be configured by LMS using one of the methods below:

• endpoint
• actor
• courseIRI
• entry
• attemptIRI (if entry is 'resume') – see Supporting the SCORM Temporal Model
• optionally: auth or username/password
• optionally: courseTitle
• optionally: courseDescription

For more information on the above mentioned parameters, please refer to Experience API SCORM Profile, TinCan JS and the following reference on xapi.js.

xapi.js Reference

xAPI

Provides the xAPI convenience class for initialization and usage of tincan js. It helps to prepare and send xAPI statements that conform to the SCORM Experience API profile https://github.com/adlnet/xAPI-SCORM-Profile/blob/master/xapi-scorm-profile.md

• xAPI
• ~xAPI
  • new xAPI(cfg)
• ~getParams()
• ~configFromParams([cfg]) ⇒ Object
• ~initializeAttempt()
• ~saveAttemptState(state)
• ~getAttemptState(cfg)
• ~resumeAttempt()
• ~suspendAttempt(score, [state])
• ~completeAttempt(score, [state])
• ~terminateAttempt(score, [state])

xAPI~xAPI

xAPI

Kind: inner class of xAPI

new xAPI(cfg)

xAPI convenience class for initialization and usage of tincan js. It helps to prepare and send xAPI statements that conform to the SCORM Experience API profile. (https://github.com/adlnet/xAPI-SCORM-Profile/blob/master/xapi-scorm-profile.md) Constructor Initializes xAPI SCORM Profile implementation. This implementation depends on the availability of TinCanJS library (https://github.com/RusticiSoftware/TinCanJS) and has been tested with TinCanJS build 0.33.0.

xAPI~getParams()

see http://stackoverflow.com/a/2880929

Kind: inner method of xAPI

xAPI~configFromParams([cfg]) ⇒ Object

Composes cfg object trying to take values from GET params, using defaults if provided, for most values. Others such as lesson description should not be passed through GET params, due to it's length.

Kind: inner method of xAPI
Returns: Object - Config object with parameters fetched form the GET params.

xAPI~initializeAttempt()

Initializes an attempt. If no attemptIRI is provided one will be randomly generated. Sends an "initialize" statement using Statement API and updates attempt IRI table in the LRS using State API.

Kind: inner method of xAPI

xAPI~saveAttemptState(state)

Sends current lesson's attempt state for storage in the LRS using State API. Current attemptIRI that identifies this attempt is provided in cfg during initialization or randomly generated.

Kind: inner method of xAPI

xAPI~getAttemptState(cfg)

Fetch state of the current attempt. Either synchronously or asynchronousy - by providing a callback. Uses State API.

Kind: inner method of xAPI

xAPI~resumeAttempt()

Sends an "resume" statement, attemptIRI has to be provided during initialization.

Kind: inner method of xAPI

xAPI~suspendAttempt(score, [state])

Kind: inner method of xAPI

xAPI~completeAttempt(score, [state])

Kind: inner method of xAPI

xAPI~terminateAttempt(score, [state])

Kind: inner method of xAPI