Monthly Archives: August 2011

Team Foundation Build: Reducing the amount of log of your own activities calls

 

When customizing a build definition you will soon discover that the logs may be pretty noise. Even if the activities don’t emit any logging information, just invoking an activity will result in it’s Display Name being logged.

This can be quite verbose, specially when you start nesting activities within containers.

SNAGHTML1fe2c1fe

Look at this simple (perhaps a little convoluted example) whereas a simple FTP issues too much information.

Unfortunately there is no way to disable this logging on an activity by activity basis by just using the Workflow Designer, however if you are willing to edit the build XAML in a text editor you can disable the logging by activity.

Suppose you have a sequence activity called Copy Files to FTP and you don’t want it logged

    <Sequence DisplayName="Copy Files to FTP"  >

  You just need to edit the XAML file and set the attribute BuildTrackingParticipant.Importance with the minimum level of activity you want to log

So the XAML for this snippet would become

<Sequence DisplayName="Copy Files to FTP" mtbwt:BuildTrackingParticipant.Importance="Low">

You can read all about this on more detail on this Jason’s Pricket post

But this is for activities that you use on the designer, what about code activities that you write, wouldn’t be nice to have make them less noisy when they are invoked, without requiring people to edit the XAML file manually ?

Not only would be nice, but it is also possible to do it. All you need to do is add the

Microsoft.TeamFoundation.Build.Workflow.Tracking.ActivityTracking attribute with the right level of logging.

For example with this snippet, everytime the MyActivity is invoked, the call is never logged on Team Foundation Build

    [ActivityTracking(ActivityTrackingOption.None)]
    [BuildActivity(HostEnvironmentOption.All)]     [BuildExtension(HostEnvironmentOption.Agent)]     public sealed class MyActivity : CodeActivity

This achieves the same effect as editing the XAML file to add the BuildTrackingParticipant.Importance on all calls to MyActivity

So if you are writing workflow custom activities and the fact that was called appears in the logs doesn’t add any value (for example if are writing a logger or you already log useful information), be a good citizen and add this attribute to reduce the noise.

Team Foundation Build: Enhancing the experience with built-in custom editors

bi

When designing or customizing a Team Foundation Build process template you may have parameters that are not as basic as an integer or a string. You may want to provide your user with a nice UI  to edit the values either when designing the build process template (for defining custom values for example) or queuing the build (in cases where the parameter can be defined/overridden when the build is queued).

Even when the parameters are of primitive types defined by .Net, you may want to provide a nice editor that allows easier editing for a parameter that doesn’t have a simple syntax. One example is the Team Foundation Build built-in Build Number Format editor.

image

Image 1: BuildNumber format Editor

While writing such an editor is easy, (I will not go into such details since Jason Prickett has already done a great post about it.

While writing this kind of integration is pretty easy writing the UI for object may be a somewhat tedious and long task. For example you want to reference objects stored inside TFS like a file stored in source writing the navigation can take some time.

This was exactly the situation I faced recently;  designing a complex process template in which I have (among many others) two parameters which reference a path and a file in source control.

While power users don’t mind entering $/MyTeamProject/MyProject/Trunk/ in a text box, it’s not something a regular user would want to do.

While writing the glue to Team Foundation Build is easy, writing a source control folder picker like  Browser for Folder requires some work.

image

Image 2: Browser for Folder

I would rather spend my time providing business value than writing plumbing. Since Microsoft obviously already has some code in place it would likely just be a matter of leveraging that.

There were basically two possibilities:

  1. The browser picker UI is publically available and we just have to write a few lines of gluing code to integrate it with the Team Foundation Build user experience
  2. Microsoft provides a publically accessible designer so we can just use it without having to write a single line of code.

Alas, none of these options appears to be available.

While 1) is available with some reflection hacking (see this post from Mathias Olausson)

Option two is preferred (no code is always better than some code Smile)

Not all is lost however; there is no publically available designer but there is an internal one (which means it may change in the next version but highly unlikely)

Luckily, they are implemented in Microsoft.TeamFoundation.Build.Controls assembly, which is where the UI for the builds is also stored.  So we can freely reference it the Editor Parameter in the Metadata argument to enhance our user experience. (see Jason Prickett’s post on how to do this)

So just enter Microsoft.TeamFoundation.Build.Controls.ServerFileBrowserEditor, Microsoft.TeamFoundation.Build.Controls  in the editor parameter and everything is set.

Editor parameter to specify a custom designer

Image 3: Editing the Editor parameter to specify the custom designer

When editing the build definition (or queuing if the parameter can be defined/overridden while queuing) the parameter will have an ellipsis button

image

Image 4: Ellipsis Available to use

Upon clicking on the button you will be presented with the dialog

SNAGHTMLac0fe53

Image 5: Browser Dialog

Not bad for something that takes 15 seconds to implement and greatly enhances the user experience.

Other designers included in the same assembly, that you can leverage to improve the user experience

Editor
(namespace ommited)
Description
BuildAgentSelectionEditor image Select an agent, I doubt this is useful in a build template, but there is always one strange scenario I can’t anticipate
BuildProjectListEditor SNAGHTMLade9b1f Select a project (typically a .sln or .csproj) from source control. Great if you want to build a project but it isn’t .Net so there is no platform settings baggage to carry
ServerFileBrowserEditorSNAGHTMLadf78ef Select a file in source control
TestSpecEditor SNAGHTMLadfeaf3 Select a spec of tests to run
WorkItemTypeSelectionEditor image Select a work item type
ServerFolderBrowserEditor SNAGHTMLae14d0f Select a folder in source control
StringListEditor SNAGHTMLbb501d1 Edition of a list of string.

Also allows reordering of the items

The argument should be of type List<string> or Microsoft.TeamFoundation.Build.Workflow.Activities.StringList.

EnumPropertyEditor image Shows the list of possible values of an enumerated allows you to easily select one of them

In this screenshot we are editing a argument of type Microsoft.TeamFoundation.Build.Workflow.BuildVerbosity

 

Note: Don’t forget to add the namespace (Microsoft.TeamFoundation.Build.Controls) and the assembly name also. So when you read ServerFolderBrowserEditor you should enter in the editor as Microsoft.TeamFoundation.Build.Controls.ServerFolderBrowserEditor , Microsoft.TeamFoundation.Build.Controls

If you to learn more about customizing the build parameters you can read the (faster way) this post series from Jason Prickett

If you want to read everything about builds and its process customization you can read the (slower but more complete way) Rangers Build Customization Guide

Kudos to Mike Fourie who had the patience to proofread and even enhanced this post.