Synchronizing Requirements

Enterprise Tester supports importing requirements directly from JIRA or exporting to JIRA. If you are using JIRA for both requirements capture and defect management, Enterprise Tester is fully integrated to support the synchronization of both requirements and issues. Synchronization is manually initiated and occurs in a single direction, either from the defect tracker to Enterprise Tester or Enterprise Tester to the defect tracker.

Creating your Project Link

If you have already configured a JIRA connection for your defect management (see JIRA_Integration) you can proceed to creating your project link for requirements.

1. Click on the ‘Resources’ tab in your tree navigator and click to expand ‘Project Link’.
2. Right click on your project and select ‘Add New Project Link’, the Add Link screen will appear.

3. Enter in the Name for the link, and select from the dropdowns:

   • Connection is a JIRA connection that has already be configured. ( Note: there is an additional option to synchronize with TFS)
   • Type is Requirements
   • Select the JIRA project to synchronize requirements with.
   • Once complete, click ‘Save’.

Configure the Requirement Link

Once the project requirement link is set up, you will be displayed the screen below and will need to perform additional configuration.

From the Edit Synchronization Configuration screen, click on the ET Configuration tab. Select the ET requirements package you wish to synchronize with. Here you can also select the filter criteria when synchronizing from ET to JIRA. You can filter on Types, Statuses and Priorities. Once you have completed your configuration, click ‘Save’.

Next, click on the External System Configuration. Select the entity type(s) (requirement, stories, epics etc.) to synchronize with Enterprise Tester and click ‘Save’. For TFS you must select “Requirement” or any Work Item you wish to synchronize.

Here you can also select additional criteria including Statuses, Priorities, Components, Affected and Fixed Versions.

Note that by default all entities will be synchronized if you do not apply a filter. If the JIRA or TFS field values do not appear in the field drop down list, you may need to initiate a refresh lookups which will refresh the JIRA metadata.

Next, click on the Mapping tab.

This screen displays two tabs for outlining and configuring the steps undertaken when synchronization is initiated.

• One tab for mapping fields from Enterprise Tester to the defect tracker.
• One tab for mapping fields from the defect tracker to Enterprise Tester

Next, set your field mappings in the direction of Enterprise Tester to the defect tracker - you will notice on the screen below that the Field Mapping is not currently configured. Please note that Enterprise Tester will prompt the administrator when a refresh lookups is either in progress or is required. This must be completed before configuring your field values. Refresh lookups will ensure that all the custom fields from your defect tracker and associated field values are up-to-date during field mapping.

You do not need to edit the mappings from the defect tracker to Enterprise Tester as they are already complete, however you can edit them if required.

1.Click to highlight and select ‘Map Fields’ and click on ‘Configure’ from the toolbar. Please note that Enterprise Tester may need to Refresh Lookups before you can proceed with your field configuration.

From the Configure Fields mapping screen, several configurations are automatically created consisting of Copy Field type mappings and direct Map field type mappings.

The Copy Field type mappings are already configured and the value will be copied from Enterprise Tester to JIRA on Synchronization:

Copy Field – Copy from ET: Name (field) to External System: Summary (field)
Copy Field – Copy from ET: Description to External System: Description (field)
Copy Field – Copy from ET: Created By (field) to External System: Reporter (field)
Copy Field – Copy from ET: Assigned To (field) to External System: Assignee (field)

The Map field type mappings require the field values to be mapped. You can see under the column “Configured = False” that the value for these fields has not yet been mapped:

Map Field – Map from ET: Type to External System: Type
Map Field – Map from ET: Priority to External System: Priority

1. To complete the field mappings, click on the “Type” Map field and select ‘Edit’ from the tool bar.
2. Complete mapping Enterprise Tester field values to JIRA field values.
3. Click “save”.
4. Complete mapping field values for “Priority”.

Scheduling Requirement Synchronization

Now that your configuration and field mappings are complete you are ready to synchronize. The synchronization frequency can also be configured from the Schedules tab. There are 3 options that can be configured:

1. Adhoc
2. Periodic
3. Daily

Once you have configured your synchronization frequency, a summary of the configured synchronization schedules is available. You can see the time of the Last Run, the Next Run (if applicable), whether the schedule is enabled or not and the current Synchronization Status.

You can use the tool bar to add a new scheduled synchronization, delete an existing configuration, enable or disable an existing schedule, configure an existing schedule or manually initiate a synchronization.

Synchronization History

You can view the Synchronization history from both the synchronization configuration screen and the individual synchronized entities. From the configuration screen you can view all synchronization events, select to only view errors, export the synchronization events to a csv file or clear the history.

Deleting Requirement Project Links

Deleting requirement project links will stop the synchronization between Enterprise Tester and your external system. When deleting the link you will have the option to delete the link and remove all external link references or to retain these references. These include the trackback comments and the defect issue link placed in Enterprise Tester. Note that if you chose to delete the references. This will only affect Enterprise Tester. References to Enterprise Tester in your external system cannot be removed, but all references in Enterprise Tester to your external system will be removed.

Limitations

• When synchronizing from ET to JIRA
  1. Nested requirements will be synchronized, but will not be created as sub tasks in JIRA
  2. Relationships in ET between requirements will not be synchronized to JIRA
• When synchronizing from JIRA to ET
  1. Sub tasks are never synchronized to ET
  2. Links between issues in JIRA are never synchronized to relationships in ET
• Currently synchronization will halt after an error occurs (so it won't continue processing the remaining entities).
• Requirement Synchronization to JIRA does not currently support mapping to/from cascading select fields. When synchronizing from ET to JIRA, if you see an error message similar to this with the error "is an invalid parent option" this suggests you have tried mapping to a cascading select field: System.ServiceModel.FaultException: com.atlassian.JIRA.rpc.exception.RemoteValidationException: Fields not valid for issue: Errors: {customfield_10130=The option '1' is an invalid parent option} Error Messages: Remove the mapping to allow synchronization to work once again.
• Auto-map in the TFS -> ET direction is fine, but auto-mapping in the other direction, even for custom fields, is not currently implemented.