This is not the latest version of Team Foundation Server. To download the latest release, please visit the current release notes for Team Foundation Server 2018 Update 3. You can change the language of this page by clicking the globe icon in the page footer and selecting your desired language.
In this article, you will find information regarding Team Foundation Server 2017 Update 1. Click the button to download.
To learn more about Team Foundation Server 2017, see the Team Foundation Server Requirements and Compatibility page.
Please see the TFS Install page for more information.
Release Date: March 7, 2017
Summary of What's New in Team Foundation Server 2017 Update 1
- More Personal Experiences
- Version Control Improvements
- Work Item Tracking Improvements
- Build Improvements
- Payment Required for Package Management
- Package Improvements
- Cross Platform Improvements
- Testing Improvements
- Release Management Improvements
- Code Search Update
- Code Insights Improvements
- Administration Improvements
- Team Room Deprecation
- Markdown no Longer Supports File Links
- Announcing the Process Template Editor
Details of What's New in Team Foundation Server 2017 Update 1
Personalized collection home page
With this release, it is easy for you to access artifacts that are most important to you. The redesigned collection page (Figure 1) has a personalized experience that shows the Projects, Favorites, Work, and Pull Requests you care about. You can go to one place and quickly find everything you need and care about. See Account hub pages for more information.
Your project gets an identity
There is now one place to get an overview of your project. The new project page makes it easy to view and edit the project description, view or add members, and check on the latest activity. It is even easier to get started with a new project, and leverage all the built-in DevOps functionality of TFS.
For Git repos, we have divided the Administer permission into several more granular permissions. This gives you more flexibility to decide who can perform what actions. For instance, you may allow anyone in your account to create new repositories, but disallow them from deleting repos or adding new users to a repo. The new permissions are:
- Manage permissions: Add/remove users and permissions.
- Create: Create a new repo.
- Delete: Delete a repo.
- Rename: Rename a repo.
- Edit policies: Configure branch policies.
- Remove others' locks: Remove branch locks set by another user.
These permissions can be applied to all repositories in a project, or to individual repositories.
In the Policies section (Figure 2), the required and optional policies are now grouped into sections. This clarifies exactly which policies are required in order to complete a PR. Required reviewers are also summarized in the required section, and will only be marked as passing when all required reviewers have approved.
If you need to bypass policies (and have the required permissions), a new experience is displayed in the Complete dialog (Figure 3). Any policies that are not met will be displayed in a warning message, and a new explicit option to opt-in to override policies will be presented. Checking the override option enables the Override & Complete action, which completes the PR, overriding any failing policies.
Support file exclusions in the required reviewer policy
When specifying required reviewers for specific file paths, you can now exclude paths by using a "!" prefix to the path you want to exclude. For example, you can use this to exclude a docs folder from your normally required signoff (Figure 4).
You can now import a Git repository from GitHub, BitBucket, GitLab, or other locations. Import into either a new, or existing empty repository. For more information, see Import a Git repo.
Add .gitignore during repo creation
While creating a new Git repository, you can now add and associate a .gitignore file with your repository. A .gitignore file specifies files that Git should ignore while performing a commit.
The dialog allows you to select one of the many available .gitignore templates (Figure 5).
Cherry-pick and revert
We have added two new features that make it easier to port or back out changes from the web portal: Cherry-pick and Revert.
Use the cherry-pick command to port changes in a pull request to multiple branches. A typical use case is when a bug needs to be hotfixed, but should also be fixed in the mainline. Once you have created your pull request that contains the fix to the hotfix branch, you can easily cherry-pick the same fix into the main branch. See Copy changes with cherry-pick for more information.
You can revert changes on completed PRs. Find the PR that introduced the bad change, click Revert, and follow the steps to create a PR that backs out the unwanted changes. For more information, see Undo Changes with Git.
Configurable compare branch
You can now set your compare branch to something other than the default branch. This setting persists on a per-user basis. Pull requests and new branches created from the Branches page is based off the branch you set as the compare branch. See Manage your branches for more information.
Find a file or folder
You can quickly search for a file or folder in a repository using the Code hub in your Team Services project. The result lists items from your current folder followed by files and folders across the repository.
For any Git repository, go to the path control box (Figure 6), and start typing to initiate a navigation search experience for the file, or folder you are looking for.
Confirmation for deleting repos
To prevent accidental repository deletions, you now have to type the name of the repository that you wish to delete to confirm the action.
You can now favorite the repos you work with most frequently. In the repo picker (Figure 7), you will see tabs for All repositories and your Favorites. Click the star to add a repository to your list of Favorites.
Search for a file or folder in commit history
Similar to the files tab, you can now search for a file or folder in a repository and see the history of commits for that file or folder. For any Git repository, go to the path control box on the History tab (Figure 8), and start typing to initiate a history search experience for the file, or folder you are looking for.
Commit page improvements
We made your experience of the commit details page and commit history page up-to-date and highly performant. You can now find, and act on, important information related to the commit at a bird's-eye view.
Here is an example of the commit details page (Figure 9):
Here is the commit history page (Figure 10):
Search for commits in branches
You can now search for a commit in a specified branch or a tag by clicking on the Search in branches button on the commit details page (Figure 11).
You can select tags and branches in the window to view, even if these branches and tags do not contain the particular commit (Figure 12).
Markdown is a powerful tool when adding comments to pull requests, but it can be hard to remember the syntax. To make this easier, we have added a toolbar to the discussion control (Figure 13). This inserts the appropriate Markdown syntax to add common formatting. Headings, boldface, italics, links, code, and lists can all be added using the new toolbar controls, and features like @ and # mentions can be entered using the toolbar as well. Keyboard shortcuts are available for boldface (CTRL + B), italics (CTRL + I), and creating links (CTRL + K).
To help you identify the new comments in a PR, we have added some additional decoration to the new replies in existing discussion threads. Comments in the files view also highlight threads that have new comments (Figure 14).
You can now view all associated pull requests for a commit on the Commit details page. From the image below (Figure 15), you can see that:
- In the associated pull request drop-down, there are two pull requests associated with this commit.
- Pull request #2 brought this commit to master.
- The same commit was brought into branch 4 through pull request #1.
Follow a pull request
You can now follow a pull request to stay notified of any changes through email alerts. The option to Follow is available in the context menu (Figure 16).
Restart pull request merge
Another option has been added to re-attempt the merge for a pull request where the target branch has been updated. This Restart merge option is useful when you want to verify that recent changes to the target branch have not created conflicts or broken your PR build.
Completion blocked on rejected pull requests
Branches that have the code review policy set will show that the PR is unable to be completed if rejected by one or more reviewers. Many of you expected this behavior, so we have changed the default behavior. For teams that want the original behavior, there is a new option in the branch policy setting page (Figure 17).
Markdown in pull request description
Spice up your pull request description with Markdown. The same Markdown support you know and love in pull request comments is now available in the pull request description.
Attachments in PR discussions
You can now add attachments to your pull request comments (Figure 18). Attachments can be added by drag-and-drop or by browsing. For images, attachments are added by simply pasting from the clipboard. Adding an attachment automatically updates the comment to include a Markdown reference to the new attachment.
Highlight the PRs that have updates
It is now easier than ever to see the updates to your pull requests. In the PR list view (Figure 19), PRs with changes since you have last seen them, are shown with a new updates column that shows a roll-up of the changes.
When you view a PR that has changes, you will see a similar summary message in the overview. New pushes and comment threads are highlighted in blue (Figure 20). Clicking the View code updates link will navigate to the Files view, where a diff of the new changes since you last viewed the pull request is shown. This feature makes it easy to follow up on a PR where the author made changes in response to feedback.
Branch policy for PR merge strategy
We have added a new branch policy (Figure 21) that lets you define a strategy for merging pull requests for each branch. Previously, you chose the decision to either merge or squash at the time a PR was completed. If enabled, this policy will override your preferences, enforcing the requirement set by the policy.
Expose merge conflict information
If there are any files with conflicts in a pull request, the details about those conflicts is now visible in the overview (Figure 22). Each conflicting file is listed, along with a short summary of the type of conflict between the source and target branches.
Markdown preview button
When viewing a diff of a markdown file in a commit, push, or pull request, you can now easily toggle to see the resulting rendered view.
Improved search experience for scoped identity fields
With this release, we updated the identity picker behavior for scoped identity fields, i.e. identity fields that are configured to only allow assignment to a specific group of users. In the updated experience, the picker's MRU list and search results will only return members of the configured group, rather than show results for all valid users for the collection.
Rollback build definitions
You can roll a build definition back to a previous version. You can do this when editing a build definition by going to the History tab.
Disable the sync and checkout of sources in a build
You can optionally disable the automatic source sync and checkout for Git. This will enable you to handle the source operations in a task or script, instead of relying on the agent’s built-in behavior. All standard source-related variables like Source.Version, Source.Branch, and Build.SourcesDirectory are set.
Git shallow clone and git-lfs
The build agent now supports Git shallow clone and git-lfs. For more details, see the Build definition repository page.
Task versioning for Build and Release definitions
We have given you control over the major version of a task that you run in your build or release. This change results in fewer unpredictable errors that are caused by automatic updates to the agent and task version. You now specify the major version of the task on the Build tab of your definition, or on the Environments tab of your release definition.
When a minor version is released (for example, 1.2 to 1.3), you get that change automatically in your build. But if a new major version is released (for example 2.0), then your build stays locked to version 1.3 until you edit the definition and manually change to the new major version. A flag in the build definition alerts you to new major versions.
To continue using Package Management, you will either need a Visual Studio Enterprise subscription or a Package Management license purchased in the Marketplace. You can read more about licensing Package Management.
Release views in Package Management
We have added a new feature to Package Management called release views (Figure 23). Release views represent a subset of package-versions in your feed that you have promoted into that release view. Creating a release view and sharing it with your package's consumers enables you to control which versions they take a dependency on. This is particularly useful in continuous integration scenarios where you are frequently publishing updated package versions, but may not want to announce or support each published version.
Look for the quick start in Web Access or learn about release views for package CI/CD to get started.
npm in Package Management
To get started, look for the new npm option in the Connect to feed dialog (Figure 24).
Xcode Build task xcpretty formatting
You can now format your xcode build output with xcpretty (Figure 25). You can also publish JUnit test results to Team Services with xcodebuild. Previously, xctool had to be used as the build tool to publish test results. Now, to enable xcpretty, check Use xcpretty and uncheck Use xctool in the Advanced section of the Xcode task.
Publish Jenkins test and code coverage results
The Jenkins Queue Job build and release task can now retrieve test and code coverage results from a Jenkins job or pipeline. This requires installation of the TFS Plugin for Jenkins 5.2.0 or later on your Jenkins server and configuring the post-build action Collect Results for TFS/Team Services. After retrieving results from Jenkins, they are published with the Publish Test Results or Publish Code Coverage build tasks.
Xcode 8 signing and exporting packages in the Xcode Build Task
The Xcode task now supports building your projects using Xcode 8 automatic signing (Figure 26). You can install the certs and provisioning profiles on the build server manually, or have the task install them by specifying the File Contents options.
Xcode 8 requires specifying an export options plist (Figure 27) when exporting an app package (IPA) from an archive (.xcarchive). The Xcode task now automatically identifies the export method if you are using Xcode 8 or Xcode 7. You can specify the export method or specify a custom plist file from the Xcode task. If you are using an Xcode version older than Xcode 7, the task falls back to using the old tool (xcrun) for creating the app package.
Using the Deploy Test Agent and Run Functional Tests tasks in CI/CD pipeline (Figure 28), you can now install Test Agents for Visual Studio 2017 and run tests that were built using Visual Studio 2017.
Verify bugs from work item
You can now verify a bug by re-running the tests that identified the bug (Figure 29). You can invoke the Verify option from the bug work item form context menu to launch the relevant test case in the web runner. Perform your validation using the web runner, and update the bug work item directly within the web runner.
REST client helpers for Test Step operations
You will now be able to create, modify, and delete test steps and test step attachments in Test Case work items using the helper classes we have added to the REST client (see the RestApi-Sample).
Update existing bugs from Web Runner
In addition to creating new bugs from the Web runner, now you can also update an existing bug (Figure 30). All the diagnostic data collected, repro steps, and links for traceability from the current session are automatically added to the existing bug.
Test case description in Web Runner
The test case description field was often used for capturing the prerequisites required before the test case execution can start. With this update, you are now be able to view the test case description information in the Web runner by using the Show description option (Figure 31).
Test hub contribution point
We have added a new contribution point (“ms.vss-test-web.test-plan-pivot-tabs”) (Figure 32) within the Test plan hub to allow developers to write extensions as a pivot tab that appears next to the Tests and Charts tab.
Delete test artifacts
Prior to this release, your delete option was limited to work items. With this update, you now have the ability to permanently delete test artifacts—test plans, test suites, test cases, shared parameters, and shared steps—both from the Test hub and the Work hub, by using the Permanently delete (Figure 33) option in the work item form context menu.
Favorites for Test Plans
You can now favorite the Test Plans you work with most frequently. In the Test Plans picker, you will see tabs for All your Test Plans and Favorites (Figure 34). Click the star icon to add a Test Plan to your list of favorites. The favorited Test Plans are accessible in the Test Plans picker and from the Favorites tab in the new account home page. You can also filter Test Plans by searching on the title field (Figure 35).
Test Impact Analysis for managed automated tests
Test Impact Analysis for managed automated tests is now available through a checkbox in the Version 2.* (preview) version of the VSTest task (Figure 36).
If enabled, only the relevant set of managed automated tests needed to validate a given code change, will run. Test Impact Analysis requires the latest version of Visual Studio, and is presently supported in CI for managed automated tests.
Firefox support for Test & Feedback extension
We are happy to announce the General Availability of the Test & Feedback extension for Firefox. You can download the Firefox add-on from our marketplace site.
Note: Support for the Edge browser is also in the works; stay tuned for more updates.
Variable groups are used to group your variables and their values to make them available across multiple release definitions. You can also manage security for variable groups and chose who can view, edit, and consume the variables from the variable groups in your release definitions.
Open the Library tab in the Build & Release hub and choose + Variable group in the toolbar (Figure 37). Currently, variable groups are consumed only in release definitions. Find more information about variable groups, Release definitions in Microsoft Release Management.
Create (Figure 37), then edit (Figure 38) a variable group, as shown below:
Multiple schedules in releases
Want to schedule your releases to be created more than once a day? You can now configure multiple scheduled triggers in a release definition (Figure 39).
Inline service connections in Build and Release
With this feature, you can create service connections right in the build/release definition without navigating to the Services tab. This is auto-enabled for all extensions that are defined declaratively, such as Docker, Jenkins, VMWare, and SCVMM.
Link build artifacts from another team project
Until now, release definitions could only link artifact sources from the current project. Now, you can link build artifacts (Figure 40) from another project as well. While linking an artifact, the project drop down will list all the projects in the account.
Azure resource group improvements
Prior to this release, the Azure resource group task could not validate the ARM template syntax, or it would be accepted without actually deploying the resources. This enhancement allows a new deployment mode called Validation Only, where you can find problems with the template authoring before creating actual Azure resources.
Another enhancement to the Azure resource group task is to allow either incremental, or complete deployments (Figure 41). Previously, the task deployed the ARM templates using the Incremental mode. However, it did not modify resources that existed in the resource group not specified in the template. Complete mode deletes resources that are not in your template. The default is incremental mode.
Azure CLI task
The new Azure CLI task (Figure 42) supports running Azure CLI commands on cross platform agents like Windows, Linux, and Mac. The task supports both Classic and ARM subscriptions. It supports two modes of providing the script, one as a linked artifact and another as an inline script.
In TFS 2017 Update 1, the Code Search service includes Elasticsearch version 2.4.1. If the Code Search service is configured on a server running TFS 2017, the Code Search service will update as part of the TFS upgrade. If the Code Search service is configured on a remote server, then copy the content of the Search Service Package provided with the installer to the remote machine and follow the instructions in the readme file to upgrade the search service manually.
SonarQube MSBuild tasks
SonarQube MSBuild tasks are now available from an extension provided by SonarSource. For more details, please read SonarSource have announced their own SonarQube Team Services / TFS integration.
New notification settings experience
Notifications help you and your teams stay informed about activity in your Team Services projects. With this update, it is now easier to manage what notifications you and your teams receive.
You now have your own account-level experience in the profile menu for managing your notifications setting (Figure 43).
This view lets you manage personal subscriptions you create (Figure 44). It also shows subscriptions created by team administrators for all projects in the account.
Learn more about managing personal notification settings.
addProjectReports is now in TfsConfig
You can now use the command addProjectReports to add reports to your team projects. This was a previous Power Tool command and is now part of the TfsConfig.exe command. For more information, see Upload reports to a team project.
With so many good solutions available that integrate well with TFS and Team Services, such as Slack and Microsoft Teams, we made a decision to deprecate our Team Room feature from both TFS and Team Services. If you are working in Team Services, you will see a new yellow banner appear that communicates our plan. Later this year, we plan to turn off the Team Room feature completely.
There are several alternatives you can use. The Team room is used both for a notification hub as well as for chat. TFS and Team Services already integrate with many other collaboration products including Microsoft Teams and Slack. You can also use Zapier to create your own integrations, or get very granular control over the notifications that show up.
See more about the deprecation of Team Rooms in Team Services.
With Update 1, welcome pages, the markdown widget on team dashboards, and the Definition of Done on the Kanban boards will no longer support file links in their Markdown. As a workaround, you can include your file link as text in the Markdown. For more information, see Markdown guidance.
We have released the Process Template Editor extension for Visual Studio 2017. This extension provides a convenient method for viewing and updating process templates, as well as tools for updating global lists and work item types, and viewing the attributes of work item fields. This works against TFS 2017 and TFS 2017 Update 1 servers.
Build doesn't work when upgrading to TFS 2017 Update 1 build 15.112.26301.0 from TFS 2013 or earlier
Note that this issue only occurs if you upgraded to TFS 2017 Update 1 build 15.112.26301.0, released on 7 March, 2017. If you upgraded to build 15.112.26307.0, released on 9 March, you will not encounter this.
After upgrading from TFS 2013 (RTM or any update) or earlier, Build shows an error of "counter with name TaskReferenceId does not exist".
Run the following script on your upgraded collection databases:
INSERT tbl_Counter (PartitionId, DataspaceId, CounterName, CounterValue) SELECT DISTINCT dpm.PartitionId, ds.DataspaceId, N'TaskReferenceId', 1 FROM tbl_DatabasePartitionMap dpm INNER LOOP JOIN Task.tbl_Hub h ON h.PartitionId = dpm.PartitionId INNER LOOP JOIN tbl_Dataspace ds ON ds.PartitionId = dpm.PartitionId AND ds.DataspaceCategory = h.DataspaceCategory AND ds.DataspaceIdentifier <> '00000000-0000-0000-0000-000000000000' WHERE dpm.PartitionId > 0 AND dpm.HostType = 4 AND NOT EXISTS ( SELECT * FROM tbl_Counter c WHERE c.PartitionId = dpm.PartitionId AND c.DataspaceId = ds.DataspaceId AND c.CounterName = N'TaskReferenceId' )
Customers should update to Git LFS version 1.3.1 or higher
Git LFS versions before 1.3.1 are no longer supported.
If you are using Git LFS, you must update to Git LFS version 1.3.1 or higher. Older versions of the LFS client are not compatible with authentication changes in this version of TFS.
Work item forms do not render correctly
If you use a legacy custom control in your work item forms, such as the legacy multi-value control, your work item forms may fail to render.
You will need to update to the latest version of your control. You can find the latest multi-value control for TFS 2017 Update 1 here.
Work item forms do not render correctly in the web
If you have a custom control, such as the multi-value control, installed for the Visual Studio client but not the web client, work item forms in the web fail to render.
You can add a web layout that does not contain the missing control element. You can have different layout targeting visual studio and web. For more info on the layout, see All FORM XML elements reference (TFS 2015).
Work item forms do not hide read only fields
If you use old workitem form with HideReadonlyEmptyFields property set to true in the layout, your form will fail to hide read only and empty fields.
There is no workaround at this time. This will be fixed in TFS 2017 Update 2.
Work item forms become dirty on viewing
This issue is specific to IE 11 on TFS 2017 Update 1 when opting into the new work item form. If you have your profile set to French, Korean, Russian, Turkish, Japanese, or Chinese, and the work item is assigned to any identity, you will see the work item form as dirty when viewing the work item. If you save the work item, the Assigned To field is set to unassigned.
Use another browser besides IE11. If you are using IE11, click undo/refresh from the work item toolbar to restore the correct Assigned To value.
Caching of upstream NPM packages fail
If your TFS server is behind a proxy, the caching of upstream NPM packages will fail.
If your TFS server is behind a corporate proxy, make the following changes to your TFS server web.config (i.e. %ProgramFiles%\Microsoft Team Foundation Server 15.0\Application Tier\Web Services\web.config).
Replace this configuration block:
<!-- ASP.NET Proxy Usage for HttpWebRequests "usesystemdefault" false - stops the server using the default proxy configuration or proxy auto-detection. "bypassonlocal" true - this tells all requests to a local address to ignore configured proxies. --> <defaultProxy> <proxy usesystemdefault="False" bypassonlocal="True" /> </defaultProxy>
<defaultProxy useDefaultCredentials="true" />
Code dropdown menu shows incorrect Version Control pages
If you navigate to the admin page on a Git repository, as shown in the image below (Figure 45), and click on the Code hub, they will see the Changesets and Shelvesets links, instead of the History link.
(Figure 45) Code dropdown menu
Navigate out of the Git repository admin page and you will see the correct links.
Extensions are not being auto-updated
If you upgrade a prior version of TFS to reach TFS 2017 and are running TFS 2017 in connected mode then your extensions will not be auto-updated as they should be.
There is no workaround at this time. We have fixed the issue and the auto update behavior will reach you through TFS 2017 Update 2. If for any reason you cannot wait for Update 2 then reach us through the Support channel and we shall share the fix earlier.
Extensions cannot not be acquired or will not function correctly if Public URL is not set correctly
Extension acquisition from Visual Studio Marketplace will fail.
Already acquired extensions are likely to not function as expected.
This is fixed in TFS 2017 Update 2 and we recommend upgrading. If you need this to work on Update 1, set the 'Public URL' in the TFS Server Administrator Console such that the URL is reachable from another system within your corporate environment (Figure 46).
See customer-reported issues reported for Team Foundation Server 2017.