Please enable JS

Enterprise Architect Jira Integration

January 22, 2017

You can integrate Enterprise Architect with Jira through Prolaborate. Creating a two-way link between Enterprise Architect elements (say Usecase) and Atlassian Jira issues (say Epic) just got easier through Prolaborate.

The workflows involved are
  1. Configure Jira Account
  2. Add Jira Attribute
  3. Add Jira Attribute to a Stereotype’s Form
  4. Link Jira issues to Enterprise Architect elements
  5. Preview JIRA Items
  6. View JIRA issue links from Enterprise Architect
  7. Manage Integrations
  8. Manage Integration Attributes

Configure Jira Account

To integrate with Jira, Prolaborate needs the details of your organization’s Jira account. To create the integration bridge, you need to create an application as detailed below.

Click on the Menu > Integrations. You will be taken to the Integrations page.

Click on Add New Application to add an application and enter the details as below:

Field Description
Name Enter a name which can be understood by your users. For example, name of the Jira project which you are going to select.
Description Give a description to the application
Status It would be set to Active as Default. Please do not change it unless you don’t want to use it anywhere in Prolaborate
Application It would be set to Jira as Default as we currently, we support integration only with Jira
Application URL Enter the url of your Jira acount. For example, https://prolaborate.atlassian.net/
Username and Password Enter the Username and Password using which an admin logs into your Jira account. It is advised to use an Admin’s credentials so that there will no restrictions in access. Please note, Prolaborate’s access to Jira will depend on these credentials.
Validate Connection Click on this button once you have entered Application URL, Username and Password. If the credentials worked fine, you will get a success message and Projects field will be enabled.
Project Select a Project which you want to Connect to. If you use multiple projects in Jira, you can add another project in a similar way.
Dashboard Widget Filters

Choose the option which best suits your requirements: Show My Filters – Show the filters from Jira which are created by the User given above

Show Starred Filters – Show all the filters that are starred by user given above.

Click on Add Application to complete adding the application and the new application will appear in the Integrations page.

Add Jira Attribute

As we want the Jira link to be a part of Enterprise Architect’s items, we need to create an Jira attribute and configure it for the stereotypes we need. If you want the Jira attribute to be a part of all stereotypes, that can be done as well.

Click on Menu > Modeling Languages.

Click on Manage Custom Attributes button on the top and you will see the list of custom attributes which are already created in this repository.

Click on Add and choose Attribute Type as Integration Attribute. Fill in the following details:

Field Description
Name Give a name to the Attribute. “PROL_” will be prepended by default
Application As of now, only integration with Jira is possible. So, you can select All or Jira
Application Name Select the Application or Project Name
Item Type Select the Item Type(s) you want to link in Prolaborate. This will be useful if you want to refine the list of Jira issues you want to see in Prolaborate.

Click on Save to add the new integration Attribute.

Add Jira Attribute to a Stereotype’s Form

Let’s configure the newly created Integration Attribute to a Stereotype. By doing this, we will be able to add a Jira issue link to that stereotype.

For example, let’s add it to Activity stereotype belonging to BPMN 2.0. In the Modeling Languages page, click on Manage Profiles to see the list of Profiles created for this MDG.

Click on Edit on the Active profile.

Click on the Form Designer of the Stereotype you want to add the Jira attribute to. As per our example, it is Activity.

Add the Jira attribute from Custom Attributes section to the form.

Save the form and click on Update Profile in Edit Profile page to save the changes.

Link Jira issues to Enterprise Architect elements

When you open the Properties window of the stereotype which we configured just now, it will show the Jira attribute.

Click on the plus icon in the attribute and select a Project in the Add Links window.

All the issues which are part of the Project will appear in this window. Please note the issue types which get shown here will be based on the Item type you chose while adding this integration attribute.

You can Search for the item if you know the title of the Jira item or you can filter the list by item type using the All Item Type dropdown.

Select a Jira item which you want to link to this Enterprise Architect item and click on Add. Click on Save in the Properties Window of this item.

Preview JIRA Issues

After you save, click on References in the Properties window. All the Jira links which you have added will be visible here.

Click on the eye icon to preview the Jira issue.

Note: As you notice, Jira bubbles will be added on the element in the diagrams along with the count of the Jira issues it has been linked to. You can even click on that bubble to see the list of Jira issue links.

You can see all the basic details of the issue from Prolaborate itself. To view the complete details and to edit this issue, click on Open in Jira.

Jira issue will open in a new tab and if you notice, a link to this Enterprise Architect element has also been added.

Manage Integrations

You can edit or delete the integrations from the Integrations page. Edit Application will be useful if you want to change the credentials.

Note: Update the password in Prolaborate if your password has expired in Jira and you have updated it in Jira.

Manage Integration Attributes

You can view or delete Integration attributes from the custom attributes window.

Here’s a video of the Integration to see how it really works.

Any questions? Contact us