Category Archives: 1536

Updated Tools for TFS 2013

Meanwhile I updated most of my tools for TFS 2013. Here’s a list:

  • TfsClean.exe – Finds and deletes old and unused workspaces and shelvesets.
  • TfsCreateBuild.exe – Creates “fake” builds in TFS without actually running them.(e.g. can be used to store the build results from a different build system)
  • TfsExport.exe – Download files from TFVC without the need for a workspace, set modified date to last check-in date, and remove VC bindings.
  • TfsMoveDescriptions.exe – Moves text from plaintext or HTML fields to another HTML field (e.g. to copy the work item descriptions to the new System.Description field).
  • TfsRefreshWarehouse.exe – Processes the TFS Data Warehouse and Services Cube.
  • TfsReg.exe – Reads or writes values from/to the TFS registry.
  • TfsSyncIdentities.exe – Foces TFS to synchronize identities with Active Directory.
  • TfsWarehouseController.exe – Allows you to set warehouse settings (like the refresh interval).

The most convenient way to get all the tools is to download this .ZIP file: TfsToolsSuite.zip

But wait, there’s more…

Server-Side Plug-Ins:

Download all event-handlers as .ZIP file: TfsEventHandlers.zip.

TF Build Tools:

  • CreateZip.exe
  • FtpUpload.exe
  • TfbEnv.exe – Sets additional environment variables for TF Build.
  • TfbNotes.exe – Writes build report to a file.
  • TfbNuGet.exe
  • TfbSetVer.exe
  • VerifyFile.exe

Download all event-handlers as .ZIP file: TfsBuildTools.zip

Let me know if you find them useful!

–Neno

Publishing Requirements from Word to TFS (via WordToTFS)

This post is part of a blog series:

Steps:

  1. Download and install the freeware tool AIT WordToTFS from here (registration required).

    WordToTFS - ClickOnce installation 

  2. Start Microsoft Word (winword.exe). You should see a new "WordToTFS" ribbon.

    WordToTFS - Ribbon

  3. Choose the layout template you want to use (the names correspond to TFS process templates, but it’s possible to furhter customize those layout templates).

    WordToTFS - Choosing the layout template

  4. Once, you are ready to publish, click ‘Connect‘ on the ‘WordToTFS’ ribbon and choose a team project to connect to.

    WordToTFS - Connect to TFS

  5. Start by creating an outline, headlines, introduction text as you would normally do when creating a requirements document in MS Word.

  6. Once you are ready to add a requirement, choose "Empty Product Backlog Item" (in the case of the "Visual Scrum Scrum" template; the name differs for other process template, e.g. "Requirement" in MSF/CMMI or "User Story" for MSF/Agile).

    WordToTFS - Creating a new requirement in the word document

  7. This will insert a table with the typical fields to describe a requirement. Replace ‘Title’ and ‘Description’ with appropriate values (you can edit those defaults by clicking "Edit Default Values" on the ribbon).

    WordToTFS - Requirement according to the selected layout template

  8. Repeat Steps 5 to 7 for additional requirements.

  9. Once you’re happy with your requirement(s), click ‘Publish‘ in the ‘WordToTFS’ ribbon.

    WordToTFS - Publish 

    WordToTFS - Saving work items in TFS


    WordToTFS - Publishing results
  10. The work item is now created in TFS.
    After publishing the requirement table looks smilar to this:

    WordToTFS - Default work item layout in MS Word 

Notes:

  • Keep in sync: After initially publishing your work items you can either change those in MS Word and re-publish those changes, or change the work items with a different TFS client and click ‘Refresh’ on the ‘WordToTFS’ ribbon to import those changes into your MS Word document.

    WordToTFS - Keeping your document in sync using Refresh 

  • Images: You can insert images in the description field (if the process template is using an HTML-based field) and those will be updated as attachments:

    SupportForImages
  • Test Cases with Test steps: You can enter a numbered list of steps for a Test Case, which will be translated to test steps (as they are required by Microsoft Test Manager):

    SupportTestCases01

    SupportTestCases02

