IntroductionTags manager allows you to manage all your team project work item tags (rename, merge and delete) and see all your team project build tag in a central place. InstallationTo install the extension on Azure DevOps see To install the extension on Team Foundation Server (2018 or Higher)see ConfigurationAfter you install the extension in your account you are all set to go. The extension will be available to all users in the Work and Build hubs Work Item TagsThe extension will add to the Work group hub a Tags hub. If you open this hub, you will see a list of tags used on work items, each tag will have a counter with the number of work items that are referencing each tag. If you have enough permissions you will be able to rename a tag name (just click on it to activate edit mode) or delete a tag. Be careful deleting a tag is an irreversible operation and cannot be undone. MergingIf you rename a tag with a name of a tag that already exists, the conflict will be detected and you will be offered the chance to merge the tags. This will update all work items that have the source tag. The target tag (the new name that already exists) wil be added and the source tag will be removed. After the updates are done the source tag will deleted. You can optionally enter a comment, that comment will be added to all updated work items and can be visually in the history tab of the work item. This operation cannot be undone (it will have to be done manually) FilteringBesides filtering the visible tags using the search, you can also manage just a sub set of tags you can also do that. It is possible to manage a group of tags based on any criteria. That criteria is define by a (flat) work item. You can see the queries in the Queries hub (available in the Work group hub), by right clicking in the query, you can click on the Manage Tags menu entry. This will open a dialog window with all the tags used in the work items returned by the selected query.
Build TagsThe extension will add to the Build group hub a Tags hub. If you open this hub, you will see a list of tags used on build definitions. Build tags are not editable or deleteable, only the tag names will be displayed.
PermissionsBy default only team project administrators have permissions to edit or delete work item tags, if you want to grant permissions to other users/groups you will have to grant them permissions to do so. Unfortunately there is no UI to grant these permissions, you need to grant them by using tfssecurity command You will need to grant the following permissions (depending on your requirements) For example the command to grant work item tag update permissions to a group called Test in a team project called test
Unfortunately the token parameter for the tagging namespace is the team project identifier (guid) and not it's name. In order to determine a team project you will have to access the following url https://dev.azure.com/{YOURORGANIZATION}/_apis/projects/{TEAMPROJECTNAME} replace {YOURORGANIZATION} and {TEAMPROJECTNAME}) to get the team project id for the project you wish to set permissions for. To make this task easier, you can get the full command (with the guid already set) for the current team project, in the work item tags help page. Open the help page on work item tags (clicking on the ? icon) at the end of the page, there is a Permissions where tfssecurity.exe (almost) exact command are written down for the current team project (both delete and update permissions) You just need to replace the placeholder INSERT IDENTITY HERE with the identity you wish to grant permissions to (a group or a user) and execute the command on a machine where tfssecurity.exe is installed. Team Foundation ServerTeam Foundation Server 2018 or higher is supported. SupportIf you find an issue, need help or have improvement suggestions you can do so by emailing [support@yodlabs.com](support@yodlabs.com?subject=Tags Manager) with "Tags Manager" as a subject. |