# Teamscale Integration for Visual Studio
Before installing the Teamscale Integration for Visual Studio, make sure its system requirements are met.
# Installing the Plug-in
Depending on your needs, there are several options to install the Teamscale Integration for Visual Studio.
# Installing the Latest Version From the Visual Studio Marketplace (recommended)
For most users, installing the latest version of the plug-in from the Visual Studio Marketplace (opens new window) is recommended.
- Select Extensions > Manage Extensions.
- Search for
Teamscale Integration
. - Select Download.
- Restart the IDE to conclude the installation.
# Installing While Offline
In case you cannot reach the Visual Studio Marketplace during the installation, e.g., due to a security policy, you can perform an offline installation.
- Download the plug-in from the Visual Studio Marketplace.
- Visual Studio 2022:
https://marketplace.visualstudio.com/items?itemName=CQSEGmbH.Teamscale-2022
(opens new window) - Visual Studio 2015, 2017 and 2019:
https://marketplace.visualstudio.com/items?itemName=CQSEGmbH.Teamscale
(opens new window)
- Visual Studio 2022:
- Double-click the Teamscale.vsix file.
- In the VSIX installer dialog, click Install.
- Restart Visual Studio.
# Connecting to Teamscale
In Visual Studio, you need to configure your Teamscale server, so that the plug-in knows where to fetch findings.
Click Tools > Teamscale Options.
Click Add.
In the dialog, enter a Name for your server (this name is later referenced from project mappings), the server URL, and your Username and Access Key.
Click Save. The dialog should close, if validation of the connection was successful.
# Configuring the Project Mapping
Next, you have to specify a project mapping, so that the plug-in knows which Teamscale project belongs to which code on the hard drive.
Click Tools > Teamscale Options...
On the left hand side select Teamscale > Project Mapping.
Click Add.
In the dialog, select the Server and Teamscale Project. If branch analysis is enabled for the project, select the relevant branch in the combo box (defaults to the default branch configured in Teamscale). Choose the local folder you want to map to the project and, optionally, specify a sub-path of the project on the server (can remain blank in most cases).
Click Save.
# Inspecting Findings
After the previous steps have been completed successfully you should now be able to explore findings in your code.
- Findings in the opened document should be marked with a red bar on the left margin.
- Hovering with the mouse over the margin will show a tooltip containing the description of the finding.
- To show all findings of a file, either right click in the current editor or the Solution Explorer and select Teamscale > Show Findings.
- 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.
# Troubleshooting
Problems with the Visual Studio integration can be troubleshooted by enabling logging (opens new window).
- Start Visual Studio with the
/log
command-line switch:devenv.exe /log vslog.xml
- Reproduce the error
- Errors will be logged in
vslog.xml
If you did not specify a log file, the default one located at %APPDATA%\Microsoft\VisualStudio\<Version>\ActivityLog.xml
will be used.