Tag Guide

UBMoD has a feature that allows users and jobs to be associated with tags. These tags may then be used to filter the data that is used in the charts and tables in the UBMoD portal. It is also possible to use tags to generate charts and tables with groupings defined by tags.

User Tags

Users can be associated with tags using the "Tag Management" page. Select the desired users by clicking the checkbox in the left hand column. Enter the name of the tag into the "Tag" input (it will display a dropdown of matching tags after you have entered a few characters). Finally, click the "Add Tag to Selected Users" button to add the tag. Double-clicking the user's row will open a tab where it is possible to remove tags from the user.

Job Tags

The docs/examples directory has some examples of job tags These scripts would need to be run directly before the shredder update command. Using job tags requires updating the records' "tags" field in the event table. The tags field is a JSON encoded list of tag strings (e.g. ["tag1","tag2","project=abc123"]). The examples are intended to show possible ways to create more reports from the data that isn't currently exposed through the web interface.

Filtering by a Tag

Any tag can be used to filter the data used by the UBMoD portal. Select a tag in the Tag dropdown in the top toolbar and the current page will refresh only using the data associated with that tag. Click the "Clear Tag" button to remove the tag filter.

Note: The tag filter does not apply to "Tag Reports"

Tag Activity

The "Tag Activity" tab on the "Tag Management" page displays a list of all the tags that have been created in UBMoD and displays a table of the data associated with that tag. Double-clicking the tag opens another tab with more detailed information regarding that tag.

Key/Value Tags and Tag Reports

To generate tag reports, create multiple tags in a key=value format (e.g. Dept=Chemistry, Dept=Physics) the key will then be available in the dropdown on the "Tag Reports" page. The charts on that page display all the data for the selected tag key grouped by the tag values.

Note: Non-mutually exclusive values for a given key will result in pie charts that count the same data more than once. (e.g. if a user has been tagged with both Dept=Chemistry and Dept=Physics then the pie slices for Chemistry and Physics with both include overlapping data which may make it appear that more resources were used than actually were.)