Monthly Archives: September 2012

Team Foundation Task Board Enhancer: version 0.3 released

[Update: If you are here looking for a way to see blocked tasks, then take a look at version 0.6 which already has this feature]
[Update: Version 0.4 released]

[Update: Found an issue with expand/collapse all not working on Internet Explorer. Released 0.3.1 to fix this issue. Download at the bottom]

This is the third release of my TFS Task Board Enhancer, a TFS Web Access 2012, that adds some features to the task board.

I’ve blogged about version 0.2 on the post Team Foundation Task Board Enhancer: More Features and about version 0.1 on the post Team Foundation Task Board: Auto Refresh

In this version I’ve added one small feature, the ability to expand/collapse all requirements with a single click. By collapsing all the requirements will be collapsed, hiding all the cards associated with the requirements. The expand all has the reversed effect allowing you to see all cards at once.

image

please take notice that the expand all/collapse all doesn’t respect the Person filter, so things can get a little strange when used in when the Person filter is enabled.

on the previous version I’ve added the ability to add work item ids to the cards and the requirements, but the on the requirements the ids were only visible if the requirement was expanded.

image

on this version it’s also visible if the requirement is collapsed

The design of the filters was also changed so it is more consistent with Web Access.

On the previous version the filters (refresh all and maximize workspace) was visible near the tabs and enabled/disable with a checkbox. Not they have been moved into the filter zones, to be more consistent with the general UI

image

 

Feature List

To recap all features the extension has

  • Auto Refresh – Automatically refresh the board at a predetermined rate. Great to show the board on a big un attended wall board for all the team to see.
  • Maximize the workspace – removes the cruft (visual cruft) from the screen, allowing you to only see the board itself, by hiding the menus. nice to be used in conjunction with the auto refresh
  • Add work item id to the items– The work item ids are not visible on the cards or on the requirements. If you want to know the work item ids you need to open the card/requirement. This automatically adds the work item ids to the cards and requirements.
  • Expand/Collapse All – easily expand or collapse all requirements

Know Issues

If you click on a requirement (while expanded) Web Access will open the work item editor. when the editor is closed the work item id is lost (visually). This is the standard web access behavior and I’ve still haven’t found a decent workaround to recover from the fact that the work item title has been re-drawed (event if it’s not changed or saved).

How to get it?

Update: Version 0.3 had a small issue. The expand all/collapse all was not working in Internet Explorer.

This has ben fixed in version 0.3.1

Download version 0.3.1 of the extension

if you have doubts how to install it, it’s fully explained in a previous post Team Foundation Task Board: Auto Refresh

Team Foundation Task Board Enhancer: More Features

 

[Update: Version 0.3 has been released]

In a previous post (Team Foundation Task Board: Auto Refresh) I talked about how Team Foundation Server task board is missing some functionalities and how I implemented a Web Access Extension to augment it’s functionality. Version 0.1 implemented an auto refresh feature, so it could be used to display the task board in big unattended wall screen.

Even though the first version, only added the auto refresh feature, I mentioned this extension was called Task Board Enhancer because I wanted it to provide more than the auto refresh feature.

So I’m announcing version 0.2 of the task board enhancer, Which adds three more features (actually just two, another one is just a refining of the auto refresh so it doesn’t count as a feature).

New Features in version 0.2

Define the auto refresh interval

The previous version, had an hard codev refresh interval value of 30 seconds. In this version you can specify the refresh interval.

There is still no UI to configure (it doesn’t seem that bigger deal, since the auto refresh feature intention is to be used un attended anyways).

In order to define the refresh interval you have to pass the _tspRefreshInterval parameter in the query string. The value is specified in seconds. (the default value is still 30 seconds).

Maximize Workspace

Since in an un attended scenario,  we are mainly interested in viewing the task board itself, it would be interesting to remove the clutter from the screen and only see the task board itself, this is exactly what this feature does.

If you activate it, it removes the hubs entries (Home, Work,…) and the second level tab.

This is feature can be enabled on the UI

image

or by passing the parameter _tspMaximize with the value of 1

Look below how the clutter has been removed (don’t worry you can regain it by just un ticking the checkbox) and allow you to see only the task board (the burn down chart is still there)

workspace maximized

Add Work Item Ids to cards

In a previous post Adding work item ids to Team Foundation Server Board, I talked about one of the most requested features I hear, is the desire for people to have the work item id listed on the cards as part of the title.

I  mentioned I wanted to do this as an extension, but there weren’t enough hooks in the extensibility model for me to do it cleanly, so I provided a bookmarklet to do it.

The hooks are still not there, but I’ve implemented it anyways Smile.

It’s still not implemented in a clean way, but it’s implemented as an almost elegant hack. There is a small delay for the id to be visible, if you drag the card to another lane, the id will disappear and will appear again after a small delay.

Showing the work item ids on the cards

