Last-Score-by-Activity-by-User-Report - Report-types - Reports API

Last Score by Activity by User Report

Shows the most recent numeric and percentage score on one or more Activities for a group of users (learners).

You would want to use this to view learner performance of a group across multiple Activities, for example.

Scoring details

The report can be configured to calculate the overall score as the number of correct Items (dichotomous scoring), or as the sum of scores on each individual Question (partial scoring).

Examples

// Example report configuration
{
    "id": "report-5",
    "type": "lastscore-by-activity-by-user",
    "scoring_type": "partial",
    "ui": "numeric",
    "display_time_spent": true,
    "users": [
        {"id": "mce_student", "name": "Student 001"},
        {"id": "mce_student_1", "name": "Student 002"},
        {"id": "mce_student_2", "name": "Student 003"},
        {"id": "mce_student_3", "name": "Student 004"}
    ],
    "activities": [
        {"id": "Summer_Test_1", "name": "Summer Test"},
        {"id": "Weekly_Math_Quiz", "name": "Weekly Math Quiz"}
    ]
}

Attributes

  • type string

    The type of this report. Must be "lastscore-by-activity-by-user".

  • id string

    The HTML element ID where you want this report to appear.

  • activities array[object]

    An array of one or more Activity objects.

    Note If you need more than 100 Activities, contact Learnosity Support.

    The individual Activity object definitions include the following properties.

    • id string

      The ID of the Activity.

    • name string

      The name of the Activity for display purposes.

      Default: The ID of the Activity.

  • users array[object]

    An array of user (learner) definitions to include in the report.

    Note If you need more than 100 users, contact Learnosity Support.

    The individual user definitions include the following properties.

    • id string

      The ID of the user (learner).

    • name string

      The name of the user (learner) for display purposes.

  • display_time_spent boolean

    Controls whether the time spent on each Activity is shown in the tooltips for each Activity score. By default, this is not shown.

    Time spent is categorized by correct, incorrect, unattempted, unmarked and total Items.

    Note Time spent is always calculated dichotomously for the Items in each Activity, regardless of the scoring_type value set for this report. Time spent for partially unmarked Items will be reported as unmarked. For fully marked Items, time spent on partially attempted and partially correct Items will be reported as incorrect. This means a report in partial scoring mode may show a non-zero correct score, but no time spent on correct Items.

    Default: false

  • render boolean

    Renders the report on your page at the location set with the specified HTML element ID.

    You would set this property to false if you wanted to receive the raw report data only and use your own custom UI to display it.

    Default: true

  • scoring_type string

    Controls whether to show Item scores as dichotomous (right/wrong) or partial scores.

    Default: "dichotomous"

    Possible values

    • "dichotomous"
    • "partial"
  • ui string

    The user interface style for the learners' results in this report.

    Default: "bar"

    Possible values

    • "bar" - show an overall percentage value and a bar which indicates the quantity of correct, incorrect, and unattempted Items.
    • "numeric" - only show an overall percentage value.
  • ui_clickable object

    Toggle clickable styling for certain elements.

    If you listen for a click event using on(), the corresponding attribute below will be true by default.

    • user boolean

      Clickable style for user names.

    • tag boolean

      Clickable style for Tag names.

    • progress boolean

      Clickable style for progress cells.

Was this article helpful?

Did you arrive here by accident? If so, learn more about Learnosity.