Last Score by Tag by User Report

Shows the most recent performance on a single Activity, categorized by Tags, for a group of users (learners).

You would want to use this to identify content that was problematic for learners, get a broad view of the group's overall performance, and identify categories of knowledge that need to be revised, for example.

The report shows the percentage of correct, incorrect, and unattempted Items for each Tag in the specified Tag hierarchy. The Tag hierarchy used in this report can be considered as a grouping for an area of knowledge (Tags). The areas of knowledge presented are the immediate children of the chosen Tag hierarchy.

Scoring details

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

The report dynamically determines which Items were served during the given session(s), and calculates the percentage score for each Tag as a proportion of all Items in the session that were assigned that Tag. For example, if the session included eight Items with the math Tag, and the learner had six correct responses, the report calculates a score of 75% correct for that Tag.

Examples

// Example report configuration
{
    "id": "report-8",
    "type": "lastscore-by-tag-by-user",
    "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"}
    ],
    "activity_id": "Weekly_Math_Quiz",
    "hierarchy_reference": "DepthofKnowledge"
}

Attributes

• type string

  The type of this report. Must be "lastscore-by-tag-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.

• hierarchy_reference string

  The reference of the Tag hierarchy to show progress against.

• 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

• organisation_id integer

  The ID of the Item bank to fetch Item data and Tag content and hierarchies from. This needs to match the organisation_id used when initializing the learner sessions.

  The API consumer making the request will need to have access to the Item bank. This access can be ensured via API consumers configuration in the Learnosity Console.

  Default: The API consumer's primary organisation.

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

• tag_labels string

  Choose whether to use the Tag "name" or "description" for the labels shown in the report.

  When using "description" and a Tag does not have a description value, the Tag's name will be used instead.

  Default: "description"

  Possible values

  • "description"
  • "name"

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