Disclaimer: This MS Word integration is not part of Visual Studio or Team Foundation Server. The plug-in was developed by a Microsoft Partner (AIT) and not by Microsoft itself.

Exporting TFS Work Items to Microsoft Word (via WordToTFS)

This post is part of a blog series:

Steps:

  1. Download and install the freeware tool AIT WordToTFS from here (registration required).


    WordToTFS - ClickOnce installation

  2. Start Microsoft Word (winword.exe). You should see a new "WordToTFS" ribbon.


    WordToTFS - Ribbon 

  3. Choose the layout template you want to use (the names correspond to TFS process templates, but it’s possible to furhter customize those layout templates).


    image_thumb4 

  4. Click ‘Connect‘ on the ‘WordToTFS’ ribbon and choose a team project to connect to.


    WordToTFS - Connect to TFS 

    If the "missing mapping fields" dialog appears, you probably choose the wrong layout template (you can still change it before the next steps). 

  5. Click ‘Get Work Items" from the ribbon.

  6. On the ‘Get Work Items’ pane to the ride, select a stored query.

    WordToTFS - Get Work Items

  7. Click on ‘Find‘ button.
    Optionally, deselect work items in the list if you want to exclude them.

  8. Click on ‘Import‘ button.


    WordToTFS - Importing Work Items


    WordToTFS - Work Items in an MS Word document
  9. Enjoy!

 

Disclaimer: This MS Word integration is not part of Visual Studio or Team Foundation Server. The plug-in was developed by a Microsoft Partner (AIT) and not by Microsoft itself.

Update for TFS 2010 (RTM version) including all hot fixes

Get your TFS current: All hotfixes bundled in one updateMicrosoft released an update (KB 983578) for:

  • Team Foundation Server 2010
  • All Team Foundation Server 2010 clients (aka Team Explorer)

It’s the same update package that will update the client and server components.

What’s in that upgrade?

According to Brian Harry and the KB article:

Enables Visual Studio 2010 Lab Management functionality

  • Improves performance for Lab Management Workflow Wizard.
  • Improves performance for running automated test cases on Network Isolated Lab environments.
  • Fixes an issue in which a Test Controller service account that is the same as a Lab Service account causes issues with environment capabilities.
  • There is a new Expression Encoder 4.0 based Video Diagnostic data adapter to collect video recording when you perform tests. This diagnostic adapter replaces the Windows Media Encoder base video diagnostic adapter.
Install/Upgrade
  • Labels created in TFS2008 do not contain items after migration to TFS 2010 under certain rename/delete conditions.
  • TFS Cannot be re-installed (ATOnly) targeting a database that was patched before.
  • Tfs2010Beta2ToRTM operation is not executed when RC database is upgraded by post RTM server (RTM + Patch1 or SP1).
TFS Build
  • VS2008 “smart device” projects pick up the 2010 MSTEST rather than the 2008 one.
  • Unavailable build agents are pinged indefinitely rather than giving up after an hour.
  • Duplicate changeset listings in build report.
  • Test results for VS2008 solution not published in case of a failed test.
  • Cannot delete build drops if a controller goes down
  • Open Process File Location” grayed out on menu- right click on a build definition when connected to a TFS 2008 server
Version Control
  • Branch from label has been removed in TFS 2010 – now it’s back.
  • Convert folder to branch on a hierarchy root folder with children and cycle renames crashes VS.
  • Unshelve reports bogus errors about a null DownloadUrl when dependent renames are shelved and child item names overlap.
  • Incorrect query plan on QueryPendingChanges when querying all users pending changes can lead to bad performance.
  • merge /discard in both directions causes unnecessary “empty” merges in future merge attempts.
  • Issue in merge causes a conflict not to be generated when there is a rename in the target and source.
  • Overly aggressive automatic detection of file encoding can result in inappropriate encoding mismatches during merges.
