Search icon CANCEL
Subscription
0
Cart icon
Your Cart (0 item)
Close icon
You have no products in your basket yet
Save more on your purchases now! discount-offer-chevron-icon
Savings automatically calculated. No voucher code required.
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Conferences
Free Learning
Arrow right icon
Team Foundation Server 2015 Customization
Team Foundation Server 2015 Customization

Team Foundation Server 2015 Customization: Take your expertise to the next level by unraveling various techniques to customize TFS 2015

eBook
$24.99 $35.99
Paperback
$43.99
Subscription
Free Trial
Renews at $19.99p/m

What do you get with Print?

Product feature icon Instant access to your digital eBook copy whilst your Print order is Shipped
Product feature icon Paperback book shipped to your preferred address
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Table of content icon View table of contents Preview book icon Preview Book

Team Foundation Server 2015 Customization

Chapter 1. Creating a Dashboard and a Welcome Page

This chapter aims to guide you through creating dashboards for your team from information that exists in Team Foundation Server (TFS). We'll also take a lap around welcome pages and how they work. We will cover pinning of the following data to dashboards and how to move pinned data around on the dashboard:

  • Work item status: Here, we'll cover the pinning of work item query counts and charts
  • Recent source code changes: Here, we'll cover pinning a count of recent code changes
  • The build status: Here, we'll cover pinning charts showing the build time and if they pass or fail
  • Testing charts: Here, we'll cover pinning test related information like test status

We'll assume that you have access to TFS 2015 and have all the permissions required to create and modify various kinds of data in the team project that you are using. We'll also assume that you currently have some data that you are able to use for the samples.

What permissions do I need?

In order to pin the kind of data you want to your home page, you will need to either have Edit project-level information permissions for the project or be a Team Administrator of the team that you are trying to pin data for.

Note

Note that if you have the Edit collection-level information permissions, this will not enable you to pin data to the team's home pages.

In addition to having these permissions, you will obviously need permissions to the kind of data you want to pin, for example, work item status, testing charts, and more.

What is the Team Dashboard?

The Team Dashboard is the landing page of a team. To get there, navigate to the HOME hub in the main navigation and then the Overview tab in the subnavigation. If you have a new team that has no activity yet, your dashboard will look something like this:

What is the Team Dashboard?

Figure 1: A default empty dashboard

The top section of the dashboard will begin to light up as your team starts work. The bottom part of the dashboard is where you can pin your own tiles for information that you may find useful for your team.

Pinning work item query data

In TFS, you are able to create queries using Work Item Query Language (WIQL) over all the work items in your team project collection. From these queries, you are able to pin some information to your dashboard to surface the results of those queries. There are two types of work item query data that you can pin to your dashboard:

  • Work item query counts
  • Work item query charts

Pinning work item query counts to the dashboard

Navigate to a query and click on the little arrow to the left of the query item in the query explorer. This will pop up a context menu. Click on Pin to homepage, as shown in this screenshot:

Pinning work item query counts to the dashboard

Figure 2: Pinning a query to the dashboard

After you have clicked on Pin to homepage, you will notice that the query now has a pinned icon next to it.

Note

This is slightly different from TFS 2013, where you would add queries to Team favorites and then that would make them show up on the team's dashboard.

Now, if you navigate back to the dashboard by clicking on HOME and then on Overview (if it is not open by default already), you will notice that there is a new tile on the dashboard for this query.

Blue tiles are for queries, and they display a count of the work items returned from a particular query. These tiles are clickable and will take you to that query in the queries tab if you click on them.

Pinning work item query charts

Before we can pin a query chart to the dashboard, we need to create the chart.

Note

Currently, you can only create charts for flat-list queries.

The easiest way to do this is by clicking on the tile on the dashboard from the query that we created earlier. This will take us to the query results view. Click on Charts, as follows:

Pinning work item query charts

Figure 3: Query results

You will notice that by default, there are no charts for a query. To create a new chart, click on the New Chart button, as shown here:

Pinning work item query charts

Figure 4: Creating the first chart

This will open up the CONFIGURE CHART dialog, as shown in the following screenshot:

Pinning work item query charts

Figure 5: The CONFIGURE CHART dialog

You are able to select how the chart orders its values. Commonly, this is ordering by Value or Label. For this field I prefer using label, the main reason being that when it's pinned, it's easier to consume the information in the charts because the same label value appears in the same place in the chart. In the case where the chart would be consumed once off, it would be a better solution to sort by value.

Note

The options that show up in the drop-down lists, such as Group by in the Pie, Bar and Column charts, come from the columns that are shown in your query. So, if you have a custom field, such as Department, and you want to use that field in your chart, you will need to make sure that it is visible in the query results.

