Skip to content

tfsaggregator/tfsaggregator

Repository files navigation

Develop Build status

Deprecation notice

Azure DevOps Server is deprecating the old work item APIs. They are likely not going to be removed any time soon, but we can't keep supporting this plugin version forever.

Our recomendation is to migrate to aggregator-cli which can now be hosted on Azure Functions or in Docker.

We won't do any major investment in this Plugin version and our bandwidth for support is limited.

This server side plugin, for TFS 2013 update 2 up to TFS 2018.3 and Azure DevOps Server 2019, 2020, 2022 up to 2022.0.1 and 2022.1 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).

Documentation

The complete documentation is available on the project's Documentation Site.

Changelog

What's new in v2.7

  • Adds support for Azure DevOps Server 2022 RC1, RC2, and RTW, 2022.0.1 RC, 2022.0.1.

What's new in v2.6

  • Adds support for Azure DevOps Server 2020 beta, RC and RTW, 2020.1, 2020.1.1, 2020.0.1.
  • Adds support for Azure DevOps Server 2022.1 RC1

What's new in v2.5

  • Adds support for Azure DevOps Server 2019.0, 2019.0.1, 2019.1RC1, 2019.1RC1, 2019.1
  • Adds support for TFS 2018.2 and 2018.3

What's new in v2.4

  • Added support for TFS 2015.4.1
  • Added support for TFS 2017.0.1
  • Added support for TFS 2017.1
  • Added support for TFS 2017.2
  • Added support for TFS 2017.3
  • Added support for TFS 2017.3.1
  • Added support for TFS 2018
  • Added support for TFS 2018.1 RC
  • Added support for TFS 2018.1
  • Added support for TFS 2018.2
  • Fixes TemplateScope in TFS 2017 update 2 and higher
  • Added text to installer explaining the 2017u2 version works with 2017u3 as well
  • Added text to installer explaining the 2018 version works with 2018u1 as well
  • Reading and removal of Work item Links self.WorkItemLinks self.RemoveWorkItemLink
  • Global List editing with AddItemToGlobalList and RemoveItemFromGlobalList
  • Startup logging controlled by configuration file
  • New code layout, contributors are urged to read Source Code
  • Support for work-item-deleted event

What's new in v2.2

  • Support for TFS 2017
  • Macro snippets and Functions for Rules and make code more modular
  • Ability to specify server URL
  • Support for multiple workitem Ids in Console application (issue #178)
  • Ability to Send email from Rules
  • Migrated CI build from AppVeyor to VSTS
  • Use of GitVersion to manage Semantic Versioning

What's new in v2.1.1

  • Fixes important bug causing very high CPU usage (see #160).

What's new in v2.1

  • Support for TFS 2015.2, TFS 2015.2.1 and TFS 2015.3
  • Extended logging in debug version
  • Ability to override base Uri of the aggregator
  • Improvements in the setup
  • Adds PreviousRevision/NextRevision properties to Work Items to navigate history
  • Adds Uri field to Work Items
  • Removed policyscope on Workitem template GUID and revision (didn't work anyway)

What's new in v2

  • A 'real' Scripting language (C#, VB, Powershell)
  • Scoping allows select which rules apply to which Team Project
  • Enhanced filtering to trigger rules when conditions are met
  • Console application to quickly test new rules
  • Richer logging
  • Test harness and modularity to ease adding new features
  • Create new Work Items and Links using rules
  • and more...

Example Uses

  • Update the state of a Bug, PBI (or any parent) to "In Progress" when a child gets moved to "In Progress"
  • Update the state of a Bug, PBI (or any parent) to "Done" when all children get moved to "Done" or "Removed"
  • Update the "Work Remaining" on a Bug, PBI, etc with the sum of all the Task's "Work Remaining".
  • Update the "Work Remaining" on a Sprint with the sum of all the "Work Remaining" of its grandchildren (i.e. tasks of the PBIs and Bugs in the Sprint).
  • Sum up totals on a single work item (i.e. Dev Estimate + Test Estimate = Total Estimate)
  • Create new work items
  • Create new work item links

Contributing to the Project

Please read the Contributing document.