Create your backlog and tasks using Project
VSTS | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013
If Office Project is your preferred tool for tacking projects, you can use it to create your backlog, schedule tasks, assign resources, and track work that is also tracked in VSTS or Team Foundation Server (TFS). You can use Project while your development team uses the tools they prefer, all while sharing information transparently.
Use this topic to learn how to:
- Connect a Project plan to a team project
- Add tasks to Project and publish them as work items to VSTS or TFS
- Indent tasks to create parent-child links
- Link tasks to create predecessor-successor links
- View how Project columns map to work item fields
You can also manage projects using Project Professional and Project Server synchronized with TFS , but you can't use Project Professional to both publish and refresh to TFS and synchronize with TFS.
Add tasks and publish work items
If you don't have Office Project 2007 or a more recent version, install it. For VSTS and TFS 2017 and later versions, you'll need Project 2010 or later version.
You can't use Office Project 365 to connect to VSTS and TFS.
If you haven't installed a version of Visual Studio (2010 or later) or the Team Foundation Server Standalone Office Integration 2015 (free), you'll need to install one of these versions to connect to a team project hosted on VSTS or an on-premises TFS.
The only way to get the Team Foundation plug-in is by installing one of the latest editions of Visual Studio or the TFS Standalone Office Integration installer. TFS Office Integration 2015 supports connection to VSTS and TFS from Excel, Project, and the PowerPoint-based storyboarding tool.
In Project, start with a blank worksheet. If you don't see the Team ribbon (or the Team menu if you use Project 2007) see step 2 or TFS-Office integration issues.
If you want to first import a list or tree of work items you've already defined, follow steps 3 and 4 under Bulk add or modify work items with Excel, Add work items. In the New list dialog, select the Query that contains the work items you want to import.
Another way to start is to open a backlog query in Team Explorer and from the context menu, choose Open Query in Microsoft Project.
Tip: If the Team ribbon no longer appears, you might need to re-enable it.
Connect to TFS and the team project that you want to plan. If you can't connect, get added as a team member.
If it's your first time connecting to TFS from Project, you might have to add the name of your TFS to the list of recognized servers.
Project is now bound to your team project. The Team Foundation Gantt view supports entry and display of several TFS fields.
Add task information and then publish the project. To add a work item, specify the Title, Work Item Type, Publish and Refresh, and any other required fields. Resize and move columns using standard Project methods.
Tip: Set the Publish and Refresh field for a task to Yes if you want to have a work item created for it in TFS. For example, set user stories, backlog items, and tasks to be published and refreshed. However, any summary tasks that you create to group tasks or to assign milestones, set Publish and Refresh to No.
Notice how IDs are now assigned to your work items.
Optionally, you can use , select a work item query, and add work items from TFS to your project plan.
Assign resources to tasks. Or, leave that field blank for the development team to assign.
Tip: Although Project supports allocation of more than one resource to a task, TFS does not. If a task requires more than one resource to complete, divide the task into subtasks and assign one resource to each subtask. Only assign a TFS team member as a resource to those tasks that you will publish.
Specify resources by their display names from Active Directory Domain Services (AD DS). If you assign a resource by its alias or other name, you risk incurring validation errors.
Save your project plan to retain scheduling and other data that TFS doesn't store.
Indent tasks to create parent-child links
When you indent tasks and then publish your plan, you create parent-child links between work items. Tasks will show up on the task board when they are assigned to the current sprint.
To see the parent-child links that you just created, open Links and Attachments.
Link tasks to create predecessor-successor links
When you link two tasks and publish your plan, TFS creates predecessor-successor links between the two work items.
Although the work tracking system tracks predecessor-successor dependencies as work item links, it does not track dependency types, lead and lag time, or other constraints that Project does.
Specify data for other VSTS/TFS fields
To enter data into other VSTS/TFS fields, switch to the Team Foundation Task Sheet.
This view displays all the VSTS/TFS fields that have been mapped to Project.
Optionally, you can add a mapped TFS field as a column to the Team Foundation Gantt view. To see which TFS fields are mapped, open Column Mappings.
To add more TFS fields or change the way fields are mapped, see Customize the Microsoft Project field mapping file. This feature is available for both on-premises TFS and cloud-hosted VSTS.
Tips for working in Project and other Team Foundation clients
You can manage your project plan using Project and all the features that Project provides. Because you and other team members can modify TFS work items from the web portal, Excel, Project, and Team Explorer, follow these tips to manage your work effectively:
Differences working in Project versus Excel
|Adding TFS fields||You can only add fields to your Project plan that are defined in the Microsoft Project mapping file.||You can add any TFS field to your Excel worksheet that is listed in the Choose Columns dialog, subject to Excel limitations on text length.|
|Publish/Refresh||You specify the Publish or Refresh field for individual tasks. Also, field attributes defined in the Microsoft Project mapping file affect how fields are published and refreshed.||All work items are subject to publish and refresh.|
|Linking||You can create and modify parent-child links or predecessor-successor links between work items.||Using the tree list view, you can create and modify parent-child links.|
If the Team ribbon fails to appear, see TFS-Office integration issues.
Delete work items
You can't delete work items from Excel. The only way to delete work items is from the web portal or the witadmin command line tool. For details, see Move, change, or delete work items .
Do you want to add Project fields to TFS work items?
For team members to be able to view or modify Project fields from a Team Foundation client, you must customize both the definition file for the task work item type and update the Microsoft Project Mapping file. For resources, see Schedule projects using Microsoft Project 2010.
Do you want to map additional TFS fields to Project, or change how fields are mapped?
You can change how Team Foundation fields map to fields in Microsoft Project, and you can change how specific fields are published. See The Microsoft Project Field Mapping File.
Project for Mac
macOS is not supported. You need to use Project on the same computer where you have installed Visual Studio or the Team Foundation Server Standalone Office Integration 2015 in order to get the Team Foundation add-in. These applications require Windows.
Feedback and support
We welcome your feedback.
Follow us on Twitter @vsts.