Create documents in confluence with data from Jira Software.

[Leonardo Zevallos Guzman]

Dear community, in the company where I am working, the need has arisen to use Confluence to document the Scrum artifacts that we carry out. We manage a format for these documents, for example user stories. We have this format


Is there a way that, for example, that format of a user story can be automatically populated by backlog data in a Jira Software project.

If there is a way, I would appreciate it if you could provide me with a small example so that I can implement it on a large scale if possible. Since with that I could reach my bosses with something sustainable so that we can acquire standard licenses for confluence. Thanks in advance

[Josh Costella]

Hi @Leonardo Zevallos Guzman 

If you just want to display the Jira tickets in a Confluence page, you can use the Jira issues macro to let you display all the stories in a table format. You can choose what columns (fields from Jira tickets) are displayed and it will update automatically based on changes in Jira. 

More information here: https://support.atlassian.com/confluence-cloud/docs/insert-the-jira-issues-macro/

[Leonardo Zevallos Guzman]

Sure, I appreciate that you sent me that link. But it's not what I'm looking for, that is, I know that Jira issues can be inserted into a table. But what I'm looking for goes further. For example, I can insert my values, for example from a user story, such as name, story point, responsible, sprint, acceptance criteria. And place them in my format that I established.

Or I don't know that when extracting it in table mode it has a more readable format where those fields are visible. because at the moment of downloading it in pdf or word only a link is extracted.

[Tracy Langston x2472]

I am looking for this as well Leonardo, did you ever find something that works?

[Leonardo Zevallos Guzman]

No, at the moment in the documentation I found the insertion of JIRA issues but in tables but that does not generate a format. If you find something, let me know.

[Josh Costella]

Hi @Leonardo Zevallos Guzman 

Unfortunately, there is no way to do this out of the box. However, I found a plugin that should help you get what you are looking for. You can design a template and it will publish ticket data in designated cells within your table. 

https://marketplace.atlassian.com/apps/1226102/elements-publish-helper-app-for-jira-integration?hosting=cloud&tab=overview

[Armin Meyer _Seibert - Coderay_]

Hi Leonardo,

I know two ways to achieve this. 

1) One-Time page creation with Jira Automation

Just use Jira Automation to create a page and with the help of smart values you can set jira field content into a structure you want. Creating a good looking page can be a bit of a pain.

Pros:

• It's built in and therefore cheap

Cons:

• It's a one way solution and keeping page and jira issue in sync is tricky
• Styling the page can be a pain, because you need to do it with markup

2) Use an app specialized for this use case like AutoPage or Elements Publish

There are two specialized apps in the marketplace covering the use case.

Autopage: https://marketplace.atlassian.com/apps/1218503/autopage-create-pages-in-confluence-from-jira-issues?hosting=cloud&tab=overview

Elements Publish: https://marketplace.atlassian.com/apps/1225519/elements-publish-create-confluence-pages-from-jira-issues?tab=overview&hosting=cloud

Pros:

• Good Templating options to built good looking pages
• Sync options to keep page and jira issue content in sync

Cons

• Extra costs

Cheers

Armin

[Clara Belin-Brosseau_Elements]

Hello @Leonardo Zevallos Guzman

Thanks @Josh Costella for mentioning Elements Publish, indeed, it could be a good solution for this use case.

If I understand correctly @Leonardo Zevallos Guzman, you’re trying to insert Jira issue fields in your custom Confluence template, right?

In that case, I would recommend trying our app Elements Publish that allows you to insert any Jira issue data in a Confluence page (and keep the value synchronized between the issue and the page if needed).

You can check the guide here.

The app is for free during 30 days (and it stays free under 10 users).