SpiraTest Administration Guide Help Viewer

3.10.2. Version Control Integration

SpiraTeam® is capable of integrating with a variety of Version Control (VC) / Software Configuration Management (SCM) tools such as Subversion, CVS and SourceSafe. This allows you to browse the source code repositories using the SpiraTeam web interface, and more importantly link revisions in these tools to artifacts in SpiraTeam. This provides the end-to-end traceability from code commits/check-ins to the tasks, incidents and requirements that necessitated the code change.

The information on using the various version control providers for SpiraTeam® and the steps for configuring the provider-specific settings are described in the SpiraPlan/Team Version Control Integration Guide.

To configure a version control provider, you need to click on the Administration > Integration > Version Control link in the Administration navigation to bring up the list of configured version control providers:

By default the only provider listed will be the TestVersionControlProvider which is used for demonstration purposes only, and can be deleted from a production system by clicking on the “Delete” link to the right of it.

• Name: The name of the version control provider that you’re adding. This needs to match the name of the Plug-in DLL file that you’re using (see the SpiraPlan/Team Version Control Integration Guide for more details on your specific tool)

• Description: The description is for your use only, and does not affect operation of the plug-in.

• Active: If checked, the plug-in is active and able to be used for any project.

• Connection Info: This field holds the root of the repository for any project accessing the plug-in, unless overridden in the Project Settings. Use the syntax that is described for your tool in the SpiraPlan/Team Version Control Integration Guide)

• Login / Password: The user id and the password of the user to use while accessing and retrieving information from the version control system.

• Other Fields: The other fields (Domain, Custom1 – Custom5) are provider-specific and will be described in the appropriate section of the SpiraPlan/Team Version Control Integration Guide.

When finished, click the “Insert” button and you will be taken back to the Version Control integration list page, with new provider listed as an available plug-in:

To edit the settings for an existing version control provider, just click on the “Edit” link next to the name of the provider and you will be able to edit the same settings that were shown above when you first created it.

Now, you may want to change some of the settings on a per-project basis. For example you may have different repositories that you want to link to each project. You still enter the base settings for the provider as illustrated above, but then you can override specific settings for each project.

To do this, click on the “>Project Settings” hyperlink next to the provider in question:

The first thing you need to do (regardless of whether you’ll be overriding any of the settings) is to make the provider active for the current project. To do this, change the drop-down list to “Yes” and click [Update]:

Now you can decide whether you want to override any of the default settings for this project. Any field left blank will automatically get its settings from the default values entered earlier. In the example above, we have specified a project-specific repository path, login and password. Once you have correctly configured the project, click [Update] to commit the changes.

You are now ready to use SpiraTeam® in conjunction with the version control tool you selected. For details on how to use the Source Code integration features of SpiraTeam, please refer to the SpiraTeam® User Manual.