Creating the AccuWork™ and ITS Connections

This procedure describes how to create the connection components AccuSync uses to connect to AccuWork and your ITS. In addition to connection information, you use the connection components to specify:

•	The AccuRev depot and ITS projects whose issues you want AccuSync to synchronize

•	The name of the AccuWork schema field that stores the type of issue (defect or task, for example) AccuSync will synchronize

To create the AccuRev and ITS connections:

1.	Verify that the AccuSync server is running. See Starting the AccuSync™ Server if you need help with this step.

2.	Verify that your ITS service is available. Depending on your ITS, this might involve ensuring that a server is running or simply checking that your cloud-based ITS is not down for maintenance, for example.

3.	Start the AccuSync Management Console. See Step 6: Start the AccuSync Management™ Console if you need help with this step.

The AccuSync Management Console main page appears. Any existing AccuSync configurations are displayed in the Configurations table.

4.	Click the Add new... button.

The New Configuration page appears.

5.	Enter a name for the new configuration.

6.	Select the system you are synchronizing with AccuWork.

7.	Click the Create button.

The New AccuRev Connection dialog box appears.

8.	Specify the values required to connect to AccuWork. Note the following:

•	Host and Port: These are the values that correspond to the AccuRev installation with which you will be synchronizing your ITS.

•	Username and Password: Be sure to enter the username and password of the AccuSync user you created specifically for AccuSync. See Step 5: Create the AccuSync User for more information.

•	AccuRev executable: Use this field to optionally specify the absolute path of your AccuRev executable (accurev.exe). If you leave this field empty, AccuSync looks for accurev.exe in your system’s PATH.

9.	Click the Test Connection button.

When the connection succeeds, a new panel appears on the New AccuRev Connection dialog box that allows you to specify the AccuRev depot whose issues you want to synchronize with your ITS projects.

10.	Complete the remaining fields as follows:

•	AccuRev depot: Choose the depot you want to synchronize with your ITS.

Tip: When you select a depot, a default value appears in the AccuWork Issue Type Field Name field.

•	AccuWork issue type field name: The internal name of the field that displays the issue type (defect, task, and so on) on the AccuWork Issue Edit Form. Unless you have changed the name in the AccuWork schema, the name of this field is type.

Note: The field’s name typically differs from its label. For example, the field named type is displayed on the Issue Edit Form using the label Type.

•	Web Interface URL: Enter the URL for the machine hosting the AccuRev Web Interface. For example: http://localhost:8080/accurev/

11.	Click the Save button.

The New Connection dialog box appears. You use this dialog box to specify connection settings for your ITS.

Note: Fields on the Edit Connection dialog box vary slightly based on ITS.

12.	Specify the values required to connect to your ITS. See New ITS Connection Dialog Box if you need help with this step.

13.	Click the Test Connection button.

When the connection succeeds, new panels appear on the New Connection dialog box. Fields on this panel vary slightly based on your ITS. See Testing the ITS Connection for more information.

Note for JIRA users: If the connection to JIRA does not succeed, make sure that the JIRA plugin for AccuSync was installed and that JIRA has been configured to accept remote API calls. See Step 1: Configure JIRA for AccuSync for more information.

Note for Rally Users: You cannot select a Task project without also selecting the corresponding Defect or Story project.

14.	Click the Save button.

AccuSync displays a message indicating that the configuration was created successfully.

15.	Click OK to clear the message.

The new configuration appears in the Configurations table on the AccuSync Management Console main page.

What to Do Next

Once you have successfully created connections to AccuWork and your ITS, and identified the AccuRev depot and ITS projects whose issues you want to synchronize, you can create mapping definitions as described in the following section.