TFS Work Item Integration

Applies to Collaborator 12.4, last modified on December 21, 2021

This topic describes how to setup Collaborator integration with TFS work item system. To learn general principles of how any issue-tracking integration operates, see Issue-Tracking Integrations: Overview.

  1. Open the Collaborator login page in a browser and log in to Collaborator as an administrator.

  2. In Collaborator, go to ADMIN > Remote System Integrations > Issue-Tracking Services

  3. In the New Remote System Configuration section, select TFS and click Create. This will display the configuration settings.

  4. Specify the setting values:

    Remote system configuration settings depend on whether you use a self-hosted version or a SaaS version of Team Foundation Server known as Visual Studio Team Services. If you use the latter, then you might need to set-up alternate authentication credentials at first and then use those credentials in your TFS configuration. See Client Configuration for Visual Studio Team Services for configuration instructions.

    Setting

    Description

    Title

    The configuration name as it will be displayed in Collaborator user interface.

    TFS Collection URL

    For self-hosted version of Team Foundation Server, specify the URL of Team Foundation Project Collection to work with.

    For instance: http://tfs.acme.com/my-collection

    For SaaS version of Team Foundation Server, specify the URL of your Visual Studio Team Services account (without project or collection names).

    For instance: http://jsmith-ts.visualstudio.com

    TFS User

    The name of Team Foundation user. For SaaS version of Team Foundation Server, specify either user name or alternate primary user name.

    The specified user must have read-write permissions to TFS projects. Administrator permissions are NOT required. You may specify a regular user, or create a dedicated user for this integration.

    TFS Personal access token

    The personal access token of Team Foundation user. For SaaS version of Team Foundation Server, specify either personal access token or alternate credentials password.

    After specifying these values, you can click Test Connection to verify if you entered data correctly.

  5. After you specified the values, click Save. This will create and enable TFS integration.

  6. Switch to the ADMIN > Remote System Integrations page. The Integration Status section allows you to quickly enable or disable integrations with remote systems.

  7. Locate the Enable TFS Integration setting and verify that it is set to Yes.

Now the integration between Collaborator and TFS work items is configured and running.

See Also

Configure Issue-Tracking Integrations

Highlight search results