Managing an item list

IMPORTANT: You must have the Item Lists permission to view the Item Lists screen. For more information, read About roles and permissions.

When you have created an item list, you can edit and manage your item list in the Item Lists screen.

This article explains how to manage your item list, including how to customise the grid columns and sort your item list.

In this article

Viewing items in the Item Lists grid

To view the Item Lists screen, go to Item Authoring > Item Lists.

TIP: For more information about Item Lists, read About the Item Lists screen.

Select an item list in the Item Lists screen to view and edit the items in that list.

IMPORTANT: Any edits to an item list do not display in a task that has already been started.

When you have selected an item list, you can view a summary of the item list’s details.

Field Description
Item List Name Displays the name of the item list.
Parent Subject Displays the item list’s associated parent subject.
Reference Displays the item list’s unique alphanumeric reference code.
Owner Displays the username of the person who created the item list.
Date Created Displays the date on which the item list was created.
Last Updated Displays the date and time the item list was last updated.
Item position defined by

Displays how the items are ordered in the item list. Items can be ordered in multiple ways:

  • Item Name – Items are ordered alphabetically by name.
  • CSV Upload – When creating an item list from a CSV, items are ordered in the order specified in your spreadsheet. For more information about creating an item list from a CSV, read Creating an item list from the Item Lists screen.
  • Last Edited By – Items are ordered by sorting on Last Edited By in the Edit List screen. For more information, read ‘Sorting multiple columns’ below.
  • Multiple sorts applied – Items are ordered by multiple sorts in the Edit List screen. For more information, read ‘Sorting multiple columns’ below.

The following table displays the default columns shown in the Item Lists grid.

Column Description
Position Displays the position of the item in the item list.
Question Type Indicates the item’s type. This includes questions, basic pages, survey items, and item sets.
Name Displays the item’s name.
Item Set – Name

Displays the name of the item set the item belongs to.

Item Set – Child Item Count

Displays the number of child items within the item set.

Subject Displays the subject that the item is associated with.
Item Lists Indicates whether the item has been added to an item list.
Subject Master List Indicates whether the item has been shared with a subject master list.
Status Displays the workflow status of the item. The default workflow statuses are: Draft, To Review, Reviewed, Live, and Withdrawn.
Last Edited By Displays the username of the person who last edited the item.
Last Edited At Displays the date and time the item was last edited.

Filtering your item list

You can customise and filter the columns shown in the grid to further refine your item list.

NOTE: All filters, sorting, page number, and item selection persist when selecting an item and returning to the results grid using the Back to Item List link.

Customising the grid columns

You can configure the columns in the grid to refine your item list. Expand the following section for information on how to customise grid columns.

Filtering your item list

You can filter the results grid column data after a search has been made. Expand the following section for information on how to filter results.

Sorting the grid columns

You can sort the columns in the grid to reorder your items. Expand the following section for information on how to sort columns.

Showing entire item sets

Items in item sets can be displayed either individually or collectively. Expand the following section for information on how to show entire item sets.

Working in the Edit List screen

Select Edit List to edit the details of your item list, import additional items to your item list, and perform multi-column searches.

Editing your item list

In the Edit List screen, you can import additional items to your item list, replace items in your item list, or update the order of the items in your item list.

Sorting multiple columns

NOTE: You can still customise and filter the columns in the grid to refine your item list in the Edit view.

Sort multiple columns in the grid to further refine the order of items in your list.

Viewing item list details

You can view and edit details about your item list in List Details.

Deleting items from your item list

You can delete items from your item list in the Edit List screen.

Viewing the tags, details, relationships, and statistics panel in the Edit List screen

The Item Lists grid displays additional information about your items.

Tags

The Tags tab displays any tag categories, tag groups, or tag values associated with the item. For more information about tags, read Using tags in items.

Select Open Tag Collections to view any tag collections associated with the item. For more information about tag collections, read Setting up subject tag collection groups.

Details

The Details tab displays information about the item, including the item ID and the total mark.

You can see the following information in the Details tab.

Details Description
ID The item’s ID.
Question Type The item’s question type.
Mark The total mark for the item.
Container The folder or item set associated with the item.
Version The version of the item.
Marking Type The item’s marking type. This can be computer-marked or human-marked.
Created By The user who created the item.
Created At The date the item was created.

Relationships

The Relationships tab displays any test form or section enemies associated with the item, if the item is part of an item set, or if the item has been shared with any subjects.

Statistics

NOTE: Statistics are generated using an external application. For more information on how to set this up, speak to your Surpass Account Manager.

The Statistics tab displays statistics related to the item list’s reliability based on items you select.

If your instance of Surpass is configured to use this functionality, you must create numeric tag groups depending on the statistics required, and input statistics for the individual items in your item list as tag values. For more information on setting up tag groups, read Setting up tag groups.

The P Value, and R Value statistics for individual items can be found in the Items Delivered report, in the Reporting screen. For more information on viewing Items Delivered reports, read Viewing Items Delivered reports.

Select your items and select Update to generate statistics.

The following statistics can be generated in the Statistics tab.

Statistic Description
Cronbach’s Alpha

Expresses the estimated reliability of the test form by calculating the internal consistency of the item list. The Cronbach’s Alpha can be any value less than or equal to 1, including negative values. The closer the value is to 1, the more reliable the test form is estimated to be.

Standard Deviation

Expresses by how much individual scores deviate from the mean.

Mean Score

Expresses the average score achieved by all candidates as a percentage.

KR20

Expresses the estimated reliability of the test form. The value can be anything less than or equal to 1, including negative values. The closer the value is to 1, the more reliable the test form. This can be applied to dichotomously scored item types such as Multiple Choice items.

P Value

Expresses item difficulty calculated by dividing the number of times an item has been answered correctly by the number of times the item has been attempted. P values are represented as a decimal number between 0 and 1. The closer the P value is to 1, the easier the item is considered to be. 

R Value

Expresses the correlation between candidate performance at item and test level. R values range between -1 and +1, with 1 indicating a positive correlation, 0 indicating no correlation, and -1 indicating a negative correlation.

TIP: Periodically update your statistic tag values from the Items Delivered report to ensure your statistics are up to date.

Select Close to return to the Item Lists screen.

NOTE: This form is to provide feedback to help improve the Surpass Help documentation only. If you need live support, contact support@surpass.com.