The user interface is described here. The figure below shows the entire user interface.

Visualization UI.png

Usage
The following are the steps to use the interface, each section is described in detail afterwards.
  1. Select the project collection to connect to. If the one you want isn't in the list, select the Add button
  2. Once the project collection is selected, select the project you want to visualize and click Select
    1. This will populate the Work Item Queries tree and the Link Types list with the informaiton specific to that project
  3. Optional. Change the location of the output file - by default this is the root of the Documents folder for the user running the application
  4. At this point you have two options - to perform a full analysis or visualize a subset of the project.
    1. To perform a full analysis:
      1. Check the Perform Full Analysis checkbox
      2. Click Work Items
    2. To perform a selective analysis
      1. Double-click the query you want to execute in the Work Item Queries tree
      2. Select one or more work items to visualize from the resulting list on the right
      3. Select one or more link types to process in the Select Link Types list (note that Changeset and Test Results are not selected by default and are at the bottom of the list)
      4. At this point you can select Group by Iteration, Perform Dependency Analysis or click the Work Items button to visualize your results. All options are discussed elsewhere in this documentation
  5. You can also choose to perform a State visualization. To do this:
    1. Select one work item from the query results (you can choose more but only the first one is processed)
    2. Click State (the purpose and results are discussed elsewhere in this document)

Red
Connect to Project Collection - displays the registered project collections for the user. Clicking Add brings up the TFS Project Collection selection dialog
Select Project - displays all projects that you have access to. Clicking Select will populate the Work Item Queries and Links for that project
Location of output file - this is the file that the DGML will be rendered to. Clicking Browse allows you to select where you want this file (and the file name) placed

Light Blue
The treeview contains a list of queries which is identical to that shown in Team Explorer. Double-click a query to execute it. The results are displayed in the listview to the right.
The link types contains a list of all registered work item link types for the selected project - both the Forward and Reverse ends of every link except Related. Related links have the same forward and reverse end. In addition, the list also includes Changeset and Test Result which allow you to drill down into changesets and test results.

Yellow
Displays the list of work items resulting from an executed query. A couple of items to note - currently all results are returned but you cannot expand and collapse them as you can in Team Explorer. They are shown indented but only one level. There is no way to select all items at once right now. This is on the todo list.

Green
These are additional options you may choose to select.
Perform Full Analysis - this will analyze all work items in your project and all link types.
Group by Iteration - this will group all work items by iteration
Perform Dependency Analysis - this will create links in such a way as to facilitate dependency analysis. This is covered more under dependency analysis

Last edited Mar 21, 2010 at 5:00 PM by jefflevinson, version 5

Comments

jeb Jan 10, 2012 at 1:07 PM 
In many ways a great tool. However there are a few things that I miss:
- It should be possible to show only links between the selected WI's (omit links from the selected WI's to other).
- The WI number should be included on each WI on the chart.
- It seems like the color of the WI's (legend) differs from time to time?
BR,
Jørgen