Lectora

As an xAPI conformant LRS, Watershed can receive data from any xAPI conformant Activity Provider. Many Watershed cards 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 cards 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.

This guide has 3 sections:

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 https://watershedlrs.com/xapi/lectora-online/using-lectora-online-with-watershed-10142015.

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.

Making changes

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

Data from Lectora Online courses works well with all Watershed cards, especially the Activity Card, which reports on course completion, success, time taken and score, and provides detailed question analysis. The Interactions, Activity, and Accomplishments cards do not require any special configuration for Lectora Online data so we’ll just look at the Leaderboard and Correlation cards below. The measures outlined in this guide are also relevant for other types of card.

Leaderboard

Lectora Online data about course completion, passes, time spent and scores can all be used within a Leaderboard. Where the learner takes the course multiple times, you might be interested in the first, last, best or worst attempt, or you might want an average or total. All of these measures can be used within Watershed’s Leaderboard card and you’ll likely want to create a single Leaderboard that contains the three or four measures most relevant to your organization and the particular course being analyzed.

Our demo site includes three Leaderboard cards for Lectora Online looking at time taken, score and course completions and passes respectively. This guide outlines how to set those three Leaderboard cards up. Speak to us for help setting up your own Leaderboard with the specific measures you need taken from the three Leaderboards outlined below.

Time Taken Leaderboard

The Time Taken Leaderboard ranks learners by total, average, fastest, slowest, first and most recent time taken for the course. To set it up, create a new Leaderboard card and open Advanced configuration. Replace all the configuration code with the code below.

{
  "dimension": {
    "type": "PERSON"
  },
  "measures": [
    {
      "name": "Total Time",
      "field": {
        "type": "DURATION",
        "id": "result.durationCentiseconds"
      },
      "aggregation": "SUM"
    },
    {
      "name": "Average Time",
      "field": {
        "type": "DURATION",
        "id": "result.durationCentiseconds"
      },
      "aggregation": "AVERAGE"
    },
    {
      "name": "Fastest Time",
      "field": {
        "type": "DURATION",
        "id": "result.durationCentiseconds"
      },
      "aggregation": "MIN"
    },
    {
      "name": "Slowest Time",
      "field": {
        "type": "DURATION",
        "id": "result.durationCentiseconds"
      },
      "aggregation": "MAX"
    },
    {
      "name": "First Time",
      "field": {
        "type": "DURATION",
        "id": "result.durationCentiseconds"
      },
      "aggregation": "FIRST"
    },
    {
      "name": "Most Recent Time",
      "field": {
        "type": "DURATION",
        "id": "result.durationCentiseconds"
      },
      "aggregation": "LAST"
    }
  ]
}

Now return to Simple configuration to complete the Card Text and add your course to the Activities filter. Then Save as new card.

Key questions answered: Who was the fastest? Who was the slowest?

Please note: time taken is only reported at course level, not quiz level.

Score Leaderboard

The Score Leaderboard ranks learners by average, fastest, slowest, first and most recent score for the course. To set it up, create a new Leaderboard card and open Advanced configuration. Replace all the configuration code with the code below.

{
  "dimension": {
    "type": "PERSON"
  },
  "measures": [
    {
      "name": "Average Score",
      "field": {
        "type": "DOUBLE",
        "id": "result.score.scaled"
      },
      "aggregation": "AVERAGE"
    },
    {
      "name": "Best Score",
      "field": {
        "type": "DOUBLE",
        "id": "result.score.scaled"
      },
      "aggregation": "MAX"
    },
    {
      "name": "Worst Score",
      "field": {
        "type": "DOUBLE",
        "id": "result.score.scaled"
      },
      "aggregation": "MIN"
    },
    {
      "name": "First Score",
      "field": {
        "type": "DOUBLE",
        "id": "result.score.scaled"
      },
      "aggregation": "FIRST"
    },
    {
      "name": "Most Recent Score",
      "field": {
        "type": "DOUBLE",
        "id": "result.score.scaled"
      },
      "aggregation": "LAST"
    }
  ]
}

Now return to Simple configuration to complete the Card Text and add your course or quiz to the Activities filter. Then Save as new card.

Key questions answered: Who scored the highest? Who scored the lowest?

Completion Leaderboard

The Completion Leaderboard ranks learners by number of completions, passes and failures. To set it up, create a new Leaderboard card and open Advanced configuration. Replace all the configuration code with the code below.

{
  "dimension": {
    "type": "PERSON"
  },
  "measures": [
    {
      "name": "Completions",
      "field": {
        "type": "LONG",
        "id": "result.completion"
      },
      "aggregation": "COUNT",
      "match": "true",
      "value": 0
    },
    {
      "name": "Passes",
      "field": {
        "type": "LONG",
        "id": "result.success"
      },
      "aggregation": "COUNT",
      "match": "true",
      "value": 0
    },
    {
      "name": "Fails",
      "field": {
        "type": "LONG",
        "id": "result.success"
      },
      "aggregation": "COUNT",
      "match": "false",
      "value": 0
    }
  ]
}

Now return to Simple configuration to complete the Card Text and add your course or quiz to the Activities filter. Then Save as new card.

Key questions answered: Who has completed, passes or failed the most? Who has never completed, passed or failed the course?

Correlation

As with the Leaderboard, there’s a whole range of measures that you could explore with the Correlation card. Perhaps you want to explore what factors might cause a learner to repeat a course? Maybe you want to know if learners who spend longer in the course get a higher score?

For example. you might want to look at whether or not learners who have done the course more times have faster times and higher scores in their most recent attempts than those who have not done the course so many times. Let’s look at how to set that one up; ask us if you’d like to look into any other questions about your courses.

Create a new Correlation card and open up Advanced configuration. Replace all the configuration code with the code below.

{
  "measures": [
      {
      "name": "Completion Count",
      "field": {
        "type": "LONG",
        "id": "result.completion"
      },
      "aggregation": "COUNT",
      "match": "true",
      "value": 0
    },
    {
      "name": "Most Recent Time",
      "field": {
        "type": "DURATION",
        "id": "result.durationCentiseconds"
      },
      "aggregation": "SUM"
    },
    {
      "name": "Last Score",
      "field": {
        "type": "DOUBLE",
        "id": "result.score.scaled"
      },
      "aggregation": "LAST"
    }
  ],
  "dimensions": [
    {
      "type": "PERSON"
    }
  ]
}

Now return to Simple configuration to complete the Card Text and add your course to the Activities filter. Then Save as new card.

Key questions answered: Does repeating the course lead to improved score and reduced time taken in the most recent attempt?

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

If you can't find what you need or you want to ask a real person a question, please contact customer support.