
The EA TFS Connector is a free and open source add-in for Sparx Systems Enterprise Architect.
It synchronizes workitems between EA and TFS (Microsoft Team Foundation Server)
The EA TFS Connector uses the REST API web-service of TFS to synchronize items, so no local TFS installation is required.
Download
Prerequisites
EA TFS Connector requires .Net framework 4.5 which is already installed on most Windows installations.
Installation
EA TFS Connector is part of the Bellekens EA Toolpack which includes other useful add-ins such as
When installing you can choose which of the tools you wish to install.
Configuration
In order to be able to see the correct statuses in you should configure all possible statuses from TFS as status in EA.
Use Configure | Project Types | General Types to configure the statuses in EA
Usage
Once installed you will need to configure the add-in. Select the option Extensions | TFS Connector | Settings
Settings
- TFS URL: sets the URL for the TFS server
- Default Username:Â The username that will be used by default when connecting to TFS
- Default Workitem:Â The default type of workitem on TFS when creating new items
- Default Status:Â The default status to use for new workitems on TFS
- Default Project:Â When the project is not set on a package level (see Set Project) this project will be used by default.
- TFS Filter Tag:Â The tag to be used to filter the workitems to synchronize to EA. If empty all workitems of the mapped types are synchronized. If filled in only the workitems with this tag will be synchronized.
- Workitem Mappings:Â Defines which EA type or Stereotype should be mapped to which TFS type. In case of stereotypes you have to use the fully qualified name of the stereotype (e.g. Architmate2::Archimate_Requirement)
Set Project
Right click on any package in the project and select Extensions | TFS connector | Set Project
Once set this project will be valid for this package and the whole three underneath this package.
TFS => EA
From a Package
Right click on the package where you would like to import the TFS workitems and select Extensions | TFS connector | TFS => EA
Select the type of workitem, and the type of EA element this should create.
When it is the first time in this session you connect to TFS you will be asked to enter your username and password.
The add-in will remember these credentials as long as EA is running.
When finished the add-in will inform you of the results:
From a single element
Right click on an element and Extensions | TFS connector | TFS => EA
This will update the workitem with the data from TFS.
EA => TFS
You can also use the other way around and update or create workitems from EA to TFS.
Again you can choose either to select either a package or a single workitem. Then right click and select Extensions | TFS connector | EA => TFS
When selecting a package all owned workitems (recursively) will be updated or created on TFS.
When selecting a single element only that element will be updated or created on TFS.
The addin will always inform you of the results just like the TFS => EA function
Open Website
Selecting the option Extensions | TFS connector | Open Website will open the TFS website.
If you choose that option on a single workitem then the page for that workitem will open. otherwise the page for the project will open.
Mapping
The following fields are mapped between TFS workitems and EA
TFS | EA |
Title | Name |
Details | Notes |
State | Status |
Iteration | Phase |
Area | TV: TFS_Area |
Workitem Number | TV: TFS_ID |
Assigned To | TV: TFS_AssignedTo |
Ext.Ref.ID | EA GUID (only from EA to TFS) |
Open Source
This software is free and open source under the FreeBSD license.
The code is managed on Github
Sponsor
The EA TFS connector has been developed with the support of