As an xAPI conformant LRS, Watershed can receive data from any xAPI conformant Activity Provider. Many Watershed reports are flexible and you can configure Watershed to display useful visualizations and metrics from almost any xAPI data set. To help you get the most out of your data, we’re working with a number of product vendors to ensure that the data they send is optimized to produce the best possible results in Watershed. We want to help you to configure Watershed reports in the best way possible to display that data.
This guide tells you how to correctly configure and publish Lectora Online courses and then configure Watershed to get the best results.
- User Types
- Any user with access to the report builder (Global Admins, Area Admins, and some Users) can create reports looking at Lectora data. Only Global Admins can create the credentials required for Lectora courses to send data to Watershed.
- Available on paid plans (Analyst, CLO, and Enterprise).
- Anybody can use this feature.
Configuring and publishing Lectora Online courses
This section outlines what you need to do within Lectora Online in order for it to produce the best data for Watershed to work with. If you have existing Lectora Online courses published without following this guidance, we recommend that you re-publish the courses following this guidance.
Important: Use the latest version
Trivantis have made important improvements to their xAPI tracking in later versions. Lectora Online automatically updates to the latest version, but if you have packages published prior to May 13th 2016, we recommend that you republish.
Give pages and objects helpful names and identifiers
The names and identifiers you use for pages and objects within Lectora Online will be reflected in Watershed reports, so it’s important to choose good names. Instead of “Untitled page”, give each page a name. Instead of “Oval Hotspot 4”, name your hotspot according to which part of the picture it’s covering. This is a little extra work, but worthwhile so you know what’s what when it comes to looking at the reports in Watershed. You can check if you’ve missed anything by looking for unclear names and descriptions in Watershed reports.
Complete the LMS course information
When publishing your course, be sure to select xAPI and complete the settings carefully.
Enter a short but helpful Activity Name and a fuller Description. Both of these may be displayed in Watershed reports. The Activity ID field is the most important. This should take the form of a web address. We recommend the format
[your organization’s website]/xapi/lectora-online/[unique course id]. For example, if we created an e-learning course titled ‘Using Lectora Online with Watershed’, it might have the id
Including the date on the end helps to ensure that the id is unique within our organization. We also recommend that you keep a record of the identifiers you use within your organization to avoid using the same one twice for similar courses. Whenever you re-publish a course you should use exactly the same identifier. If you change the identifier, Watershed will treat it as a completely new course.
If you need to make changes to a course after learners have started using it, we recommend that you make a backup of your Lectora Online project file before making any changes, that you make the changes carefully, and that you test the new version with your reports before releasing it to learners. Deleting and re-creating pages and objects could result in the identifiers of those pages and objects changing accidentally, which could adversely affect your reports.
What counts as completion?
Lectora reports attempt duration, score and success when the course is marked as complete, and the quiz score and success every time a quiz is attempted. No duration data is reported for the quiz itself as there’s no way to know how much time was spent in the quiz itself vs. other parts of the course.
Lectora is a very powerful authoring tool that enables you, the author, to determine when the course is complete. That might be when the learner gets to the end of the course, when they pass the assessment, or when some other milestone is reached. It’s important to design your course according to your desired model of completion as this will affect the data that’s reported. You should also take care to deliberately select either the course as a whole or the assessment when configuring Watershed reports, according to your particular reporting needs.
Test your courses
Be sure to test the tracking of your Lectora Online courses before sending the course to learners to ensure that the data received is as expected.
Launching Lectora Online courses
When you publish a Lectora Online course, the course does not know who the learner is or where to send the tracking data. The course has to be told this information when the course is launched by a training delivery system, normally an LMS. The training delivery system should handle collecting information about who the learner is, but you’ll need to configure it with your Watershed LRS credentials and endpoint. Exactly where these configuration settings are entered will depend on what system you are using.
See How do I add an activity provider to Watershed? for details of where to find your endpoint and credentials in Watershed. Ask us if you need help configuring your LMS or other training delivery system, or for advice on launching content without an LMS (e.g. from an e-mail, text message or QR code).
Configuring Watershed to report on Lectora Online data
Watershed's Activity Report is specifically designed for reporting on e-learning course data. It gives high level views of completion, success and time taken as well as details question response information.