The Learning Locker service allows for Curatr level objects to be completed when a matching xAPI statement is received by Learning Locker. Using this service level objects could be completed by reaching a passing grade on a quiz, or reading through a Storyline file.
When the service is enabled an additional completion type will be available for all level objects:
Objects will default to Timed, with the usual behaviour of completing and awarding XP after the object has been open for View Time.
If the object is set to xAPI the object will only complete when a statement is received by the Learning Locker instance that matches the statement requirements selected for this object in Curatr.
- Content external to Curatr creates an xAPI statement based off user progress.
- Learning Locker adds this statement to it's record store.
- Learning Locker compares the statement to object completion criteria.
- If the object matches, Curatr is notified that the user has completed the object.
- Curatr marks the object complete for the user.
Enabling the Learning Locker service
The Learning Locker service needs three pieces of information to enable. This can be found in the Learning Locker organisation's Settings page, in the Clients section.
Note: A new client should be used with All option under the Overall Scopes. For further details on creating a client please refer to our Learning Locker documentation.
The Endpoint is shown at the top of the Clients page.
Key and Secret are shown when the client is expanded.
Curatr will use these settings to setup a Statement Forward in Learning Locker. If this is successful you will see a success message towards the bottom-left:
Object completion types
With the Learning Locker service enabled you will see two options available for Completion Type:
|Timed||Object completion based off view time. Learning Locker service not used.|
|xAPI||Object completion only triggered by an xAPI statement.|
If Timed is selected there will be a field below to specify the object's View Time in seconds.
When xAPI is selected the drop down below allows you to choose which statement verb will cause object completion, when the Learning Locker instance receives a statement with matching verb and activity.
Several statement properties can be checked to allow more control over if a statement will trigger object completion. Using these advanced settings you could check if user received a passing score or trigger completion from a statement not specifically referring to this object.
A statement will need to contain everything you have selected in order to trigger completion in Curatr. A partial match will not count as complete.
|Activity||statement.object.id||If checked Curatr will check statements for the object's default Curatr URL, for example: http://example.curatr3.com/courses/test-course#object/376581
To check statements for a different URL, untick this checkbox
|Completed||statement.result.completion||If checked the xAPI statement must state the activity was completed to trigger completion of the level object|
|Success||statement.result.success||If checked the xAPI statement must state the activity was successful to trigger completion of the level object|
|Score (Scaled)||statement.result.score.scaled||Entering a number here will require a statement to have a minimum score greater than this value to trigger completion. This is a percentage of the user's actual score, modified by scaling and/or normalization. This value must be between -1 and 1. For example, enter 0.5 for a minimum scaled score of 50%|
|Score (Raw)||statement.result.score.raw||Entering a number here will require a statement to have a minimum score greater than or equal to this value in order to trigger completion. For example, enter 50 for a minimum score of 50|
Using a custom activity
It is likely when using external content that you will wish to match off a statement that does not use the Curatr object URL. This is possible by changing the Activity setting described above.
Unticking the checkbox will show a field for the Activity, you should populate this with the URL used in the statement's object ID.
Here we would use http://www.example.com/activities/1 in the activity field. When Learning Locker receives a statement with this activity it will check the verb and other completion settings, and then notify Curatr of object completion.
Using completion, success and score
For content that contains a quiz or other measurement of performance it is likely that you will wish to check your users are achieving a passing grade.
If the statement contains result information this can be used in the Advanced Settings to check performance.
In this example we could compare the following Advanced Settings. Score (Raw), Success and Completed. These values will be a Score (Raw) of 12, Success is false and Completed is True.