Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GenCheckinNotesUpdateWorkItems Task

GenCheckinNotesUpdateWorkItems Task

The GenCheckinNotesUpdateWorkItems task associates changesets and work items with a specified build, and optionally updates the Microsoft.VSTS.Build.IntegrationBuild field of the work items. The associated changesets and affected work items are those that are committed or affected between the versions specified by the LastLabel and the CurrentLabel properties.

Property Description

TeamFoundationServerUrl

Specifies the Team Foundation Server URL. For example, http://MyServer:8080.

BuildId

Specifies the Team Foundation Build build number.

CurrentLabel

Specifies the version number label to which the changesets and work items are associated. Typically this is the label of the sources used in the current build.

LastLabel

Specifies the starting version number label from which the changesets and work items are associated. Typically this is the label of the sources used in the previous build.

UpdateWorkItems

Boolean property that specifies whether the Microsoft.VSTS.Build.IntegrationBuild of the associated work items should be updated with the build number. For more information about the Microsoft.VSTS.Build.IntegrationBuild, see Adding Integration Fields in Work Item Types.

The GenCheckinNotesUpdateWorkItems task is defined in the Microsoft.TeamFoundation.Build.Tasks.VersionControl.dll. The Microsoft.TeamFoundation.Build.targets file contains an instance of the GenCheckinNotesUpdateWorkItems task that Team Foundation Build uses as a default implementation for the GetChangeSetsAndUpdateWorkItems target. You can also customize the build process by defining a different instance of the GenCheckinNotesUpdateWorkItems task for a build type in the TfsBuild.proj file. For more information about how to customize a task, see How to: Modify the Scope of Changesets and Work Items Associated With a Build Type.

The Microsoft.TeamFoundation.Build.targets file is stored in the <root>:\Program Files\MSBuild\Microsoft\VisualStudio\v8.0\TeamBuild folder on the Team Foundation Build computer.

The following example shows the default instance of the GenCheckinNotesUpdateWorkItems task as defined in the Microsoft.TeamFoundation.Build.targets file.

<GenCheckinNotesUpdateWorkItems
    TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
    BuildId="$(BuildNumber)"
    CurrentLabel="L$(BuildNumber)$(LabelQueryScope)"
    LastLabel="L$(LastGoodBuildNumber)$(LabelQueryScope)"
    UpdateWorkItems="$(UpdateAssociatedWorkItems)"
    ContinueOnError="true" />

Community Additions

ADD
Show:
© 2015 Microsoft