Learning-Outcomes-Report - Report-types - Reports API

Learning Outcomes Report

This is a premium feature and may not be included in your product license. For more information, reach out to your Learnosity Account Manager.

Shows a drill-down report where you can explore the results for learners, broken down by Tags (by subject, for instance).

You would want to use this to review the overall year's performance for a single learner, class, or cohort, for example.

This report can show granular results by any taggable attribute of your content such as: topic area, learning outcome, content type, difficulty, and depth of knowledge. It can also show results for intersections of those attributes, for example, scores for word-based algebraic math Questions at a beginner level.

The report uses a concept of live datasets to provide real-time score data as learner sessions are submitted.

Important This report is a premium bundle add-on. To get started using this report type, contact Learnosity Support about the Tag types you would like to use for your drill-down behavior.

Note

  • This report does not currently support multiple Item banks and is not currently integrated with any partner Item banks.
  • This report is also known as the "item-scores-by-tag-by-user" report.

See Introduction to Learning Outcomes Reporting for more information.

Related articles

Examples

// Example report configuration
{
    "reports": [
        {
            "id": "item-scores-by-tag-by-user-report",
            "type": "item-scores-by-tag-by-user",
            "items_tags_live_dataset_reference": "content-hierarchy-items-dataset-00001",
            "session_items_live_dataset_reference": "content-hierarchy-sessions-dataset-00001",
            "users": [
                {
                    "id": "user_20180417a_00001",
                    "name": "Milhouse Vanhouten"
                },
                {
                    "id": "user_20180417a_00002",
                    "name": "Bart Simpson"
                },
                {
                    "id": "user_20180417a_00003",
                    "name": "Sherri Mackleberry"
                }
            ],
            "row_tag_type": "ch_proficiency_strand",
            "column_tag_types": [
                "ch_topic",
                "ch_subtopic",
                "ch_curriculum_code"
            ],
            "item_tags": [
                {
                    "type": "ch_title",
                    "name": "content_hierarchy_001"
                }
            ]
        }
    ],
    "label_bundle": {
        "total": "Practical Math, 2nd Ed."
    }
}

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.