In Surpass, you can attach metadata (known as “tags”) to items and then use these tags to organise items when authoring content, creating tests, and viewing results.
Metadata in Surpass is divided into tag groups and tag values. Tag values are the metadata labels that are attached to items. Tag groups are themed containers for tag values. There are three default tag groups: Learning Outcomes, Units, and Keywords. You can create custom tag groups in Setup>Subjects. Tags are subject specific.
This article explains how to assign tag values to an item and includes information on how to set up Marked Learning Outcomes and selecting tag values from a tag hierarchy.
TIP: You can create new tag values in the Edit <tag group> dialog if Allow authors to create their own tags is enabled at the subject level. For more information, read Setting up subject tag groups.
In the Edit <tag group> dialog, use the Enter a new tag field to find a tag value. You can use the text field to search for a tag value or the menu to select a tag value from the list. Select Add Tag Value to add the tag value to the item. Select Save Changes to close the dialog.
NOTE: If item language variants are enabled, note that all language variants for an item inherit and share the default language (parent item)’s tags; adding or amending tag values on a language variant also saves the new or updated tags to the default language. If you do not have permission to edit tag values for a language variant but have permission to edit the default language, you can add or change its tag values from the default language. Read Creating and managing language variants for more information.
Setting up Marked Learning Outcomes
Marked Learning Outcomes lets markers give a numerical score to each tag value rather than the item as a whole. This allows for greater specificity in marking. Marked Learning Outcomes can be added to any human-marked item.
EXAMPLE: For an Essay item, you might want to set up Marked Learning Outcomes for ‘Quality of written language’, ‘Use of secondary sources’, and ‘Strength of argument’.
NOTE: Marks can only be added to tag values in the Learning Outcomes tag group.
First, ensure the Marking Type is set to Human in Edit Settings.
Add your tag values in the Edit Learning Outcomes dialog. Select Add Marked Learning Outcomes and give each tag value’s total mark in the Mark field.
The item’s Mark field updates to the total of each Marked Learning Outcome. This cannot edited on the item’s Edit screen. To change the item’s mark, you must edit the Marked Learning Outcomes’ Mark values.
Using tag hierarchies
Tag values can be added to your item from a tag hierarchy if a tag hierarchy has been published for your subject. Read Setting up tag hierarchies to learn about how tag hierarchies are configured.
Select Manage Tag Hierarchy to open the Manage Tag Hierarchy dialog.
NOTE: The Manage Tag Hierarchy button is only available if the subject has a published tag hierarchy.
If your subject has more than one published tag hierarchy (subjects can have up to three tag hierarchies each), select a tag hierarchy from the Select Tag Hierarchy drop-down menu.
Select the expand icon to open the next level of the tag hierarchy for the corresponding tag group.
To collapse a level, select the collapse icon .
Select a checkbox to add the corresponding tag value to your item. Tag values are selected independently; selecting a tag value does not automatically select all of that tag value’s parent tags.
NOTE: Tag values imported as part of importing items into a subject are also assigned to items independently, meaning a tag value's parent tag values are not assigned to an item along with the specified tag value. To also be assigned to an item, any parent tags must be specified as part of an import individually. For more information, read Importing items.
The tag groups and tag values selected from the hierarchy are displayed at the bottom of the dialog.
To clear all selected tag values, select Clear All.
Select Save Changes to add all selected tag values to your item.
Once added to an item, you can hover over a tag value to see from where in the tag hierarchy it is derived.
NOTE: If shortcodes are enabled, combined shortcode tag values are automatically added (contained in the combined shortcode tag group) to the item for each selected tag value. For more information, read 'Using shortcodes' in Setting up tag hierarchies.
4. Check tag values
Select a tag group’s expand icon to view associated tag values on the Edit screen.
Any tag values added from a tag hierarchy are indicated by a hierarchy icon on the tag group button.
Selecting a tag value from a tag group in a tag hierarchy opens a dialog highlighting the tag’s position within the hierarchy.
Assigned tag values from a featured tag group are displayed under the item’s name. These tag values are also displayed in the subject’s item tree, for more information read ‘Viewing featured tags’ in Managing items in a subject.
For information on setting up featured tag groups, read ‘Featuring tag groups’ in Setting up tag groups.
5. Save the item
Select Save to save your item to your subject.
WARNING: Saving changes to live items included in scheduled tests might affect candidatedelivery.
Further reading
To learn more about tags, read the following articles:
