# Teamscale Integration for Visual Studio

Teamscale provides an integration for many popular IDEs, which inclues Visual Studio.

# Download & Installation

You can download the Teamscale Visual Studio plugin by using the integrated extension manager in Visual Studio by searching for Teamscale or by downloading the Plugin from the Visual Studio Gallery.

TIP

The plugin is compatible with Visual Studio versions 2015 to 2019.

Installation via the extension manager has the added benefit of automatically being notified about new updates, as they get published.

# Manual Installation

In case you downloaded the extension manually you can install it as follows:

  1. Double click on the Teamscale.vsix Extension file.
  2. In the dialog of the VSIX Installer, click Install.
  3. Restart Visual Studio.

# Configuring a Teamscale server

Next you have to configure a Teamscale server, so that the plugin knows from where to fetch the findings.

  1. Click ToolsTeamscale Options...

  2. Click Add.

  3. In opened dialog enter the Teamscale Server ID (this name is later references from project mappings), the Teamscale Server URL, your username and password/api key.

    Visual Studio Server Settings

  4. Click Save. The dialog should close if validation of the connection was successful.

# Configuring the project mapping

Next you have to supply a project mapping, so that the plugin knows which Teamscale Project belongs to which code on the hard drive.

  1. Click ToolsTeamscale Options...

  2. On the left hand side select TeamscaleProject Mapping.

  3. Click Add.

  4. In the opened dialog select the Teamscale Server and Project. If branch analysis has been configured on the Teamscale server, select the relevant branch in the combo box. As default value the default branch name specified on the Teamscale server will be used. Choose the local folder you want to map the Teamscale Project to and optionally specify a sub-path of the project on the server (this can be left blank in most cases).

    Visual Studio Project Settings

  5. Click Save.

  6. Reopen the currently opened Solution if it corresponds to the configured project.

# Inspecting findings

After the previous steps have been completed successfully you should now be able to explore findings in your code.

  1. Findings in the opened document should be marked with a red bar on the left margin.
  2. Hovering with the mouse over the margin will show a tooltip containing the description of the finding.
  3. To show all findings of a file, either right click in the current editor or the Solution Explorer and select TeamscaleShow Findings.
  4. In the findings list one can double click to jump to the finding in the code, open it in the browser or blacklist the finding as shown in the screenshot below.

Visual Studio Findings View