If you look at the image closely, you will noticed that in the collapsed parent work item (the horizontal lane) the work item id is not visible, it an unfortunate side effect due to a quirk in the current implementation of the task board. I’m evaluating if I can work around this behavior with an elegant hack. Perhaps in the next version.

This feature is not toggle able. It’s always enabled.Smile

 

What is next?

I still have a few more features on my backlog, but if you have any suggestions I would love to hear them.

How to get it?

Download the extension

if you have have doubts how to install it, it’s fully explained in the previous post Team Foundation Task Board: Auto Refresh

Team Companion: Free Personal Licenses giveway

 

Today Team Companion not only reached a new milestone (v 4.7) but is is also sim shipping with VS 2012.

For those who are not aware, Team Companion is an Outlook add in, that allows you to manage your TFS work item, do agile planning, see the reports and sharepoint documents (associated with a team project) right from Outlook, without having to open VS. It allows you to easily send a list of work items via email, create work items directly from an email, among a lot of other things.

It’s a tool that I’ve been using since its first version and that I recommend to all my customers.

In order to celebrate 5th anniversary (and VS launch <g>)  Ekobit is going to give away FREE personal licenses to anyone who requests.

You can read the full details the giveaway here

This blog post contains what is new in version 4.7

The giveaway bonanza starts on Wednesday, September 12th, 2012, 8:00 AM PDT (UTC -7:00) and ends on ends on Friday, September 14th at Midnight PDT (UTC -7:00).

If you are too impatient to read the full announcement and wish to grab your free license immediately, you should follow @TeamCompanion on twitter and retweet the new version announcement. TeamCompanion team will contact you with a direct message in order to obtain your details (name and email address) so it can generate the license and send it to you.

How to get a license: follow TeamCompanion on Twitter @TeamCompanion! Once you have done that, RT the announcement tweet as soon as possible. TeamCompanion team will contact you with a direct message in order to obtain information needed to create your license (name and e-mail address).

You can download http://www.teamcompanion.com/download/ and obtain more information about it at www.teamcompanion.com, take a quick tour or go into feature details.

Team Foundation Task Board: Auto Refresh

 

[Update: Version 0.3 has been released]

In a previous post I talked how you could enhance TFS task board by adding the work item ids to the cards using a bookmarklet and also mentioned several things that people usually want added to their task board (like card coloring).

In that post I didn’t mentioned a common request (was saving it for this post Smile) is the ability for the task board to be automatically refreshed.

While a automatically refresh, isn’t very interesting when used by a person, it is kind of of mandatory if you wish to have a wallboard displayed in a screen visible to the entire team.

Since this functionality isn’t available out of the box, I’ve written a Web Access Extension to add this capability to the task board.

While extensions are supported (for now only on premises version, this feature is not enabled on Team Foundation Service) they are still a black art. Writing an extension is not an easy task, since there is no public documentation yet. To be able to do it, you have to either reverse engineering or know the right people who can give an hand at this.

Extensions are executed exclusively on the client side and are written in Javascript, since 2012 Web Access supports a client side object model, so you can call practically every API that Team Foundation Server has.

There are several types of extensions but I’m not exact sure if they are formalized. with extensions you can do a lot of things (list not extensive  Smile). I’m still scratching the surface of all of this…

  • Work Item Custom Controls – You can extend work item forms with your own controls. Creating such an extension has been documented in the ALM rangers guidance – Team Foundation Server Process Template Customization Guide
  • Custom Build sections – adding custom build sections like in Team Explorer
  • Change the look & feel of pages – like using custom colors, formatting based on conditions, change CSS styles
  • Add/remove behavior from pages – like adding missing functionality or adding support for gestures for example
  • hook up custom event handlers  – like the save event for having customized validations
  • Extend of replace existing UI Controls- For example to use a different rich editor

So in order to enable auto refresh on your task board you will have to install the provided extension (I have named it Task Board Enhancer because I intend (time permitting) to add more functionality to it, the auto refresh is the first feature.

To install it, to go the admin page , by clicking on the cog icon (FIGURE 1)

image

Select the instance by clicking on “control Panel”

image

Then click on the extensions tab

image

Click on the cross to upload the extension zip file.

image

After the upload is done, you will need to enable the extension by clicking on the enable button.

image

To see the result, just go to a task board (you may need to press control F5 to force a full refresh of the javascript for the first time).

auto refresh

A new checkbox will be added (disabled by default), if you enable it will start a countdown (30 seconds for now) and then the value reaches zero, the board will be automatically refreshed.

if you wish to disable the refresh, untick the checkbox.

If you want to enable the refresh without checking the box manually, you can pass the parameter _tspRefresh with the value 1 in the url.

This can come in handy if you wish display the taskboard in a wallboard and don’t want to manually set the refresh.

For example to start Internet Explorer in kiosk mode you could do (other browsers also support similar features)

iexplore -k http://tfs.mycompany.com:8080/tfs/myTeamProject/myTeam/_board?_tspRefresh=1

(don’t form replace the text in bold with the name of your server, team project and team name (which can be omitted for the default team)

Download the extension