TFS Aggregator is an extension for Team Foundation Server (TFS) and Visual Studio Team Services (VSTS) that enables running custom script when Work Items change, allowing dynamic calculation of field values in TFS and more. (For example: Dev work + Test Work = Total Work).
You can use the Server Plugin, for TFS, or the Web Service version, for VSTS or TFS 2015 and later.
TFS Server API changed frequently in the past: the Server Plugin contains code specific for each TFS version, which means that TFS Aggregator Server Plugin binaries must be build for a specific TFS version.
See the Changelog for an history of releases.
The easiest way to deploy the Web Service version is to use the Deploy to Azure button on the repository page.
The latest Install package contains A fully automated setup for the Server Plugin.
A manual installation after building from source follows the following process:
TFSAggregator2.ServerPlugin.policies
(or rename one of the existing samples to get started) and change the example settings to your actual settings. Syntax Example.TFSAggregator2.ServerPlugin.dll
, TFSAggregator2.Core.dll
and TFSAggregator2.ServerPlugin.policies
to the plugin location on the Application Tier of your TFS ServersThat is all. TFS will detect that a file was copied in and will load it in.
We ship with an MSI installer which will automatically detect your TFS server folder.
WARNING When upgrading your TFS server you should uninstall the TFS Aggregator Server Plugin prior to the upgrade and then run the new installer when your server upgrade has completed.
You can pick development binaries directly from VSTS, asking access to the team, see CI build for details.
Is it not working? Here is the troubleshooting and how to get help page: TFS Aggregator Troubleshooting
The following table lists the TFS version supported by the Server Plugin.
TFS version | Breaking changes | Supported | Build configuration |
---|---|---|---|
2013 RTM | No | n/a | |
2013.5 | Yes | Yes | 2013 |
2015 RTM | Yes | Yes | 2015 |
2015.1 | Yes | No | 2015.1 |
2015.2 | Yes | No | 2015.2 |
2015.2.1 | No | 2015.2 | |
2015.3 | No | 2015.2 | |
2015.4 | Yes | 2015.2 | |
2017 RTM | Yes | Yes | 2017 |
2017.1 | Yes | 2017 | |
2017.2 | Yes | Yes | 2017.2 |
2017.3 | Not yet | n/a | |
201x RTM | Not yet | n/a |
We used Visual Studio Community Edition 2017 Update 2 to develop this version. In the Contributor section you will find all the details to rebuild and customize TFS Aggregator.