Upsource + JIRA Integration

Maria Khalusova

Did you know that you can integrate Upsource with JIRA? It’s super easy, and not only it’ll allow you to have links to JIRA issues in Upsource, you will be able to create JIRA issues straight from a code review page in Upsource.

Let’s say, I have a project called MyAwesomeProject with default settings in JIRA with the key MAP. Now, if I want to report an issue to that project from a code review, I need to open my Upsource project settings and specify very little: JIRA URL, admin credentials, and project key.

jiraSettings

That’s it, you’re ready to report issues from a code review:

create-Issue

Upsource will automatically create an issue in JIRA:
map-3

You can even create issues from discussions:
emptyCatch

Issues reported from Upsource will all have the same type. Which one? The one that you have on top of the list here (Issues → Issue Type Schemes):
issue-type
You can reorder these types in JIRA settings, so that something else is on top, and then the issues reported by Upsource will have a different type.

The default types of issues are all suitable for Upsource, but if you want to have a customised issue type for Upsource issues, make sure it has following issue fields enabled: Reporter, Summary, and Description.

Depending on how much you have customised your JIRA instance, you may or may not need to fine-tune some settings to enable this integration. Feel free to check out our documentation.

Comments below can no longer be edited.

13 Responses to Upsource + JIRA Integration

  1. Yury V. Zaytsev says:

    November 2, 2015

    Would be cool if Redmine was supported as well!

  2. Jeffrey says:

    February 29, 2016

    Why does it require a 3 letter key? Our company only uses 2 letter keys, which are valid in JIRA

  3. Eric B. says:

    March 23, 2016

    Can the integration go the other direction, too? For example, in our current implementation with Crucible, JIRA has a section that list the associated reviews.

    Would that same capability be possible with Upsource?

    • Marcel says:

      April 14, 2016

      Is there something about this or an answer?

    • Artem says:

      April 14, 2016

      Are we going to to design and additional filed on Jira side to show corresponding Upsource reviews? Probably yes, if Jira guys don’t do it before.

      So far no estimates yet.

  4. Patrick says:

    April 13, 2016

    Sounds nice.

    Will it be possible to automatically create a review from a Jira issue when a certain status transition is triggered (i. e. from “in progress” to “in code review”)?

    And, will it be possible to trigger another status transition once that code review is marked as “accepted” in upsource (i. e. automatically set the linked ticket from a status like “in code review” to e. g. “in deployment”)

    Would of course require some config depending on the workflow, and would require a detection if the status has changed during review timespan (in that case, the manually altered ticket status should not be modified).

    • Artem says:

      April 14, 2016

      Not in the current version, but we would like to implement it in the nearest future. Please upvote/watch corresponding request – https://youtrack.jetbrains.com/issue/UP-5092

      • Patrick says:

        April 21, 2016

        Thank you for the pointer. I very much hope this will be implemented soon.

  5. Chris says:

    June 2, 2016

    I think in the newest version there is no link “Create issue” 🙁

    • Maria Khalusova says:

      June 2, 2016

      Hi Chris! It should be there. Can you please write an email to our support, so we could figure out what went wrong?
      upsource-support@jetbrains.com

  6. Timur says:

    November 1, 2016

    Hi!
    Sorry, I didn’t get how to “have links to JIRA issues in Upsource”. I take it that it’s something more than just copy “http://JIRAADDRESS.com/browse/PROJ-9999” and paste in in comment? What’s exactly jira specific here?

    Would be nice if, f.e. when review’s being created from branch, it’s name would be parsed in search of PROJ-9999 and if it matches to some real existing ticket “http://JIRAADDRESS.com/browse/PROJ-9999” link to it automatically appears at the top of review (near the name of review or even inside it).

    Or is there some macro we can specify to mention some ticket and link to it will appear with some additional info, like confluence do it in atlassian?

    Thanks.

  7. Ulli says:

    April 18, 2017

    We need to add multiple Jira projects for UpSource project …How to handle it

    • Valerie Andrianova says:

      April 20, 2017

      Unfortunately, we don’t provide this ability at the moment. However, here is a feature request: https://youtrack.jetbrains.com/issue/UP-7813. Please watch it for the updates.
      Thanks!

Subscribe

Subscribe for updates