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

Last Score by Item by User Report

Shows the most recent percentage score for a single Activity and the learners' performance for each Item within.

You would want to use this to view a group of learners' performance across a particular Activity with a breakdown per Item.

Note The Items in an Activity may change from time to time, so this report can order and compare Items using either their Item reference, or using the original order in which the Items appeared in each session. See the "align_items" attribute for information on the two modes.

Scoring details

The report can be configured to calculate the overall scores 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-item-by-user",
    "display_time_spent": true,
    "display_item_numbers": true,
    "scoring_type": "partial",
    "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"}
    ],
    "activity_id": "Weekly_Math_Quiz"
}

Attributes

  • type string

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

  • id string

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

  • activity_id string

    The ID of the Activity to report on.

  • 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.

  • align_items string

    Determines which Items are returned for each session and how they are ordered in the report UI and raw data.

    Default: "reference"

    Possible values

    • "index"

      The Item nodes are shown in order of appearance for each session.

      You would want to use this when your sessions may contain a different number of Items.

      This report will scale to the session with the largest number of Items. Shorter sessions will contain blank nodes.

    • "reference"

      The Item nodes are ordered left-to-right according to the order of Items in the session of the first specified user.

      You would want to use this where each session contains the same number of Items.

      If another user's session is shorter and did not include one or more of those Items, they will contain blank nodes.

  • display_item_numbers boolean

    Controls whether Item numbers are shown in the table header above each score column. By default, these are not shown.

    Default: false

  • 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_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.