Synchronizing Requirements
Enterprise Tester supports full bi-directional synchronization of Requirements/User Stories with Rally. Key Features include:
- Configurable import filtering by: Iteration, Owners, Statuses, Releases, Scheduled States and Tags;
- Configurable Synchronization Schedules - Adhoc (manual), Periodic (set time interval) and Daily;
- Support for child user stories supported;
- Rally User Story ID on the requirement in ET; and
- Trackback comment with a link to the ET requirement added to the Rally User Story Discussion.
Creating your Project Link
Once the Rally connection has been created (see External Systems Integration), you can begin associating projects in the Rally with projects in Enterprise Tester. Project links can be created and managed either from the Resources tab on your tree view navigator or on the External System Links tab.
External System Links Tab
From the Admin tab, Expand Extensions and double click on External Systems. From the External Systems summary grid, double click the External System you wish to create a link for. Then navigate to the Links tab. Click on Add from the tool bar.
The Add External System Link screen will appear. Complete the name. The Source field will automatically populate with Requirements. This is the entity type that will be configured for synchronization. ET only supports synchronizing Rally User Stories with ET Requirements.
Then select the ET project and The Rally project you wish to synchronize. The name of the Rally Workspace will prefix the project name for Rally instances that have more than one Workspace available (Workspaces must be accessible by the remote user user/ gateway account used to connect ET to Rally).
Once you have completed the screen click on OK. The External Links Details screen will appear. Now you will need to complete the Field Configuration and set up the synchronization schedule. See the Configure the Requirement Link section below.
Resources Tab
From the Resources Tab in the navigation pane, click to expand "Project Links". To view all configured links for your project, double click on your project.
- Click on the ‘Resources’ tab in your tree navigator and click to expand ‘Project Link’.
- Right click on your project and select ‘Add New Project Link’, the Add External System Link screen will appear.
Enter in the Name for the link, and select from the dropdowns:
- Source is the entity type you wish to synchronize. Select Requirements
- The ET Project will be pre-selected
- Destination is the configured external system to use for this link. Select your Rally external system
- Select the Rally Project to synchronize with.
Configure the Requirement Link
Once the project requirement link is set up, the screen below will be displayed 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 Rally. 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’.
Here you can also select additional criteria including Iterations, Owners, Releases, Schedule States and Tags.
Note that by default all entities will be synchronized if you do not apply a filter. If the Rally field values do not appear in the field drop down list, you may need to initiate a Refresh Lookups which will refresh the Rally 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
Task | Configurable | Description |
|---|---|---|
Map Fields | Yes | Allows a set of mappings to be configured to transfer information between the source and destination system. |
Map Attachments | No | Synchronizes the set of attachments between Enterprise Tester and External System (e.g. JIRA). This will add new attachments that have not been synchronized previously, and remove previously synchronized attachments that have since been removed. |
Create Trackback Comment | No | Adds a comment to the synchronized requirement with the following text: Linked to Enterprise Tester requirement - Requirement: http://server/EnterpriseTester/#/requirement/edit/04e7f9e5-5784-4e94-a863-9ef600f0a935 (Name: ) If a comment already exists with the same value, then the comment is not added. |
Update Hierarchy | No | For external systems that support nesting of entities, this step will maintain the hierarchy of child to parent relationships between requirements in Enterprise Tester and entities in the external system. Currently supported by the JIRA 5+ beta and Rally external system types. Disabling this plugin will prevent synchronization of parent/child relationships. |
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.
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 Rally 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)
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: Status to External System: State
- To complete the field mappings, click on the “State” Map field and select ‘Edit’ from the tool bar.
- Complete mapping Enterprise Tester field values to Rally field values.
- Click “Save”.
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:
- Adhoc
- Periodic
- Daily
Type | Scope | Direction | Period | Time |
|---|---|---|---|---|
Adhoc | You can choose to only update entities since the last synchronization or synchronize all. | Four options: • To External System (From ET) | N/A | N/A |
Periodic | You can choose to only update entities since the last synchronization or synchronize all. | Four options: • To External System (From ET) | Specify the synchronization frequency in minutes. | N/A |
Daily | You can choose to only update entities since the last synchronization or synchronize all. | Four options: • To External System (From ET) | N/A | Specify the time using the (24hr clock) when the synchronization will occur 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 reference 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.