Work Item Tracking
  • Work item queries containing references to deleted fields can cause a red X on the work items node.
Team Web Access
  • Firefox Browser: "Link Selected Items to a New Work Item" and other dialogs don’t launch pages successfully
  • Chrome Browser: Adding an attachment doesn’t work
  • Chrome Browser: Select Query Dropdown doesn’t work in Choose Work Items window
  • Chrome Browser: Retain/Delete a build in Build Report page will get an exception “Unexpected callback response”
  • Query Picker Web Part Incorrectly Renders List Items (Rows) in List View (Overflow DIVs) within WebKit-based Browsers (including Safari, Chrome, etc)

Where should I apply the upgrade?

TFS component: Applies to:
TFS Application Tier Yes
TFS Data Tier (SQL Server) No
Team Explorer 2010 Yes
Visual Studio 2010 Yes
Visual Studio 2005/2008 No
Microsoft Test Manager (MTM) Yes
TFS Build Controller Yes
TFS Build Agent Yes
TFS Test Controller Yes
TFS Test Agent Yes
TFS Lab Agent Yes
System Center Virtual Machine Manager (SCVMM) No
SQL Server Reporting Services No
SQL Server Analysis Services No
SharePoint/WSS No

Download the update package now.

Frequently asked questions

  • Should I install the update although I do not use Lab Management?
    Yes, it contains all TFS fixes that have been made since TFS 2010.
  • Is this a Service Pack?
    No.
  • If I reinstall or add TFS components later, do I have to reapply this patch?
    Yes.
  • Should I stop TFS service prior to installing?
    No, this is not necessary and will be done automatically by the update.

Tool for creating direct links to TSWA

Buck Hodges from Microsoft blogged about all the possible links you can construct to point to TSWA pages.

For example the following URL opens the Work Item Editor:

Open the existing work item with ID 1234: http://mytfs:8090/wi.aspx?id=1234

To make it simple I created a small tool that helps you construct those URLs in an easy way:

Team System Web Access Link Creator

You can download the source from here:

File Attachement: WebAccessLinkCreator.zip

Reports for measuring TFS performance

Monitoring TFS performance with reportsGrant Holliday, who runs the busiest TFS at Microsoft, posted 6 handy reports you can easily import into your TFS to monitor system performance.

"We have a responsibility to ensure that the server is performing as expected and to identify any efficiencies that can be made in the server or the tools.  To do this, we have created a number of reports that we use ourselves and make available to our own users."

Link: Read the full story and download the Report Pack.

 

 

Measure TFS Performance

Q: Can I install SP3 for SQL Server 2005 on my TFS?

Answer: Yes, you are free to do so.

Microsoft has done “functional, perf and stress testing” on TFS 2008 SP1 on SQL Server 2005 SP3 to ensure it works properly.

Additionally we installed and tested it on our TFS instances without any issues.

Note: Be aware that the installation takes some time (~ 10-25 minutes depending on your hardware) and it requires a reboot.

Download: SP3 for SQL Server 2005

Image-0010

TFS Branching Guide 2.0

TFS Branching Guide - Diagrams 2.0

Original announcement:

Since the first release, we have received lots of feedback and change requests. Most feedback indicated a desire for a more practical approach to branching compared to the first release which is more theoretical. With that in mind, we decided to reduce the conceptual part and focus on branching practices with Team Foundation Server.

What is in the package?

  • TFS Branching Guide - Main 2.0
    • This is the main article which briefly explains branching concepts and introduces 3 levels of the most common branching scenario
  • TFS Branching Guide - Scenarios 2.0
    • A collection of less common branching scenarios
  • TFS Branching Guide - Q&A 2.0
    • A set of most frequently asked questions with answers
  • TFS Branching Guide - Drawings 2.0
    • A set of branching drawings in different formats including a large branching poster
  • TFS Branching Guide - Labs 2.0
    • A couple of examples for hands on labs with step by step instruction for practicing the branching scenarios
Download: here