Visual Studio Team Services

This page covers how to integrate Axosoft with your Visual Studio Team Services repository.


Enabling Visual Studio Team Services in Axosoft

To enable the Visual Studio Team Services (VSTS) integration, go to Tools Manage Extensions Source Control.

Click the Edit button for Visual Studio Team Services (Git/TFVC) to open the Edit Source Control Type screen.

Check the box for Active and then generate a key. You will need this key to connect Visual Studio Team Services to Axosoft, so copy it down.


Configuring Visual Studio Team Services Settings

In your Visual Studio Team Services repository, click the gear icon.

Click on the Service Hooks tab and select Create the first subscription for this project.

Select Web Hooks from the tabs and click Next.

For Git Repositories, choose Code pushed from the drop down. Then click Next.

For TFVC repositories, choose Code checked in from the drop down. Then click Next.

Type in your Axosoft URL and add /api/v5/source_control_commits?hash=[insert key] to the end (e.g.https://example.axosoft.com/api/v5/source_control_commits?hash=[insert key]).

Note: After configuration, the test will fail. Commit new check in to test the connection. After configuration, test the connection for a commit using the following: [axox: id#]


Viewing Visual Studio Team Services commits in Axosoft

Visit Commit Messages to learn how to tag Axosoft items with your commits.

In the Details Panel, you should now have a pane for viewing Visual Studio Team Services. (It will display as Source Control if you have more than one source control integration enabled.) Expanding a commit listed in this pane will display the commit message and date of the commit. The URL link points to the changes on Viewing Visual Studio Team Services.


Team Foundation Server

This section covers integrating Axosoft with Microsoft Team Foundation Server's source control capabilities.


TFS prerequisites

  • Axosoft v14.1 to Axosoft v16.5
  • For TFS 2012 - 2015: .NET Framework 4.0
  • For TFS 2010: .NET Framework 3.5

IMPORTANT: If you are using Axosoft v17.0 or newer, then please use our Visual Studio Team Services integration instead. Axosoft does not support self-hosted Team Foundation Server instances past 2016.


Enabling Team Foundation Server in Axosoft

To enable TFS integration in Axosoft, go to Tools Manage Extensions Source Control.

Click the Edit button for Team Foundation Server to open the Edit Source Control Type screen.

Check the box for Active and then generate a key. You will need this key to connect TFS to Axosoft, so copy it down.


Install the Axosoft TFS Plugin

Download and install the Axosoft TFS plugin on your Team Foundation Server. After the installer completes, enter the URL for your Axosoft web application and paste the API key generated from the previous step.


Updating your Axosoft items

Visit Formatting Commit Messages to learn how to tag Axosoft items with your commits.

Updating Multiple Axosoft Items

To update multiple Axosoft items with a single commit, just add additional tags for the item in the commit message. You can then view all of the other tagged Axosoft items in the Team Foundation Server for each commit.


Viewing the commit in Axosoft

In the Details Panel, you should now have a pane for Team Foundation Server. (It will display as Source Control if you have more than one source control integration enabled.) Expanding a commit listed in this pane will display the commit message, date of the commit, and files included in the commit.