Share Work Items

You can use Team Web Access or Team Explorer to send the details of one or more bugs, tasks, or other types of work item in an e-mail message. 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 e-mail message. For information about how to build a query in Team Explorer, see Finding Bugs, Tasks, and Other Work Items.

In this topic

• Sending Work Items by E-mail

• Building a Hyperlink to a Work Item

Required Permissions

To perform these procedures, you must be a member of the Readers group or have your View work items in this node permission set to Allow. For more information, see Team Foundation Server Permissions.

Sending Work Items by E-mail

To send a work item by e-mail by using Team Web Access

1. In Team Web Access or Team Explorer, display a query results list. For more information, see Finding Bugs, Tasks, and Other Work Items.

2. In the query results list, perform one of the following procedures:

   Task	Procedure
   To send a single work item	(Team Web Access) Click the arrow next to a work item that you want to send, and click Email Work Item. (Team Explorer) Right-click the work item that you want to send, and then click  Send Mail with Microsoft Outlook.
   To send all work items that appear in the results list	(Team Web Access) Click Tools, and then click Email All Work Items as a List. (Team Explorer) Open the View menu, click  Open query in Microsoft Office, and then click  Send Mail with Microsoft Outlook. (Optional) Right-click a query, and then click Send Mail with Microsoft Outlook.
   To send a subset of the work items that appear in the results list	(Team Web Access) Highlight the work items, click Tools, and then click Email Selected Work Items as a List. (Team Explorer) Highlight the work items, right-click any one of those work items, and then click  Send Mail with Microsoft Outlook. Note In either application, to highlight a contiguous group of work items, press the Shift key when making your selection. To select individual work items, press the Control key when making your selections.
   To send all work items listed in a query	(Team Explorer) Right-click a query, and then click Send Query Result in Mail. (Team Explorer) Open a query, click  Open query in Microsoft Office, and then click  Send Mail with Microsoft Outlook.  An e-mail message opens that displays the query results in a table. If the query does not contain results, Team Explorer shows an error message.

3. On the To line, type the e-mail address to whom you want to send the e-mail.

   To send the work item to more than one recipient, use commas to separate the addresses.

4. Compose the message, and then click Send.

Building a Hyperlink that Opens a Work Item

To build a link that opens a work item in Team Explorer or in Team Web Access

1. Construct a link that conforms to one of the following templates:

   Team Web Access	http://ServerName:Port/Path/web/wi.aspx?id=WorkItemNumber Example: https://Server:8080/tfs/web/wi.aspx?id=9035
   Team Explorer	http://ServerName:Port/Path/WorkItemTracking/WorkItem.aspx?artifactMoniker=WorkItemNumber Example: https://Server:8080/tfs/WorkItemTracking/WorkItem.aspx?artifactMoniker=9035

   where:

   • 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.

   • Path specifies the directory location where Team Foundation Server is installed.

     Note

     Team Web Access is installed in the subdirectory labeled "web" directly below the directory where you have installed Team Foundation Server.

   • WorkItemNumber specifies the ID of the bug, task, or other work item to which you want to link.

   You can modify the work item that you open with the URL for Team Web Access. The work item that you open using the URL for Team Explorer is a Web view only.

2. Paste the link into an e-mail message, or encode it on a Web page or a software application form.

   Important

   To access work items by using this kind of link, team members must have read access to the work item database as specified in the "Required Permissions" section previously in this topic.

See Also

Concepts

Working with Team Foundation Clients

Finding Bugs, Tasks, and Other Work Items

Other Resources

Work Items and Workflow (Agile)

Work Items and Workflow (CMMI)

Sharing Work Items and Queries with Team Members