If you use JIRA and have your Confluence and JIRA instances connected using Application Links you can display and create JIRA issues and more from within Confluence.  Some of these features require a specific version of JIRA.

This page provides some basics to get you stared working with JIRA issues in Confluence. 

Displaying JIRA issues

You can display JIRA issues on a Confluence page using the JIRA Issues macro.  You can display a single issue, a list of issues, or show the total number of issues.

One of the simplest ways to add a JIRA issue to a page is to paste a JIRA URL. For example:

  • <yourjirasite.com>/browse/CONF-1234 will insert the JIRA Issues macro and display a single issue.
  • <yourjirasite.com>/issues/?filter=56789  will insert the JIRA Issues macro and display a list of issues matching the saved filter. 
  • <yourjirasite.com>/issues/?jql=project%20%3D%20CONF  will insert the JIRA Issues macro and display a list of issues matching the JIRA search. 

Alternatively you can add the JIRA Issues macro to the page and use the macro browser to search for issues directly. 

  • エディターで挿入 > JIRA 課題を選択します。
  • Follow the prompts in the macro browser to choose a project and search for an issue - you can even use JIRA Query Language (JQL).

You can customise how the issue or list of issues appears on the page, including how much information to display, how many issues, and more. 

Find out more about using the JIRA Issues Macro. 

Creating JIRA Issues

You can create issues from a page, or from the editor. This is particularly useful if you use Confluence for requirements gathering. 

ページの表示中に課題を作成する方法

  • Highlight some text on your page - a panel with appear near your selection.
  • Choose Create JIRA Issue.
  • Follow the prompts to enter information about your project and issue - your highlighted text will populate the issue summary.
  • Choose Create - the issue will be created in JIRA, and added to your page.

If your text is in a table, you will have the option to create multiple issues using text from the same column. 

エディターで課題を作成する方法

  • エディターで挿入 > JIRA 課題 > 新しい課題を作成を選択します。
  • Follow the prompts to enter information about your project and issue.
  • Choose Insert - the issue will be created in JIRA, and added to your page.

There are some limitations when creating JIRA Issues from Confluence, particularly if you have required fields or custom field configurations. You can find out more in the JIRA Issues Macro page. 

レポートとグラフを作成する

Reporting on information stored in JIRA couldn't be easier in Confluence. In addition to the JIRA Issues Macro, you can use the JIRA Report blueprint or JIRA Chart macro. 

以下のことが可能です。

Prompting users to add JIRA Issues to a page

テンプレートを使用する場合 (ブループリントにより提供されるテンプレートを含む)、 JIRA課題プレースホルダーを追加できます。これをクリックすると、JIRA 課題マクロが開き、JIRA 課題の検索または作成を促すプロンプトが出されます。

You can see the JIRA Issues placeholder in the Product Requirements blueprint.

See Adding a Template for more information on using instructional text and placeholders.

Confluence と JIRA 間の接続を表示する

The JIRA Links button gives you quick access to issues connected to the Confluence page you are viewing.  

リンクは次の場合に表示されます。

  • you have created or added single issues to the page using the JIRA Issues macro in Confluence.
  • you have added a link from the issue to the Confluence page in JIRA.

If you use JIRA Agile, sprints and epics will also appear on the JIRA Links button. 

The number on the JIRA Links button indicates the total number of issues connected to that page, regardless of whether you have permissions to view the issues. The dropdown will only show issues, epics and sprints that you have JIRA permissions to view. 

Note: The JIRA Links button only appears in the default theme. It is not visible in the Documentation theme. 

 

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.