Creating Required Key and Link Field Mappings

The values for the key and link fields are based on fields you added to the AccuWork schema. See Set Up the AccuWork Schema more information. Your ITS schema must also have been modified to store these values. If you are using JIRA, these changes are made for you by the JIRA plugin for AccuSync. See Configure JIRA for AccuSync for more information. If you are using Rally or HP ALM, see Add AccuWork Fields to Your ITS Schema.

To create required key and link field mappings for a mapping definition:

  1. Go to the AccuSync Management Console main page.
    Tip: Clicking the AccuSync logo at the top of any page takes you to the main page.
  2. Click the Edit Configuration button GUID-5197C9CE-B9A0-48D6-A7D5-9526C29D0091-low.png.
    The Configuration page appears.
  3. Above the Mapping Definitions table, click the Add new... button.
    The New Mapping Definition dialog box appears. The dialog box for JIRA is shown here. The dialog box for other ITSs contain the same fields.

    GUID-DFD8B3A1-6A6F-403D-B939-D69A439BAFDD-low.png

  4. In the Name field, enter a name for the mapping definition.
    Tip: If you are creating required field mappings as part of a base mapping definition, give it a name such as basic, common, or shared.
  5. Click the Create Key field button. The Specify Issue Key Fields dialog box appears. The dialog box for JIRA is shown here. The dialog box for other ITSs contain the same fields.

    GUID-B61BCC94-F67A-4DCC-899F-79884B522FA8-low.png

  6. In the AccuWork field and <ITS_name> field fields, choose the schema values for the unique ID that represents the issue record on each system.
    Tip: If you are using the default AccuWork schema installed with AccuSync, you can use the following mapping:
    AccuWork Field ITS Field

    ClearQuest: clearQuestKey

    HP ALM: hpKey

    JIRA: jiraKey

    Rally: rallyID

    Remedy: remedyKey

    		AccuWorkKey
  7. Click OK.
  8. On the New Mapping Definition dialog box, click the Create Link field button. The Specify Issue Link Fields dialog box appears. The dialog box for JIRA is shown here. The dialog box for other ITSs contain the same fields.

    GUID-1D92054F-AD5A-44B8-874F-2EDC925BE8F5-low.png

  9. In the AccuWork field and <ITS_name> field fields, choose the schema values for the URLs that will be used to access the issue record on each system.
    Tip: If you are using the default AccuWork schema installed with AccuSync, you can use the following mapping:
    AccuWork Field <ITS_name> field

    ClearQuest: clearQuestLink

    HP ALM: hpLink

    JIRA: jiraIssueLink

    Rally: rallyIssueLink

    Remedy: remedyLink

    		AccuWorkIssueLink
  10. Click OK.
  11. Specify other values of the mapping definition as needed. See Creating a Mapping Definition.
Parent topic: Required Field Mappings: Key and Link