Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The ability to interface with multiple external systems is a key feature of Enterprise Tester.

Requirements, Test Scripts or Incidents (depending on which tool you are integrating with) can be synchronized between Enterprise Tester and the external system.

...

External SystemRequirements / User StoriesTest Cases / Use CasesIncidents / Defects
Enterprise Architect (Sparx Systems)YesYesNo
JIRA (Atlassian)YesNoYes
Rally (Rally)YesNoNo
Team Foundation Server - TFS ( Microsoft)YesNoYes

 

Once a Requirement or Incident is synchronized, Enterprise Tester adds a reference to the external ticket ID on the incident.  This is visible as a hyperlink on the Entity or in the External Identifiers column of the grid. 

Image Added

Image RemovedImage Added

 

Image Removed 

Add an External System

To add a connection to an external system, you will need to have Administration permissions for Enterprise Tester.

...

  • Open the Admin tab of the tree view.

Image Removed

 

  • Click , click on Extensions and double click External Systems on the navigator.

...

Image Added

Image Removed 

  • From the External Systems summary screen, you can view all existing connections and view their enabled and configuration status. 

    Image Added

  • Click on  Add from the toolbar and add a name for your external system connection and select a connection type: Enterprise Architect, JIRA ( 4 - 5.1), JIRA, Rally or TFS 

 

  • , select a Connection Type

Image AddedImage Removed

  • The configuration screen of the external system type you chose will appear.:

Enterprise Architect

 

Image RemovedImage Added

Connection Type

Select the EA repository type from the drop down list.

Connection String

The connection string details are dependent on the connection type. See the Enterprise Architect help topic for more information.

Disable Import Feature

This feature disables the ability to import from EA.

It can be useful if you would like to enable the feature for an import and then disable them after the process is complete to limit other users from initiating the process.

When disabled, the Import button is no longer available on the project link screen.

Disable Update EA Feature

This feature disables the ability to update EA with the changes made in Enterprise Tester.

ET (updates and deletions). As the update feature will update all values in EA regardless of which system holds the latest change, this feature can give you some control over when updates are made. When  

When disabled the Update EA button is no longer available on the requirements type project link screen. (ET

Enterprise Tester does not support updating EA Use Cases so the use case type project link screen will be unaffected).

 


JIRA and TFS

 Image Added

Image Removed

 

Name

Enter a name for the external system that will identify it within Enterprise Tester.

Enabled

Check this box to enable the connection to the external system.

 URL

Enter the URL path for the external system. The URL should take the following forms:

JIRA: httpexample https://URL/rpc/soap/jirasoapservice-v2?wsdl          e.g. http://localhost:8080/rpc/soap/jirasoapservice-v2?wsdljira.companyname.com/

TFS: example http://<ServerURL>/<Project Collection>                     

e.g.http://tfs2010server.com:8080/tfs/ProjectET

UserName

Enter a gatewayGateway Account* username for the external system.

Password

Enter the password for the gateway username.

Ignore Remote

Check this box to ignore invalid remote certificates.

...

Info
titleImportant Information

* The Gateway Account should be set up as an administration account in JIRA/TFS. This will allow creation

...

and update of incidents across all projects and will hold sufficient privileges to support enhanced functionality when further integration features are implemented.

 Gateway Account must be assigned to the JIRA Administrators, Developers and Users default groups in JIRA.

This will allow creation, and update of incidents across all projects and will hold sufficient privileges to support enhanced integration functionality.

Rally

Image RemovedImage Added

 

Name

Enter a name for the external system that will identify it within Enterprise Tester.

Enabled

Check this box to enable the connection to the external system.

 URL

Enter the URL path for the external system. This can be left blank is you are working with a non-trial hosted instance of Rally.

If you are using a trial hosted version of Rally. The URL is:

https://trial.rallydev.com/slm/webservice/1.42/

UserName

Enter a gateway username for the external system. This user should have admin permissions and access to all relevant workspaces.

Password

Enter the password for the gateway username.

 

  • When you have completed all the details click on

...

  • Save.

...

 

  •   Enterprise Tester will test the external system and will save all details if the connection is validated.
Note

Enterprise Tester comes complete with the Enterprise Architect, JIRA, TFS and Rally interface modules and connections can be configured immediately. 

  • The next step is to set up your links between

...

  • Enterprise Tester and external systems at a project level - known as Project Links in Enterprise Tester.

  • Here are details on how to set up Project Links for each external system:

Enterprise Architect

Synchronizing Requirements with JIRA

Synchronizing Incidents with JIRA

Synchronizing Requirements with Rally

Synchronizing Requirements with TFS

Synchronizing Incidents with TFS

 

  projects.

Advanced Settings (JIRA and TFS Connections)

Advance Advanced settings only applies apply to JIRA  and TFS  connection connections.  

Advanced  Advance settings allows allow you to configure which custom fields from your external system will be synchronized with ET. By Enterprise Tester from your External System.  By default, all the custom fields in the defect tracker will be selected for synchronizationare selected.

To access the Advanced SettingSettings screen, from the Edit External Systems screen select the Advanced SettingSettings button on the bottom right corner of the screen.

The Advance Setting edit screen will appear. Here you can In Advanced Settings, select the custom fields to synchronize . Note that if you chose to custom configure the custom fields to synchronize, you will need to manually select any additional custom fields that are added to your external system if you wish to synchronize them. By default, they will not be selected for synchronization. An Enterprise Tester system administrator will need to update this configuration to include the new custom fields for synchronization.by ticking or un-ticking the check boxes.

 

Image Added

 

 Image Removed

Once you have updated the custom field synchronization configuration click Save and  & Close button.

Refresh Lookups . A refresh lookups will also need to be performed after adding custom fields to the synchronization configuration.

 

...

For each project in ET that you wish to synchronize with a project in your external system you will need to create a project link. There are 2 areas where you can create and configure your project links: The links tab of your external system or from the Project Links on the Resources tab of the navigator.

External System Links Tab

Once you have created your connection to the external system, click on the Links tab from the Edit External System screen. Click on Add from the tool bar.

Image Removed

The Add External System Link screen will appear. Complete the name and select the Link Source. This is the entity type you wish to synchronize only the entity types that are available to your external system type (EA, JIRA, Rally, TFS) will be available for selection.

Image Removed

Once you have selected the Source, additional fields to configure the ET project and the project will appear.

 

Image Removed

 

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. Please see the help topics for the tool you are integrating with. See the end of the page for a list of topic links. 

Resources Tab

From the Resources tab, click to expand Project Links. To view all configured links for your project, double click on your project.

Image Removed

To create a new project link select "New" from the toolbar or from the navigator you can right click on your project and select Add New Project Link from the menu or from the navigator you can right click on your project. Complete the details selecting the JIRA connection that you created in the steps outlined in the above section and your JIRA project to link to. Now click on Save.

Image Removed

Once the project link to JIRA has been created, Enterprise Tester will initiate a refresh of all the metadata. This may take a few minutes.

Once the refresh look up completes, the next step is to complete the field configurations. Please see the help topics for the tool you are integrating with in the section below.  

...

Listed below are some additional help topics which describe the field configurations required for each external system. 

Enterprise Architect

Synchronizing Requirements

Synchronizing Incidents with JIRA 5.2 and above

Synchronizing Requirements with Rally

Synchronizing Requirements with TFS

Synchronizing Incidents with TFS