Mar 062014

jira_logo_landingMagicDraw and Atlassian JIRA are popular products, which usually can be spotted in software collection of enterprise. So a natural and common question rises, how they can work together?

In most cases JIRA serves as an issue tracking system with the ability to have custom workflows, approvals, states, etc. MagicDraw in most cases is used as a repository for architecture, or a single source of well-structured information, be it requirements, business processes, software, or system design.

Long story short:

  • A link to the capability, bug or change request (let’s call it an item) in JIRA can be added to the requirement, design element, test case, package, or diagram (let’s call it element) in the MagicDraw modeling project.
  • Vice versa, starting from MagicDraw v17.0, a link to a model element can be created and added into a JIRA item. Click on this link and MagicDraw will start with the required project, and the element will be selected in it.

Link from issue tracking software to MagicDraw

How to create the link to the model element?

You can copy a MagicDraw project element URL to a clipboard and share it with others as a quick reference to model elements. To copy a project element URL, do either of the following:

  • Select Copy URL from the element shortcut menu in the Containment tree to copy the URL to a model element


  • Select the element symbol in a diagram and click Edit > Copy URL on the main menu to copy the URL to element symbol

copy url

Note: A custom solution is available with usability enhancements:

  • Copy link as hyperlink: Copy ULR for JIRA
  • Copy multiple selected elements URL in single action

Where to add the link in JIRA?

In the below picture we can see the capability recorded in JIRA. The link to the model element is added  into the description field. It is up to the process whether it will be an Analysis Sub-task or directly a capability, which will have the link. Either the link be added into description field, as we can see here, or a dedicated field will hold the link.

hiperlink to elementHow to open a MagicDraw project and select a particular element in it from the link?

There are a couple of methods available:

1. Double click on the link in JIRA. Once clicked on the link, MagicDraw  starts, an automatic connection to Teamwork Server is performed, the project is opened, and the linked element is shown as selected.


  • In the local project (not on Teamwork server) case, MagicDraw will started with request to point to required project.
  • Starting from v17.0, custom URL “mdel://” is registered into windows registry on MagicDraw installation.
  • Most recently installed MagicDraw will start on click on link.
  • Your Internet browser could have a different version of MagicDraw associated with its protocol.

2. Copy the URL, click the Open Element from URL (from MagicDraw File main menu) command and the element will be highlighted in the Containment tree or in the diagram.

open url

Link from MagicDraw to issue tracking software

There are a couple of methods to add the JIRA item link to the model element:

  1. Just drag and drop the JIRA item URL on any model element. The hyperlink will be created.
  2. Use a dedicated property in the element to hold the JIRA item ID.

link to jiraLeave a comment if you have different integration needs, would like to share personal insights, or would just like to say hello, we are always happy to hear from you!

5.00 avg. rating (99% score) - 3 votes

  3 Responses to “Manual MagicDraw and JIRA Integration”

  1. Avatar

    What version of JIRA is required for this? If I paste the URL in my JIRA comments, I just get an unclickable mdel URL.

  2. Any JIRA version shall work. There is small MagicDraw plugin which allows to format same URL as hyperlink.

  3. Is there a source for this plugin? Will it work without? (Don’t have access to software to test atm.)

 Leave a Reply

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>



Time limit is exhausted. Please reload CAPTCHA.