Applies to Collaborator 11.5, last modified on March 1, 2019

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 Integration

  3. Switch to the Configure Remote Systems tab.

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

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

  6. After you specified the values, click Save. This will create a TFS configuration.

  7. Scroll the Admin > Remote System Integration screen up to the Integration Status section. This section allows you to quickly enable or disable integrations with remote systems.

  8. Locate the Enable TFS Integration setting and change it to Yes.

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

See Also

Configure Issue-Tracking Integrations

Highlight search results