Skip to main content
System StatusContact Support

Documentation related to the following products will soon be moved to a new portal: ( Agility, Agility Connect and Agility Integrations Continuum and ALM Connect
Links from the site will automatically redirect to the new site.
If you have any questions, please contact Support. Agility Community

VersionOne Subversion Integration

This feature is available in all editions.



This is a community supported integration and not supported by VersionOne.  Please refer to Stack Overflow using the tag versionone-subversion. 

The VersionOne Subversion Integration (V1Svn) creates a record of Subversion changesets in VersionOne, so the development team can quickly view all of the code changes for a story or defect. This visibility can be useful when tracking down defects or performing code reviews.

Once V1Svn has been installed, development team members include a story or defect ID, such as “S-01454” in their Subversion commit messages. V1Svn checks each commit message for IDs and creates a changeset within VersionOne for each story or defect matching the entered IDs. A changeset is the collection of changes for a single revision in Subversion. The changesets for each story or defect are viewable on the details page of that item in VersionOne. Additionally, V1Svn has the capability to create link on the changeset in VersionOne that navigates to the changeset in a Subversion repository viewer

The following sequence diagram illustrates how V1Svn interacts with Subversion and VersionOne.

Source Code

Source code for this integration can be found in GitHub.

System Requirements

  • VersionOne: 7.1 or above, including Team Edition

  • Integration Server:

    • Operating System—Windows 2003, 2008

    • Framework—Microsoft .Net 2.0 SP1

  • Subversion Server:

    • Tested with Subversion Server 1.6.2 - 1.7

    • Protocol — svn, http, https

    • Basic SVN authentication or Anonymous


Configuring Subversion

SCM: Subversion


These installation instructions assume that Subversion is already installed, configured, and working properly.

  1. Determine Install Location
    V1Svn can be installed on any server with network access to both VersionOne and Subversion. Exact placement should be determined by your internal software management requirements. The integration server must meet the System Requirements stated above.

  2. Extract Files
    Download V1Svn using the link above and extract it into a folder of your choice.

  3. Configure
    Instructions for configuring V1Svn are located below in the "Configure The Integration" section

  4. Start integration
    Open up the command prompt, navigate to your installation folder, and run the following command: VersionOne.ServiceHost.exe

  5. If you have configured your system properly, you should see several [Info] messages followed by a [Startup] message.

  6. Test the integration
    To ensure the integration is working, perform the following steps:

    1. Commit a change to your Subversion repository with a message of “test”. You should see the following output:

      [Info] Publishing ChangeSet: #, "test"; No References found.
      [Info] No Change Set References. Ignoring Change Set: #
    2. Commit a change to your svn repository with a message of “S-01001”. You should see the following output:

      [Info] Publishing ChangeSet: #, "S-01001"; references: S-01001
    3. Shut down the service host by pressing “Q” in the console window.

  7. Install as a Windows Service
    Run the following command from the console window: VersionOne.ServiceHost.exe --install

    This command installs the service so it will will run under the account NT AUTHORITY\Local Service. Local Service must be given access privileges to the directory where the V1Svn executable was installed so it can store its state and write to log files. Follow the steps below to change the security on the installation directory:

    1. Right click the installation folder from Windows Explorer.

    2. Select "properties".

    3. Select the "Security" tab.

    4. Click the "Add" button.

    5. Enter "Local Service" and click "OK".

    6. Click the "Allow" checkbox for the "Full Control" row .

    7. Click "OK" to save the changes.


The following section describes how to configure your Subversion integration using the use the configuration tool

  1. To configure V1Svn you need to run the ServiceHost configuration tool: ServiceHostConfigTool.exe

  2. Specify your VersionOne connection details on the General tab.

    The following table describes the fields on this tab



    Server URL

    This is the URL to your VersionOne server


    VersionOne user that will create defects


    Password for the specified user

    Use Windows Integrated Authentication

    Check this box if you VersionOne server is configured to use Windows Integrated Authentication

     When using the integrated authentication, V1Svn will authenticate to VersionOne using the Windows domain user under which the executable is running if both the username and password parameters are blank. If the username and password is entered, you must specify the windows domain account in the form "User@FullyQualifiedDomainName". If you are unsure what the fully qualified domain name is, see the Domain name shown on the 'Computer Name' tab in the My Computer...Properties dialog.

    If there's a proxy between this machine and the VersionOne instance, you'll also need to configure the following settings:



    Use Proxy For Connection

    Determines if the integration tries to connect through a Proxy

    Proxy URL

    This is the URL to your Proxy Server

    Proxy Username

    The username that will get you past this proxy

    Proxy Password

    The password for the Proxy Username

    Proxy Domain

    Name of Proxy Domain


  1. Once the VersionOne parameters are entered, press Verify button to continue.

  2. Specify how to create a VersionOne Change set and link it to Subverison on the Changesets tab.
    The following table describes the fields on this tab




    Check this box to disable ChangeSet creation in VersionOne.

    Change Comment

    The VersionOne ChangeSet creation comment.

    Always Create ChangeSet

    If checked, a VersionOne ChangeSet is created for each Subversion ChangeSet. If cleared, the VersioOne ChangeSet is only created if a VersionOne identifier can be found in the Subversion commit comment.

    The Link Properties section contains the following fields



    Add To Menu

    If checked, the link between VersionOne and Subversion is placed on the ChangeSet Details page tab menu. If cleared, there is no tab menu element for the link.


    Friendly name for this link. Defaults to "ChangeSet {0}" and the {0} is replaced with the Subversion ChangeSet Identifier


    Fully qualified URL to your web based Subversion Viewer (i.e. ViewVC). The Subversion ChangeSet identifier is set by putting {0} in the URL

  3. Specify your Subversion connection details and how the integration will identify ChangeSets for VersionOne on the Subversion tab.

    1. Configure the Subversion connection (Connection Parameters)




      Check this box if you want to disable polling Subversion for ChangeSets.


      Fully qualified URL to the Subversion repository monitored by this integration instance.

      User Name

      Valid Subversion user for the repository specified


      Password for specified user

    2. Click Verify to ensure the connection parameters are correct.

    3. Configure how to identify ChangesSets



      Regular Expression

      This is the Regular Expression used to search Subversion commit comments for VersionOne identifiers.

      Poll Interval

      Determines how frequently the integration polls Subversion looking for Defects.

      Here are some sample Regular Expressions:

      To Match S-01001 (Matches "S-01001")


      To match #Reference (matches only "Reference")


      To match "V1:Reference" (matches only "Reference")

  4. Save your changes and exit the program

Technical Details

This section is provided for informational use only. Users are discouraged from editing this file directly.

VersionOne.ServiceHost.exe.config is the file that controls the behavior of VersionOne.ServiceHost.exe. Values in this file are set by theServiceHostConfigTool.exe configuration tool.

The SvnReaderService Element controls how the integration communicates with Subversion. The following table describes the elements nested under SvnReaderService.

Element Name



Subversion repository URL


Subversion user name. If omitted or empty, anonymous access will be used


Subversion password (can be empty). If omitted, anonymous access will be used.


Regular Expression used to locate a VersionOne identifier in the Subversion commit comment

The ChangeSetWriterService element controls how ChangeSets are created in VersionOne. The following table describes the elements nested under ChangeSetWriterService. ||Element Name||Description||



The VersionOne filter attribute to use when retrieving workitems from VersionOne. The default is Number (the value visible in the UI). We do not recommend changing this value.


Comment to put on the ChangeSet when it's created


Element Name



VersionOne Application URL


Valid VersionOne Username. This user must have authority to create defects in the VersionOne projects being processed.


Password for specified user


The minimum application version required for this hosted service.


False if using VersionOne native security, true is using Windows Integrated Security. If VersionOne is configured to use Windows Integrated Security, the account the service is running as must be a configured VersionOne user with a project role of Team Member or higher. Also, Username and Password should be empty if IntegratedAuth is true.


Element Name



VersionOne Title for link


URL for your repository viewer


Determines value for the "On Menu" checkbox. If True, link appear as a tab in the Details panel. If false they do not appear as tabs.

The SvnReaderServiceTimer element controls the Subversion poll frequency. The following table describes the elements nested under SvnReaderServiceTimer.

Element Name



Number of milliseconds to wait between polls to the Subversion system


Do Not Change