|
JIRA and Confluence were designed to complement each other. We've all seen projects where people try to store all their knowledge in the issue tracker, and we've seen projects where people have suffered trying to track issues in a knowledge management tool. We say: collect your team's thoughts, plans and knowledge in Confluence, track your issues in JIRA, and let the two applications work together to help you get your job done. Here are four ways you can get JIRA and Confluence working together: use Confluence shortcuts to make easy links to JIRA issues, use trackback for two-way linking between Confluence and JIRA, use macros to include JIRA reports in Confluence pages, and integrate your JIRA and Confluence user management. Combine Confluence Shortcuts and JIRA Quick SearchThe simplest ideas can often be the most useful. In our Confluence site's global configuration - Administration > Shorcut Links, we have the following shortcut defined: JIRA: http://jira.atlassian.com/secure/QuickSearch.jspa?searchString=
This way, it's simple to create links using Confluence's shortcut notation. Link directly to JIRA issues: CONF-1000, or use JIRA's intuitive quick-search functionality to create links to particular groups of issue: CONF open improvements will link to a list of all open issues in the Confluence project of type "Improvement" (try it and see!) Use Trackback for easy two-way linkingActivate Trackback in JIRA and Confluence, and if someone makes a link from one application to the other, the link will automatically lead both ways: create a link from a JIRA issue to an example in a Confluence page, and the Confluence page will automatically know to link back to the JIRA issue, and vice versa. This is the perfect way to keep discussion connected to an issue.
(Note: as of Confluence 1.0 and JIRA 2.6, there is no mechanism for trackback to log in to JIRA or Confluence, so the use of trackback is limited to pages that are visible to anonymous visitors. In a protected Intranet environment, you may wish to open up Anonymous access to JIRA and Confluence to allow trackback to take place. Future revisions of the applications will give you the opportunity to allow Confluence to "log in" to JIRA and vice versa, avoiding this limitation) Use the {jiraissues} and {jiraportlet} macros to embed JIRA reports and portlets into your Confluence siteAny JIRA search-result can be embedded in a Confluence page using the {jiraissues} macro with your choice of included fields and field ordering, and any JIRA dashboard portlet can be embedded in a Confluence page using the {jiraportlet} macro. This way you can incorporate information from JIRA into the normal flow of your knowledge management. Combined with other macros like {junitreport}, {rss} and {html-include} and the FatCow suite, you can create dashboards in Confluence consolidating information from across your project, with Confluence and JIRA at the centre. For Confluence 2.7.0 and later, an administrator can configure JIRA (3.12.0 or later) and Confluence to communicate in a trusted way, so that Confluence can request information from JIRA on behalf of the currently logged-in user. JIRA will not ask the user to log in again or to supply a password. Trusted communication is used when embedding information from one application (e.g. a list of JIRA issues) into another application (e.g. a Confluence page). Read more about trusted communication. Link to Confluence pages from JIRA issuesWhile it is possible to simply paste links to Confluence pages into text fields of an issue (e.g. descriptions), the JIRA Linker Plugin provides a custom field that helps you find the correct page. Integrate JIRA and Confluence user-managementTo save you having to enter users into both JIRA and Confluence, you may benefit from using Atlassian Crowd as the user-repository for both applications. Alternatively you can configure Confluence to use JIRA's user database (this requires that you are using JIRA with an external database; it will not work if you are using JIRA with an embedded HSQL database). Some useful extensions
And much more coming...When you buy a license for JIRA or Confluence, you are automatically entitled to a year of updates. We listen to our customers needs, and having our products complement and work well with each other is very important to us. So if there is any way you think Confluence and JIRA could be made to work better, suggest it in our discussion space, and it may very well end up in a future version. You might also like to take a look at our beyond JIRA page or watch the short video overview on some of these points in .mov format. |
Take a look at the technical guide to the process of 
Comments (25)
Apr 04, 2005
Adam Reynolds says:
Is there any news on JIRA and Confluence being able to 'log-in' to one another s...Is there any news on JIRA and Confluence being able to 'log-in' to one another so that they can trackback and automatically create links to each other yet? We're evaluating the latest version of JIRA Enterprise and Confluence.
Jun 28, 2005
Anonymous says:
I'd like to see trackback working for protected pages as well. Please update us!...I'd like to see trackback working for protected pages as well. Please update us!
Aug 15, 2005
Anonymous says:
Is there any way to utilize the project categories and projects in JIRA to produ...Is there any way to utilize the project categories and projects in JIRA to produce spaces and pages in Confluence? Can Confluence and JIRA use the same project database? It would be nice to set up a project in JIRA, and have a project space set up in Confluence automatically.
Aug 15, 2005
Tom Davies says:
There's no way of doing this at the moment.There's no way of doing this at the moment.
Nov 10, 2005
Willie Doyle says:
I would really like to see you add trackback for authenticated installations. We...I would really like to see you add trackback for authenticated installations. We have to have people login for various reasons. Is this currently slated for development?
Feb 01, 2006
Thomas Blood says:
Is trackback for authenticated users on the horizon? I would be very interested ...Is trackback for authenticated users on the horizon? I would be very interested in this feature as well, and you have not replied to the previous comments.
Feb 07, 2006
Jens Schumacher says:
Trackback for installations requiring authentication is currently not on the roa...Trackback for installations requiring authentication is currently not on the roadmap for the next release. Please watch the corresponding issue [1] to be updated when we make progress with this issue. Also, if you haven't done so already, please vote for the issue to raise it's priority.
Cheers,
Jens
[1] http://jira.atlassian.com/browse/CONF-4744
Mar 10, 2006
Dimitry Voytenko says:
Is there an easy way of combining Confluence and Jira together? I.e. I'm looking...Is there an easy way of combining Confluence and Jira together? I.e. I'm looking for "feature A" and get:
Confluence matches:
1
2
...
more
Jira matches:
1
2
...
more
thanks,
Dimitry
Mar 15, 2006
Matt Ryall says:
There are two outstanding feature requests that cover this functionality: CONF-2...There are two outstanding feature requests that cover this functionality: CONF-2689, CONF-1436.
May 04, 2006
Shirley Keddy says:
Could you provide examples of "Combined with other macros like Unknown macro: {j...Could you provide examples of "Combined with other macros like
Or perhaps there are already examples in the Demonstratin Space?
Thank you.
May 15, 2006
Matt Ryall says:
Hi Shirley, If you edit a page in Confluence, there is a link to the 'Notation ...Hi Shirley,
If you edit a page in Confluence, there is a link to the 'Notation Guide' on the right-hand side. Open this, and under External Content, you can see examples of including Jira content and JUnit results.
I've also set up a sample little dashboard to demonstrate how you might do this in Confluence:
http://confluence.atlassian.com/display/TEST/My+dashboard
Feel free to play around with this.
Regards,
Matt
Jan 25, 2007
chenmin says:
when I written a shortcut like: [PRJNAME+open+Tasks@jira], I got a link: &...when I written a shortcut like:
[PRJNAME+open+Tasks@jira], I got a link: http://192.168.0.2:8080/secure/QuickSearch.jspa?searchString=PRJNAME%2Bopen%2BTask , so I can't get any result .
I think the correct link should be:
http://192.168.0.2:8080/secure/QuickSearch.jspa?searchString=PRJNAME+open+Task
Could you tell me how to write the shortcut to get a right link,
Regards
Matt Chen
Jan 25, 2007
chenmin says:
btw, confluence 2.2.8, JIRA 3.6.4 standalonebtw, confluence 2.2.8, JIRA 3.6.4 standalone
Jan 25, 2007
Mei Yan Chan says:
Hi Chenmin, Please try the following parameter: PRJNAME open Tasks Note that ...Hi Chenmin,
Please try the following parameter:
PRJNAME open Tasks
Note that the additional '+' sign is substituted by a 'space' as the browser will interpret it for you. I have tried it both with Firefox and IE and they work perfectly. Please give that a go and let me know how it goes. Thanks.
Regards,
Mei
Jan 25, 2007
Mei Yan Chan says:
A clearer parameter (the above is 'macroed') [PRJNAME open Tasks@jira] Regard...A clearer parameter (the above is 'macroed')
[PRJNAME open Tasks@jira]
Regards,
Mei
Jan 29, 2007
chenmin says:
It really works~! Thank you very much~It really works~!
Thank you very much~
Aug 28, 2007
Kari Sutela says:
How would I define a link to a "free text" search with e.g. two words both appea...How would I define a link to a "free text" search with e.g. two words both appearing in a text box? For example, writing "web+integration" in the jira quick search box works fine, but I cannot find a way to define a corresponding link in Confluence.
I have tried [PRJNAME web+integration@jira], [PRJNAME web integration@jira] etc with no luck.
Aug 28, 2007
Kari Sutela says:
Found it! Underscore appears to work: [PRJNAME web_integration@jira]Found it! Underscore appears to work: [PRJNAME web_integration@jira]
Jul 17, 2007
Jacy Legault says:
Is there a way to link from Jira to a specific version (historic) of a page...Is there a way to link from Jira to a specific version (historic) of a page in confluence? I noticed that confluence creates new pageids for older pages, which are stable once they have been made historic.
Jul 18, 2007
Fennie Ng says:
Hi Jacy, Could you please elaborate more on how you want to link a Confluence p...Hi Jacy,
Could you please elaborate more on how you want to link a Confluence page from Jira? As I know, there is a Jira Linker Plugin for Jira custom field to link with Confluence page. Would that plugin be of help?
Regards,
Fennie.
Aug 04, 2007
Sasha Zucker says:
It should be noted that to use the Jira Linker Plugin, you currently have to gra...It should be noted that to use the Jira Linker Plugin, you currently have to grant anonymous access to the spaces on confluence that you want the plugin to be able to search. For organizations that are using confluence to store proprietary information, this requirements is unacceptable.
Please add a note to this effect so that administrators don't spend hours trying to figure out how to get the plugin to work only to find out at the end that the plugin has unacceptable requirements.
Sep 21, 2007
Ki Alam says:
The Linker Plugin's need for Anonymous RPC access has made it untenable. ...The Linker Plugin's need for Anonymous RPC access has made it untenable.
our developers would like to link to confluence pages more simply in the comment section of issues/subtasks:
It would be cool to have a list of external wikis (confluence1, confluence2) in the admin section so that something like this would work.
Sep 23, 2007
Mei Yan Chan says:
Hi Ki, Thanks for your suggestion. I would advise you to create an issue ticket...Hi Ki,
Thanks for your suggestion. I would advise you to create an issue ticket at our issue tracking system:
Feel free to get back to me if you need further assistance. Thank you.
Regards,
Mei
Nov 19, 2007
Joshua Goodall says:
Embedding the password is a huge no-no in most environments. Looking forward to...Embedding the password is a huge no-no in most environments.
Looking forward to http://jira.atlassian.com/browse/JRA-13727 in 3.12!
Dec 11, 2007
Sarah Maddox says:
Hi Joshua With Confluence 2.7 and JIRA 3.12, this should be good to go Cheers &...Hi Joshua
With Confluence 2.7 and JIRA 3.12, this should be good to go
Cheers – Sarah
Add Comment