adapt-xAPI

An extension to utilise The Experience API (xAPI), to collect data on human performance, stored within a suitable Learning Record Store (LRS).

Whilst the recipe used in this plugin is influenced by cmi5, this profile is not currently supported.

Configuration

Please refer to example.json for the JSON snippet which should be added to config.json.

Property	Type	Default	Description
_isEnabled	Boolean	false	Set to true to enable the extension.
_activityId	String	""	Used to populate the Activity id included in tincan.xml and for use in the Statement and State API. The value will be overriden if changed on the hosting environment.
_revision	String	""	This helps identify users running particular versions of the content, should functionality have been changed or issues found which require updates/voided statements for users running a specific revision. Where data has changed significantly, a new Activity id is recommended.
_tracking	Object	{ _storeQuestionResponses: true, _questionInteractions: true, _assessmentsCompletion: false, _assessmentCompletion: true }	_storeQuestionResponses: Restore question responses across browser sessions. _questionInteractions: Record statements for questions. _assessmentsCompletion: Record a completed statement on completion of individual assessments. _assessmentCompletion: Record a completed statement on completion of all assessments combined.
_errors	Object	See example.json	The title and body content to be displayed to the user in the event that data cannot be sent to the LRS. _isCancellable: false can be used to prevent the user from closing the error and proceeding with the course (requires fix for adaptlearning/adapt_framework#2743). The types of errors are as follows: _launch: For errors associated with a failed launch when connecting to the LRS. _lrs: For errors associated with failed communication to the LRS when using the Statement or State API. _activityId: Error to indicate the Activity id is missing and data will not be tracked.

Launch types

The plugin currently supports the ADL xAPI Launch and Rustici launch methods. The ADL xAPI Launch method is recommended for the secure transmission of data, as the Launch Server acts as a proxy between Adapt and the LRS, so the content doesn't connect or use any credentials for the LRS directly.

For security reasons, the plugin does not support hardcoded LRS authentication credentials via config.json.

For testing purposes, depending on the launch method, the ADL Launch Server credentials can be included in adl_launch.html, or the LRS authentication credentials can be included in launch.html. It is strongly recommended to remove these files for any course deliveries.

Recipe

A recipe is a standard way of expressing a particular type of action in a recorded statement. There are many ways of expressing the same action, so without a recipe, it can cause issues when analysing the data as there is no consistency in how that action is expressed.

The granular detail of what is included within each statement and how to analyse that data, is not covered in this readme. At a high-level, the plugin uses the following registered activity types and verbs:

Activity types

id	Description
http://adlnet.gov/expapi/activities/course	Defines the course model.
http://adlnet.gov/expapi/verbs/module	Defines a content page model.
http://adlnet.gov/expapi/activities/interaction	Defines a component model.
http://adlnet.gov/expapi/verbs/cmi.interaction	Defines a question component model.
http://adlnet.gov/expapi/activities/assessment	Defines an assessment article model and/or the overall assessment.

Verbs

Verb	id	Description
initialized	http://adlnet.gov/expapi/verbs/initialized	Sent once the course has been launched, to indicate the start of the session.
terminated	http://adlnet.gov/expapi/verbs/terminated	Sent once the course has been closed, to indicate the end of a session.
preferred	http://adlnet.gov/expapi/verbs/preferred	Sent to indicate a user’s language preference.
completed	http://adlnet.gov/expapi/verbs/completed	Sent once an activity within the course has been completed. As default, restricted to course and page models. Component completion can be enabled as required for each model in components.json via _recordCompletion: true.
experienced	http://adlnet.gov/expapi/verbs/experienced	Sent each time a user leaves a page.
answered	http://adlnet.gov/expapi/verbs/answered	Sent each time a question component has been answered.
passed	http://adlnet.gov/expapi/verbs/passed	Sent should a user achieve the required passmark for an assessment.
failed	http://adlnet.gov/expapi/verbs/failed	Sent should a user score below the required passmark for an assessment.

Limitations

• Does not support multiple endpoints for storing data to more than one LRS.
• Does not currently work alongside adapt-contrib-spoor due to a conflict with Adapt.offlineStorage.