Add your Git repositories to Softagram

  1. Open Softagram in your browser (https://private.softagram.com for Softagram Cloud)
  2. Create a new Softagram project for your repositories, then add the repositories by clicking the + button on the top right corner of project
  3. Select Azure Devops
  4. You will be asked for your Azure Devops base URL, username and token. After giving them, click OK to get the list of your repositories.
  5. Select the repositories and click Add.

To create a new personal access token in Azure Devops, check the instructions in the end of this article.

If you ever need to change these Azure Devops settings, click the gear icon on the project and open "Integrations" section.

  • TFS Service Base URI: e.g. https://dev.azure.com/mycompany
  • TFS User: git username of your Azure DevOps account
  • TFS Token: personal access token - check instructions in the end of this article

For TFS, service base URI is https://{server:port} and by default the port is 8080. 

For VSTS, service base URI is https://{account}.visualstudio.com

Creating access token in Azure DevOps / TFS

You can create a personal access token for Softagram with limited set of access rights. Remember to login with the user account that you want to be shown as the sender of impact report comments in pull requests. It could be a separate bot/CI/tools account, or if you prefer so, your personal account.

From the Dashboard, go to your personal Security settings.

Select Personal access tokens, and create new, selecting "Code (read and write)" as the only required scope. Write access is needed in order to send comments to pull requests. It will never be used to push code changes or any other changes to your repositories.

Remember that you need to manually update the token once it expires. Softagram will try to send you an email if the checkout of your repositories start failing e.g. due to expired token.

The permissions UI might look different on different versions of Azure Devops / TFS but the available items should be the same.

Did this answer your question?