Email URL links to TFS work items and queries
To share the details of one or more work items, you can email a link to a query, a table-formatted list of linked work items, or a single work item. You can perform these tasks from Visual Studio Team Services (VSTS), the web portal for Team Foundation Server (TSF), or Team Explorer.
Email a URL to a query
Copy as HTML selected query results
Email selected query results
Email a link to a work item within the work item form
Copy the URL of a work item
If you’re working from the Team Explorer plug-in for Eclipse, you’ll need to open the web portal to access these features.
Each of the first three options requires you to first create or run a work item query.
You can also use any text editor to compose a message, and you can build a hyperlink to a work item and post the hyperlink on a Web page or send in an email message.
Email a URL to a query
With this option, you capture a URL of a query written using the work item query language (WIQL). You can capture this query for any saved or unsaved query.
Open the queries page, display the query of interest, and choose Copy query URL.
.png "Copy query URL")
If you don’t see the Copy query URL option, open the Editor view.
Paste the URL into an email to share. Opening the query requires users to have read access to the team project.
To learn more about WIQL, see Query for Bugs, Tasks, and Other Work Items.
Copy as HTML selected query results
With this option, you can copy an HTML formatted table of selected items in a query result list. You can then email this list using your choice of email client.
Open a web browser and display a query results list.
Select an item or highlight several items and choose Copy as HTML.
.png "Copy as HTML selected work items")
The formatted table contains a link to each work item included in your selected results list.
Paste the contents of the clipboard into your email client. To open a linked work item, requires users to have read access to the team project or area node for those work items.
Email selected query results
To use this option, your TFS administrator must have configured an SMTP server for TFS. For VSTS users, your selected query results are emailed from the vso@microsoft.com account.
Display a query results list.
From the web portal, select an item or highlight several items and choose Email selected work items from the context menu.
.png "Email selected work items")
Or, from Team Explorer (Visual Studio), choose Send Query to Microsoft Outlook. This option requires that you configure Office Outlook on your client computer.
.png "Email query results list")
On the To line, type the user name(s) of valid users (ones who have access to the team project).
.png "Send query by email (TWA)")
Email a link to a work item within the work item form
Open the work item in your web browser and choose .png "Email work item")
.
From Visual Studio or Team Explorer, choose .png "Send work item to Microsoft Outlook"){kind=icon}
. This option requires that you configure Office Outlook on your client computer.
Copy URL to a work item
From the web portal, open the work item and right-click the link ID to copy the shortcut.
.png "Copy shortcut link to a work item")
From Team Explorer, open the shortcut menu from the open work item to copy the full path.
.png "Email a hyperlink for a work item")
The hyperlink you copy opens the work item in the web portal.
Q & A
How do I define a hyperlink that opens a work item?
A: Define a link that conforms to the following syntax:
For VSTS:
https://AccountName.visualstudio.com/DefaultCollection/TeamProjectName/_workitems/edit/WorkItemNumber
Example: https://fabrikam/DefaultCollection/Phone%20Saver/_workitems/edit/133
For on-premises TFS:
https://ServerName:Port/tfs/CollectionName/TeamProjectName/_workitems/edit/WorkItemNumber
Example: https://fabrikamprime:8080/tfs/DefaultCollection/Phone%20Saver/_workitems/edit/133
Where:
AccountName specifies the name of the VSTS account.
ServerName specifies the name of the server that is running Team Foundation Server.
Port specifies the port that Team Foundation Server uses. The default value is 8080.
CollectionName specifies the name of the team project collection.
TeamProjectName specifies the name of the team project.
WorkItemNumber specifies the ID of the bug, task, or other work item to which you want to link.
Q: How do I create alerts based on work item queries?
A: See Set alerts, get notified when changes occur.
Q: Is there a way to delete work items?
A: Yes. You can permanently remove work items from the TFS database by using the witadmin destroywi command. Work items whose state is set to Closed, Done, or Removed remain in the database and can be reactivated. Permanently removed work items can’t be restored nor reactivated.