For now, we have all the columns we need, so let's select State for Group by, add by State to our title, and then click on OK, like this:

Pinning work item query charts

Figure 6: Saving a pie chart that is grouped by State

Now, we have created a chart and it shows as a saved chart for this query. From here, we can simply click on the ellipsis and then click on Pin to homepage, as shown in this screenshot:

Pinning work item query charts

Figure 7: Pinning the chart to the home page

Visually, nothing will change on this page, letting you know that it is now on the home page. However, if you click on the ellipsis again, you will see that it now says Unpin from homepage, like this:

Pinning work item query charts

Figure 8: Unpinning a chart from the home page

If we navigate back to the home page now, we will see that our chart is visible as well.

You pinned a basic query and a basic chart to the dashboard, but you can imagine with the various chart types available how much insight this can give to a team with just a glance on their dashboard. You can get more information about charts from MSDN by going to https://msdn.microsoft.com/Library/vs/alm/Report/charts.

Pinning recent code changes

I've often worked in teams in which there is a component that is important to their project, such as a framework or a regulated service, and even you would find that people often keep checking the history of such a component to see whether there have been any changes recently that may not have been communicated yet.

Luckily, with TFS, you can pin any folder from the source control to your dashboard. Navigate to the CODE hub and make sure that the Explorer tab is selected. From there, click on the arrow to the left of any folder and then click on Pin to homepage, as shown here:

Pinning recent code changes

Figure 9: Pinning code to the home page

Again, you'll notice that there is a little pinned icon next to the folder that indicates that it is pinned.

Navigating back to the dashboard, you will notice a purple tile with the count of recent code changes.

You can pin any level of your source control to your home page; for example, you can pin the entire repository (as we did earlier for our Git repository), or specific folders that you care about (say, a security library folder).

Pinning the build status

With builds, we get a much nicer pinned experience—in my opinion—than with the other areas where we can pin data. Navigate to the BUILD hub.

Now, similarly to the recent code changes in the build explorer panel on the left, click on the arrow and then click on Pin to homepage, as shown here:

Pinning the build status

Figure 10: Pinning a build to the home page

As with recent code changes, this will show you a little pinned icon next to the build item.

If we navigate back to the home page, we will now see a nice tile that shows passed/failed and the duration of builds for the pinned build.

You can pin both old XAML-style builds and the new type of builds to the dashboard.

Pinning testing charts

As with work items, test suites also have charting capabilities under the TEST hub. Navigate to the TEST hub.

From here, click on the Charts tab of any test suite, as shown in the following screenshot:

Pinning testing charts

Figure 11: The Charts tab of a test suite

You will notice that for test suites, you are able to add charts that have two kinds of data sources. One type is the test case information, which is similar to the work item information but with data that is specific to test cases, and the other type is from the test case results, which give you data such as tests passed and failed.

Pinning testing charts

Figure 12: Test case chart data option types

We can follow the same procedure as with the work item charts to pin this; just click on the ellipsis and then on Pin to homepage. Again, nothing will visually tell you that this chart is pinned, but you can navigate to the home page and you will see this very chart being displayed there.

Rearranging tiles on the home page

So far, we have pinned a bunch of tiles to the dashboard and it currently looks very messy, with gaps between some of the tiles, like this:

Rearranging tiles on the home page

Figure 13: The Team Dashboard after just pinning the tiles

Now, obviously there is a way to rearrange these items and it is simple—just drag them around. Give it a try; drag the build tile between the work item query count and recent changes tiles, and then place the work item and testing chart next to each other.

Rearranging tiles on the home page

Figure 14: Pinned tiles that can be arranged

As you can see, the rearranged tiles are a lot more effective, as there isn't a bunch of white space in between them.

Welcome pages

New to TFS 2015 are welcome pages as well. If you have used GitHub before, then you'll be familiar with markdown. GitHub does a really good job at explaining all the features of markdown at https://guides.github.com/features/mastering-markdown/. TFS uses markdown in a couple of places, one of them being its welcome pages.

Where are the welcome pages?

The welcome pages are on the teams' home pages. You can navigate to them by clicking on the HOME hub and then on the Welcome tab.

Once you are there, you will see on the left-hand side a list of all your repos for the current team project, as shown here:

Where are the welcome pages?

Figure 15: A list of repositories and default markdown page

If you have a README.md file in your repository, it will be displayed when you click on that repository. If you don't have a README.md file, a default markdown will show you what you might have there. Then, if you want to create one, you can simply click on Edit and then alter the markdown. After you have clicked on Save, a README.md file will be added to that repository.

