ReqSuite® Requirements Manager (RM)
EA Add-In

In analogy to the other data exchange interfaces for the export and import of project contents, the ReqSuite® RM allows for the synchronization of data objects between ReqSuite® RM projects and projects of an Enterprise Architect (EA) installation. However, in contrast to the other supported up-/downstream tools, EA does not provide a REST API service, so that it needs to be extended by a corresponding client software in virtue of an EA Add-In that needs to be installed first.

Figure 1. Ribbon bar of Enterprise Architect after installation of ReqSuite® EA Add-In.

Installation
The most recent version of the ReqSuite® EA Add-In associated with the latest ReqSuite® RM release can be downloaded here. After unzipping the downloaded archive, run the contained executable and go through the guided installation process in order to install the required software extensions.

Figure 2. Settings window of the ReqSuite® EA Add-In for the definition of connections between ReqSuite® RM and EA projects.

Setup
Once the ReqSuite® EA Add-In is installed, open EA, click on the button named “ReqSuite®” in the Add-Ins button category and choose “Settings…” from the appearing drop-down menu (see Fig. 1). Now, provide the required login credentials in the text fields under “Server Data” on the left-hand side of the opened window and click “Save” button to store them. Next, click on button “Create” on the right-hand side of that window and select the ReqSuite® RM project from the list of projects available for the logged-in user along with the EA project it shall be associated with by picking the corresponding EA project file from the file system (see Fig. 2).

Figure 3. Editing window in the ReqSuite Designer for the definition of the EA model representation for a content category.

Figure 4. Editing window inf the ReqSuite Designer for the definition of the EA model representation for a content category relationship.

Figure 5. Editing window in the ReqSuite Designer for the definition of the EA model representation for a notation.

Mapping
For the synchronization of project content data to work, the corresponding content categories need to be explicitly mapped to EA model diagram types. To this end, open the edit dialog for that category in the Designer and select the appropriate diagram type under “Model Representation” such as BPMN Activity, SysML Block, or UML Use Case to name just a few of the available options (see Fig. 3) . In order to also map the relationships between content categories to corresponding model relations, open the edit dialog for the relationship in the Designer and select the appropriate relation type under “Model Representation” such as UML Control Flow in case both related categories are represented by UML Activity diagrams in EA (see Fig. 4). Besides, the model diagram type can be optionally associated with any notation also definable in the Designer (see Fig. 5).

Figure 6. Ribbon bar of Enterprise Architect after installation and configuration of ReqSuite® EA Add-In ready for data synchronization.

Synchronization
After finishing the mapping of content categories and their respective relationships to EA-specific data types, the unidirectional synchronization of concrete content elements can be performed. This is done via clicking on drop-down menu option “Download data” or “Upload data”  (see Fig. 6) in order to either merge the data from ReqSuite® to EA or vise versa, respectively. Finally, Figure 7 depicts an exemplary EA workspace after the successful synchronization with a ReqSuite® RM-based project has been performed.

Figure 7. Enterprise Architect workspace after exemplary synchronization of ReqSuite® RM category elements with EA data objects.

Note: Due to the nature of the EA interface integration with ReqSuite® RM and in contrast to the other data exchange interfaces, category elements can neither be synchronized from within ReqSuite® RM nor can be synchronized in an automated way.