You can integrate Sparx Enterprise Architect with Jira through Prolaborate. Creating a two-way link between Sparx Enterprise Architect elements (say Usecase) and Atlassian Jira issues (say Epic) just got easier through Prolaborate.The workflows involved are
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:
|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.
As we want the Jira link to be a part of Sparx 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:
|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.
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.
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 Sparx Enterprise Architect item and click on Add. Click on Save in the Properties Window of this item.
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.
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 Sparx Enterprise Architect element has also been added.
Let us assume certain users use only Sparx Enterprise Architect. They will also be able to see the links added to an element from Prolaborate.
As you can see, the Jira attribute has been added as a tagged value. You can click on browse button to view the issue link in a browser.
You can edit or delete the integrations from the Integrations page. Edit Application will be useful if you want to change the credentials.