Markdown files are a great way of creating documentation for your code. Some of the best reasons you'd want to do this are that it's easy to do and the markdown sits with your code, so it gets versioned with your code. This allows you to make comparisons in the documentation files as you would with any other code to see what has changed through various versions.

Summary

In this chapter, we took a lap around what can be pinned to a home page. We walked through pinning work item queries and charts created off work item queries to a home page. Then we looked at how to pin recent code changes, build statuses, and test case charts to the home page. Finally, we had a brief overview of what welcome pages are, what they are used for, and how we can use them.

In the next chapter, we'll be covering team boards in TFS and how we can customize them.

Left arrow icon Right arrow icon

Description

Team Foundation Server is an efficacious collaboration tools that will allow you to share code, track records, software, all in a single package. Integrate it with your existing IDE or editor and let your team work in a flexible environment that adapts to projects of all shapes and sizes. Explore what gives you the edge over other developers by knowing the tips and quick fixes of customizing TFS. Effectively minimize the time users spend interacting with TFS so that they can be more productive. In this book you will quickly cover lots of TFS extension points, from the very basic task of customizing and configuring dashboards to customizing automated builds and check-in policies. You will learn how to create dashboards in TFS 2015, as well as add tiles, graphs, and more useful modifications. You'll perform customizations that make TFS work for you by streamlining your team’s boards. You'll cast modifications to the process template and learn the tips and tricks required to make efficient and valuable uses of your team’s board. From team-specific dashboards to complex server plugins, everything is covered in this concentrated guide to aid your knowledge. Delving deep, this book covers the pros and cons of check-in policies, as well as their proper debugging and deployment strategies. After that you will learn about advanced XAML builds and TFS jobs to further experiment with the activities of your jobs on your system. Finally, you will learn about service hooks and the amazing utility of .VSO extensions to help you create new extensions and explore new levels of customization.

Who is this book for?

This book is intended for anyone with experience with TFS, and in particular, those intermediate users who want to add more value to their organization by making its TFS users more productive. The book requires basic coding skills.

What you will learn

  • Customize TFS 2015 dashboard and administer various components
  • Configure board cards, swim lanes, and columns
  • Explore the types of changes that can be made on the TFS process templates
  • Create your own custom control for the Web and client work item forms
  • Build up new checkin policies
  • Get to grips with your personal server plugins and their uses
  • Customize both XAML builds and the new build system
  • Schedule jobs for more complicated business rules to run on a schedule
  • Extend your TFS possibilities with service hooks and VSO extensions
Estimated delivery fee Deliver to Argentina

Standard delivery 10 - 13 business days

$12.95

Premium delivery 3 - 6 business days

$40.95
(Includes tracking information)

Product Details

Country selected
Publication date, Length, Edition, Language, ISBN-13
Publication date : Oct 27, 2015
Length: 208 pages
Edition : 1st
Language : English
ISBN-13 : 9781785888199
Concepts :

What do you get with Print?

Product feature icon Instant access to your digital eBook copy whilst your Print order is Shipped
Product feature icon Paperback book shipped to your preferred address
Product feature icon Download this book in EPUB and PDF formats
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
Estimated delivery fee Deliver to Argentina

Standard delivery 10 - 13 business days

$12.95

Premium delivery 3 - 6 business days

$40.95
(Includes tracking information)

Product Details

Publication date : Oct 27, 2015
Length: 208 pages
Edition : 1st
Language : English
ISBN-13 : 9781785888199
Concepts :

Packt Subscriptions

See our plans and pricing
Modal Close icon
$19.99 billed monthly
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Simple pricing, no contract
$199.99 billed annually
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts
$279.99 billed in 18 months
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts

Frequently bought together


Stars icon
Total $ 131.97
Reporting in TFS
$32.99
Team Foundation Server 2015 Customization
$43.99
Microsoft Team Foundation Server 2015 Cookbook
$54.99
Total $ 131.97 Stars icon

Table of Contents

11 Chapters
1. Creating a Dashboard and a Welcome Page Chevron down icon Chevron up icon
2. Streamlining Your Teams' Boards Chevron down icon Chevron up icon
3. Customizing Your Process Template Chevron down icon Chevron up icon
4. Enhanced Work Item Forms with Field Custom Controls Chevron down icon Chevron up icon
5. The Guide Standards for Check-in Policies Chevron down icon Chevron up icon
6. Enforcing Standards with Server-Side Plugins Chevron down icon Chevron up icon
7. Customizing the TFS Build Chevron down icon Chevron up icon
8. Creating TFS Scheduled Jobs Chevron down icon Chevron up icon
9. Service Hooks Chevron down icon Chevron up icon
10. VSO Extensions Chevron down icon Chevron up icon
Index Chevron down icon Chevron up icon

