Accessing a Third-Party Issue Tracking System

The AccuRev Web UI allows click-through access to a third-party issue tracking system (ITS) such as JIRA. In order to do this, you need to:

  • Configure the AccuWork schema
  • Configure the Web UI wui_config.xml file

Each of these steps is described in the following sections.

Configuring the AccuWork Schema

During configuration of the AccuBridge product for your ITS, you modify the AccuWork issue database schema by adding a field to store the unique key for each issue record. This field is referred to as the issue identifier. You might name the issue identifier field issueKey, for example. See your AccuBridge documentation for more information on this topic.

Once the issue identifier has been specified in AccuBridge, you must set the AccuWork schema 3pty ITS Key property to that value, as described here.

To set the AccuWork schema 3pty ITS Key property:

  1. As the Admin user, start the AccuRev GUI.
  2. Select Admin > Schema Editor from the AccuRev GUI toolbar.

    The Schema Editor tab appears. The Schema subtab should be open by default, as shown in the following illustration. If it is not, click the Schema subtab to open it.

  3. In the 3pty ITS Key drop-down list, choose the issue identifier you created when configuring AccuBridge (issueKey, for example).
  4. Click the Save button on the bottom right of the Schema subtab.

Back to top

Configuring the wui_config.xml

Use the procedure described in this section to modify the AccuRev Web UI wui_config.xml file. Specifically, you edit the <issueURLMap> element to specify:

  • An AccuRev Server
  • Depot name
  • URL of the issue tracking system you want to access
  1. Stop the Tomcat server.
  2. Navigate to the .accurev subdirectory under the home directory of the user running Tomcat:

    • (Windows users) C:\Documents and Settings\<user name>, or C:\Users\<user name>,
      for example
    • (Linux users) The user’s login directory
  3. Check the .accurev subdirectory for a customized version of wui_config.xml. If there is no file by that name, copy <CATALINA_HOME>\webapps\accurev\wui_config.xml, where <CATALINA_HOME> is the Tomcat installation directory, to the .accurev subdirectory.
  4. Edit the <issueURLMap> element.

    accurevServer = "accu3:5050"
    depotName = "accurev"
    issueURL = "http://<its_server>:<port>/browse/*ISSUE_KEY*" />

Note: Set the *ISSUE_KEY* parameter to the value of the issue identifier you used to configure the AccuWork schema (issueKey, for example).

  1. Save the wui_config.xml file.
  2. Restart the Tomcat server.

Back to top