Create your backlog and tasks using Microsoft Project

TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

If Microsoft Project is your preferred tool for tracking projects, you can use it to create and update work items. Create your backlog, schedule tasks, assign resources, and track work in Project and have it also tracked in Azure Boards or Azure DevOps Server. You can use Project while your development team uses the tools they prefer, all while sharing information transparently.

Important

Microsoft Project Integration and the TFSFieldMapping command are not supported for:

  • Visual Studio 2019 and Azure DevOps Office® Integration 2019
  • Azure DevOps Server 2019 and later versions, including Azure DevOps Services.

However, full support for Microsoft Excel integration is maintained and supports bulk import and update of work items. Alternatives to using Microsoft Project include the following:

Working in Project is similar to publishing and refreshing work items using Office Excel, with a few differences as described later in this article.

Use this article to learn how to:

  • Connect a Project plan to a project
  • Add tasks to Project and publish them as work items
  • Indent tasks to create parent-child links
  • Link tasks to create predecessor-successor links
  • View how Project columns map to work item fields

Prerequisites

For TFS 2017 and TFS 2018:

For TFS 2013 and TFS 205:

To learn more about compatibility requirements, see Azure DevOps client compatibility.

Add tasks and publish work items

  1. If you don't have Office Project 2010 or a more recent version, install it.

  2. If you haven't installed a version of Visual Studio (2010 or later) or Team Foundation Office Integration (free), you'll need to install one of these to connect to an Azure DevOps project.

    Note

    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 Azure Boards and TFS from Excel, Project, and the PowerPoint-based storyboarding tool.

  3. In Project, start with a blank worksheet. If you don't see the Team ribbon see step 2 or Azure DevOps-Office integration issues.

    Tip

    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.

    Connect to a project from Project

    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.

  4. Connect to Azure Boards or TFS and the project that you want to plan. If you can't connect, get added as a team member.

    Connect to Team Foundation Server dialog

    If it's your first time connecting from Project, you might have to add the URL of Azure Boards or the name of your TFS instance to the list of recognized servers.

    Azure Boards

    (1) Choose Servers..., (2) choose Add..., (3) enter the URL of your Azure Boards organization, (4) check that the preview matches the URL that you entered, and then choose OK.

    Connect to Team Foundation Server dialog in Boards.

    TFS

    (1) Choose Servers..., (2) choose Add..., (3) enter the name of your TFS instance. As needed, change the Port number if your deployment uses a non-default port number. The Preview entry should display the correct URL for your deployment. (4) Choose OK.

    Connect to Team Foundation Server dialog in TFS.

    Choose Close to close the Add/Remove servers dialog. From the Select a Team Foundation Server dialog, make sure the server you added is selected, and then choose Connect.

    Project is now bound to your project. The Team Foundation Gantt view supports entry and display of several work tracking fields.

    Project plan bound to a project

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

    Enter task data

    Notice how IDs are now assigned to your work items.

    Published tasks become work items

    Optionally, you can use Get work items icon, select a work item query, and add work items to your project plan.

  6. Assign resources to tasks, and then choose Publish to publish your assignments. Or, leave that field blank for the development team to assign.

    Assign resources in project

    Tip

    Although Project supports allocation of more than one resource to a task, Azure Boards work tracking 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 project member as a resource to those tasks that you will publish.

    Specify resources by their display names from Azure Active Directory (for Azure DevOps Services) or Active Directory Domain Services (for TFS). If you assign a resource by its alias or other name, you risk incurring validation errors.

  7. Save your project plan to retain scheduling and other data that Azure Boards doesn't store.

When you indent tasks and then publish your plan, you create parent-child links between work items. Tasks will show up on the taskboard when they are assigned to the taskboard sprint.

Link tasks to create parent-child links

To see the parent-child links that you just created, open Links and Attachments.

Subordinate tasks create predecessor-successor lnk

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 work tracking fields

To enter data into other work tracking fields, switch to the Team Foundation Task Sheet.

Open Team Foundation Task View in Project

This view displays all the work tracking fields that have been mapped to Project.

Team Foundation Task Sheet view

Optionally, you can add a mapped work tracking field as a column to the Team Foundation Gantt view. To see which work tracking fields are mapped, open Column Mappings.

View of work tracking fields mapped to project fields

To add more work tracking fields or change the way fields are mapped, see Customize the Microsoft Project field mapping file.

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:

  • When you first open a project plan, choose the Team ribbon Refresh icon to download the latest work tracking data.

  • Publish your changes and refresh your plan periodically while you work. Otherwise, you can encounter data conflicts between plan data and the work tracking data store.

  • Save your project plan to maintain scheduling data and other information that isn't stored in the work tracking data store.

  • When defining areas and iterations, keep in mind that Project and Excel restrict the length of the area and iteration path field to 256 characters.

  • In Project 2010 and later versions, when you choose the Pinned task icon (Manually scheduled tasks, Task Mode field), team members can place a manually scheduled task anywhere in their schedules, and Project will not move it. In order for team members to manually schedule their tasks, you will have to add the necessary project fields to work tracking task definitions.

    Start and finish dates for autoscheduled tasks ( Auto Update Task Mode icon) are determined by the scheduling engine based on task dependencies and the project calendar, as in previous releases of Project.

  • Use Project to manage and update changes to these fields:

    • Finish Date

    • Start Date

    • Calculated fields for completed and remaining work

      Although work tracking data store can store estimated, completed, and remaining work, and start and finish dates, Azure DevOps Services and TFS do not recalculate the fields when updates to these fields are made.

      When you publish to Azure DevOps Services and TFS, start and finish times are read-only by default. Project does not download start and finish times when you refresh the plan.

  • If you see that hours are counted twice in reports that contain task hours, correct the problem.

    Project assigns parent tasks the rollup of hours that are assigned to all its child tasks. Rollup hours are not published to the work tracking data store to prevent hours within reports from being counted twice. The Microsoft Project mapping file attribute, IfSummaryRefreshOnly, suppresses the hours that are assigned to summary tasks.

Differences working in Project versus Excel

Area Project Excel
Adding work tracking fields You can only add fields to your Project plan that are defined in the Microsoft Project mapping file. You can add any work tracking 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 Azure DevOps-Office integration issues.

Delete work items

You can't delete work items from Excel nor from Project. 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 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 Field Mapping File. For resources, see Schedule projects using Microsoft Project 2010.

Do you want to map additional work tracking fields to Project, or change how fields are mapped?

You can change how work tracking fields map to fields in 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.