Customer reviews

Rating distribution
Full star icon Full star icon Full star icon Full star icon Empty star icon 4
(2 Ratings)
5 star 0%
4 star 100%
3 star 0%
2 star 0%
1 star 0%
Pat Delaney Jun 25, 2018
Full star icon Full star icon Full star icon Full star icon Empty star icon 4
Item works as expected and delivered on-time.
Amazon Verified review Amazon
Greg Sullivan Sep 20, 2016
Full star icon Full star icon Full star icon Full star icon Empty star icon 4
The book is a bit short on useful examples, while it is good for an overview it is not very 'in depth' for someone looking to get deeper into the api. It has some useful PowerShell scripts to help manager work items though, but using WitAdmin from powershell can be problematic, it hangs on certain tasks.
Amazon Verified review Amazon
Get free access to Packt library with over 7500+ books and video courses for 7 days!
Start Free Trial

FAQs

What is the delivery time and cost of print book? Chevron down icon Chevron up icon

Shipping Details

USA:

'

Economy: Delivery to most addresses in the US within 10-15 business days

Premium: Trackable Delivery to most addresses in the US within 3-8 business days

UK:

Economy: Delivery to most addresses in the U.K. within 7-9 business days.
Shipments are not trackable

Premium: Trackable delivery to most addresses in the U.K. within 3-4 business days!
Add one extra business day for deliveries to Northern Ireland and Scottish Highlands and islands

EU:

Premium: Trackable delivery to most EU destinations within 4-9 business days.

Australia:

Economy: Can deliver to P. O. Boxes and private residences.
Trackable service with delivery to addresses in Australia only.
Delivery time ranges from 7-9 business days for VIC and 8-10 business days for Interstate metro
Delivery time is up to 15 business days for remote areas of WA, NT & QLD.

Premium: Delivery to addresses in Australia only
Trackable delivery to most P. O. Boxes and private residences in Australia within 4-5 days based on the distance to a destination following dispatch.

India:

Premium: Delivery to most Indian addresses within 5-6 business days

Rest of the World:

Premium: Countries in the American continent: Trackable delivery to most countries within 4-7 business days

Asia:

Premium: Delivery to most Asian addresses within 5-9 business days

Disclaimer:
All orders received before 5 PM U.K time would start printing from the next business day. So the estimated delivery times start from the next day as well. Orders received after 5 PM U.K time (in our internal systems) on a business day or anytime on the weekend will begin printing the second to next business day. For example, an order placed at 11 AM today will begin printing tomorrow, whereas an order placed at 9 PM tonight will begin printing the day after tomorrow.


Unfortunately, due to several restrictions, we are unable to ship to the following countries:

  1. Afghanistan
  2. American Samoa
  3. Belarus
  4. Brunei Darussalam
  5. Central African Republic
  6. The Democratic Republic of Congo
  7. Eritrea
  8. Guinea-bissau
  9. Iran
  10. Lebanon
  11. Libiya Arab Jamahriya
  12. Somalia
  13. Sudan
  14. Russian Federation
  15. Syrian Arab Republic
  16. Ukraine
  17. Venezuela
What is custom duty/charge? Chevron down icon Chevron up icon

Customs duty are charges levied on goods when they cross international borders. It is a tax that is imposed on imported goods. These duties are charged by special authorities and bodies created by local governments and are meant to protect local industries, economies, and businesses.

Do I have to pay customs charges for the print book order? Chevron down icon Chevron up icon

The orders shipped to the countries that are listed under EU27 will not bear custom charges. They are paid by Packt as part of the order.

List of EU27 countries: www.gov.uk/eu-eea:

A custom duty or localized taxes may be applicable on the shipment and would be charged by the recipient country outside of the EU27 which should be paid by the customer and these duties are not included in the shipping charges been charged on the order.

How do I know my custom duty charges? Chevron down icon Chevron up icon

The amount of duty payable varies greatly depending on the imported goods, the country of origin and several other factors like the total invoice amount or dimensions like weight, and other such criteria applicable in your country.

For example:

  • If you live in Mexico, and the declared value of your ordered items is over $ 50, for you to receive a package, you will have to pay additional import tax of 19% which will be $ 9.50 to the courier service.
  • Whereas if you live in Turkey, and the declared value of your ordered items is over € 22, for you to receive a package, you will have to pay additional import tax of 18% which will be € 3.96 to the courier service.
How can I cancel my order? Chevron down icon Chevron up icon

Cancellation Policy for Published Printed Books:

