The Jira integration capability of Pro Cloud Server enables you to integrate your EA models with their corresponding Jira projects.
Here are some use-cases:
|We use EA for managing requirements and Jira for managing the changes||It is hard to trace the project tasks in Jira back to EA requirements, changes, and issues||Create EA elements based on Jira items and link them to requirements, changes, and issues in EA.
Now, it will be easy to trace the changes and their impact.
|We use EA for managing the requirements and a tool that can integrate with Jira for creating test cases||There is no efficient way to bring information from EA to Jira to let test teams create scripts based on the requirements||Create Jira stories based on requirements in EA easily. Test teams can view the information in their test tool.
Push changes from EA when they are done and add a comment in Jira using EA. Test teams will know the new changes and update the test cases accordingly.
Follow these steps:
To ensure the setup is done correctly, open Enterprise Architect and connect to any one of the models that has access to Jira.
Click on Specialize > System Integration > Open External Data. Click on Chevron icon
Select Jira > Jira > Chevron icon.
If the connection was successful, you will see the list of projects from Jira.
If no, EA will not be able to connect with Jira and you will not see any details. To troubleshoot, you can refer to the PCS integration logs (Typically located at C:\Program Files (x86)\Sparx Systems\Pro Cloud Server\SBPI\Logs).
You can view only those Jira items that are part of filters. So, create appropriate filters in Jira. For example, if you want to link EA Requirements to Jira User Stories, create a filter that will show the relevant User Stories.
Click on Specialize > System Integration > Open External Data > Jira > Jira.
Select a Project and open an appropriate filter.
All the Jira items that are part of the chosen filter will show up in EA.
To link an EA element to a Jira item, just drag and drop it. Let’s drag and drop List Stock Levels functional requirement on to its counterpart in Jira.
Once the two items are linked. you can do the following.
You can view the properties of a linked Jira item through the following ways:
Description of the item can be seen from the Notes window.
If there are too many items in your Jira filter and you want to simplify the view, you can do the following:
Ensure Types and Fields are mapped as per your requirements.
This mapping will be used when you want to
Click on Hamburger icon > Configure. Select an External Type and map its counterpart using Toolset, Type, and Stereotype.
For example, in the screenshot above, we are mapping Jira Stories to Functional Requirements in EA.
The next step is to map fields between the types. So, click on Configure Field Mapping in the Type Mapping window.
You can map fields from Jira to Properties or Tagged Values in EA.
Learn more about Type and Field Mapping here
To create a Jira item (Say a Story, Task, Bug, etc.), just select an element from the project Browser and then click on Hamburger icon > Create Linked Item.
An item will be created in Jira as per the Type and Field Mapping done above.
From the filtered view, if you want to create an EA element based on a Jira item, right-click on the Jira item > Create Local Element.
The following window will show up. Choose the Type and Package, select a diagram to add the element to, and enable Info View if needed.
This is the result of the above settings.
An element will be created in EA as per the Type and Field Mapping done above.
If there are any changes made after the elements and items are linked, you can see a red exclamation icon against them as shown below:
Now, you can do any one of the following:
If you want to pull multiple changes from Jira to EA, click on Hamburger icon > Synchronize Local Linked Elements. Select the type of element types, fields to update, and click on Synchronize.
After you have linked an item, pushed an update, or created a new Jira item, you can share your comments in Jira from within EA.
Open Collaborate window and click on a Jira item. If comments are added already, you can see them. You can now add your comments.
In this screenshot, you can see an user has added a comment about pushing the latest changes from EA to Jira. Then a Jira user has replied to it.