Is it possible to automatically link documentation from Confluence to a Jira issue?

Jennifer Hemmens February 27, 2019

Hey everyone!

We're currently working really hard to set up our Jira & Jira Service Desk environments as well as possible before we fully implement it as our issue tracking tool. While my colleagues are sorting that out, I'm working on organizing our (comprehensive) Confluence documentation as logically as possible.

What we want, is that when a Jira issue is created, related documents that could be helpful in resolving it are automatically linked to the issue. This would save our engineers time in looking for the appropriate documents and linking them to the issue(s) themselves.

Is it possible to do this? For example, by means of labels/components/epics?

Thanks!

Jen

2 answers

1 vote
Davin Studer
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
February 27, 2019

Another option would be to do it with ScriptRunner. You could create a listener script that would fire off on issue creation that could then scan through your Confluence system using the REST API and create links to the pages that match your logic.

Jennifer Hemmens February 28, 2019

Hi @Davin Studer thanks!

0 votes
Tarun Sapra
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
February 27, 2019

Hello @Jennifer Hemmens 

Atlassian already provides a similar feature as to what you require. Basically you can link your Service desk with Confluence knowledge base So that Customers and Engineers don't spend time on repetitive tasks and solutions. 

https://confluence.atlassian.com/servicedeskserver/set-up-a-knowledge-base-for-self-service-956713310.html

 

Jennifer Hemmens February 27, 2019

Hi @Tarun Sapra ,

Thanks for the link! I could only find information regarding linking the Confluence knowledge base to ServiceDesk for anonymous users, which is something we wish to avoid.

Are the links to the documentation automatically included in a Jira issue that has been created based on a ServiceDesk ticket?

Tarun Sapra
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
February 27, 2019

Hello @Jennifer Hemmens 

The links to the documentation are not automatically included, but the customer can quickly do a search 

But the linked documentation can appear automatically as the customer types in the request in the JSD, see pic below from docs. Also yo ucan customize the permissions for JSD and the docs as to who can see and who can't

Tarun Sapra
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
February 27, 2019

Hello a page from the knowledge base article can be displayed in the issue view screen if the content of the tickets matches that of the page.

See below in the screenshot "Related knowledge base articles"

Like Jennifer Hemmens likes this
Jennifer Hemmens February 27, 2019

@Tarun Sapra it won't be difficult for us to get the user documentation for our software linked to customer requests, and it's a great feature!

My question is more directed towards our side of the ServiceDesk/Jira environment. When a ticket comes in, a ServiceDesk Agent will determine whether it is to be taken up by our project team or our development team.

We'd like the following:

Based on whatever component/label/etc. the ServiceDesk Agent assigns the Jira issue(s) deriving from the ticket, these issues automatically receive links to certain related pages of our engineering and/or developer manuals that might be of use to the engineer/developer who the issue is assigned to.

I know it's always possible to link a Confluence page to a Jira issue, however, adding these manually takes up unnecessary time.

My question really is, is it possible to somehow link Jira and Confluence labels?

So say I had a page in Confluence labelled <user-interface>, and a Jira issue that has the same component or label <user-interface>, Jira would automatically search for any pages in Confluence and add these as links?

Tarun Sapra
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
February 27, 2019

Hello @Jennifer Hemmens 

In this screenshot, Jira has automatically picked up the pages (based on content) from the knowledge base article. But exact underlying algorithm, if it's component based or label based etc can may be shared in more detail by someone from Atlassian. But the page links are automatically displayed based on the content of the ticket and content of the linked knowledge base article

Like Jennifer Hemmens likes this
Jennifer Hemmens February 27, 2019

@Tarun Sapra I was just typing a reply and then Atlassian logged me off... haha!

That's definitely more along the lines of what we're looking for!

However, it seems to only be available in ServiceDesk. Do you happen to know if it's also possible to add this module to Jira issue screens? As I said, what's more important is that our engineers/developers can quickly access helpful documentation - especially juniors who are just starting to get the hang of things...

Thanks for your help so far :)

Tarun Sapra
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
February 28, 2019

Hello @Jennifer Hemmens 

The documentation links available on the JSD ticket can easily be restricted to only dev teams and agents. Thus, the dev teams can easily access them via the linked JSD ticket. 

Suggest an answer

Log in or Sign up to answer
TAGS
AUG Leaders

Atlassian Community Events