You can cancel any order within 1 hour of placing the order. Simply contact customercare@packt.com with your order details or payment transaction id. If your order has already started the shipment process, we will do our best to stop it. However, if it is already on the way to you then when you receive it, you can contact us at customercare@packt.com using the returns and refund process.

Please understand that Packt Publishing cannot provide refunds or cancel any order except for the cases described in our Return Policy (i.e. Packt Publishing agrees to replace your printed book because it arrives damaged or material defect in book), Packt Publishing will not accept returns.

What is your returns and refunds policy? Chevron down icon Chevron up icon

Return Policy:

We want you to be happy with your purchase from Packtpub.com. We will not hassle you with returning print books to us. If the print book you receive from us is incorrect, damaged, doesn't work or is unacceptably late, please contact Customer Relations Team on customercare@packt.com with the order number and issue details as explained below:

  1. If you ordered (eBook, Video or Print Book) incorrectly or accidentally, please contact Customer Relations Team on customercare@packt.com within one hour of placing the order and we will replace/refund you the item cost.
  2. Sadly, if your eBook or Video file is faulty or a fault occurs during the eBook or Video being made available to you, i.e. during download then you should contact Customer Relations Team within 14 days of purchase on customercare@packt.com who will be able to resolve this issue for you.
  3. You will have a choice of replacement or refund of the problem items.(damaged, defective or incorrect)
  4. Once Customer Care Team confirms that you will be refunded, you should receive the refund within 10 to 12 working days.
  5. If you are only requesting a refund of one book from a multiple order, then we will refund you the appropriate single item.
  6. Where the items were shipped under a free shipping offer, there will be no shipping costs to refund.

On the off chance your printed book arrives damaged, with book material defect, contact our Customer Relation Team on customercare@packt.com within 14 days of receipt of the book with appropriate evidence of damage and we will work with you to secure a replacement copy, if necessary. Please note that each printed book you order from us is individually made by Packt's professional book-printing partner which is on a print-on-demand basis.

What tax is charged? Chevron down icon Chevron up icon

Currently, no tax is charged on the purchase of any print book (subject to change based on the laws and regulations). A localized VAT fee is charged only to our European and UK customers on eBooks, Video and subscriptions that they buy. GST is charged to Indian customers for eBooks and video purchases.

What payment methods can I use? Chevron down icon Chevron up icon

You can pay with the following card types:

  1. Visa Debit
  2. Visa Credit
  3. MasterCard
  4. PayPal
What is the delivery time and cost of print books? Chevron down icon Chevron up icon

Shipping Details

USA:

'

Economy: Delivery to most addresses in the US within 10-15 business days

Premium: Trackable Delivery to most addresses in the US within 3-8 business days

UK:

Economy: Delivery to most addresses in the U.K. within 7-9 business days.
Shipments are not trackable

Premium: Trackable delivery to most addresses in the U.K. within 3-4 business days!
Add one extra business day for deliveries to Northern Ireland and Scottish Highlands and islands

EU:

Premium: Trackable delivery to most EU destinations within 4-9 business days.

Australia:

Economy: Can deliver to P. O. Boxes and private residences.
Trackable service with delivery to addresses in Australia only.
Delivery time ranges from 7-9 business days for VIC and 8-10 business days for Interstate metro
Delivery time is up to 15 business days for remote areas of WA, NT & QLD.

Premium: Delivery to addresses in Australia only
Trackable delivery to most P. O. Boxes and private residences in Australia within 4-5 days based on the distance to a destination following dispatch.

India:

Premium: Delivery to most Indian addresses within 5-6 business days

Rest of the World:

Premium: Countries in the American continent: Trackable delivery to most countries within 4-7 business days

Asia:

Premium: Delivery to most Asian addresses within 5-9 business days

Disclaimer:
All orders received before 5 PM U.K time would start printing from the next business day. So the estimated delivery times start from the next day as well. Orders received after 5 PM U.K time (in our internal systems) on a business day or anytime on the weekend will begin printing the second to next business day. For example, an order placed at 11 AM today will begin printing tomorrow, whereas an order placed at 9 PM tonight will begin printing the day after tomorrow.


Unfortunately, due to several restrictions, we are unable to ship to the following countries:

  1. Afghanistan
  2. American Samoa
  3. Belarus
  4. Brunei Darussalam
  5. Central African Republic
  6. The Democratic Republic of Congo
  7. Eritrea
  8. Guinea-bissau
  9. Iran
  10. Lebanon
  11. Libiya Arab Jamahriya
  12. Somalia
  13. Sudan
  14. Russian Federation
  15. Syrian Arab Republic
  16. Ukraine
  17. Venezuela