Response Analysis by Item Report

Shows a summary of selected responses for each Item in an assessment for a group of learners.

You would want to use this to compare the individual response selections of a learner group to a single Item in detail.

There are two views available for this report:

• The grid view allows you to quickly compare a summary of the learners' responses to each Item, as well as the scores they obtained.
• The detailed view shows the full Items, and has the ability to show each of the responses learners have given.

Important All provided sessions must contain identical Items, as matched by Item reference, Question reference(s), and Question content. The ordering of Items in the provided sessions may be shuffled within each session, as long as the set of Items is the same.

Note To exclude Items with multiple versions, contact Learnosity Support.

A dataListener callback can be used to retrieve the raw data for your own custom reporting.

Note The ordering of Items returned in the raw data for each session will respect the ordering of Items seen by each learner. The responses given by the learner must therefore be joined to their respective Item permutation by matching the sessions[].responses.items[].item_id to items[].item_id. If the users array is supplied, the ordering of sessions returned in the raw data will follow the order of the session's owner appearing in the users array. Otherwise, the sessions will be ordered by reverse chronological order of updated time.

Examples

// Example report configuration
{
    "reports": [
        {
            "id": "response-analysis-by-item-report",
            "type": "response-analysis-by-item",
            "question_source": "original",
            "session_ids": [
                "c8df0f45-2bfd-4d6c-9de1-20200224c001",
                "c8df0f45-2bfd-4d6c-9de1-20200224c002",
                "c8df0f45-2bfd-4d6c-9de1-20200224c003",
                "c8df0f45-2bfd-4d6c-9de1-20200224c004",
                "c8df0f45-2bfd-4d6c-9de1-20200224c005"
            ],
            "users": [
                {"id": "user_20200224a_00001", "name": "Milhouse Vanhouten"},
                {"id": "user_20200224c_00002", "name": "Bart Simpson"},
                {"id": "user_20200224c_00003", "name": "Sherri Mackleberry"},
                {"id": "user_20200224c_00004", "name": "Nelson Muntz"},
                {"id": "user_20200224c_00005", "name": "Terri Mackleberry"}
            ],
            "item_reference_map": [
                {"reference": "20200224_responseAnalysis_i01", "name": "Item 1"},
                {"reference": "20200224_responseAnalysis_i02", "name": "Item 2"},
                {"reference": "20200224_responseAnalysis_i03", "name": "Item 3"},
                {"reference": "20200224_responseAnalysis_i04", "name": "Item 4"},
                {"reference": "20200224_responseAnalysis_i05", "name": "Item 5"}
            ]
        }
    ]
}

Attributes

• type string

  The type of this report. Must be "response-analysis-by-item".

• id string

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

• session_ids array[string]

  An array of session IDs to include in the report.

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

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

• enable_histograms boolean

  Shows Item response histogram charts in the report. This controls the histogram charts in both the grid and detail views.

  Default: true

• item_reference_map array[object]

  An array of definitions providing human-friendly names for the Items in the sessions.

  The individual definitions include the following properties.

  • reference string

    The reference of the Item in the Item bank.

  • name string

    The human-friendly name of the Item for display purposes.

• items_order array[string]

  An array of Item references to order the Items presented in the report.

  Note Any Items which are not listed in the array will not appear in the report. If there are Items which are in the array, but are not in the report, then this will return an error.

• question_source string

  Controls whether the detailed view shows the original Item as seen by a learner or the latest version of the Item used for scoring.

  See the related Questions API initialization option and the Data API Update Item method.

  Default: "scorable"

  Possible values

  • "original" - show the Item as originally seen by the learner.
  • "scorable" - show the version of the Item currently used for scoring.

• 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