JIRA is the issue tracking and project management system supplied by Atlassian. By adding the JIRA Issues macro to a Confluence page, you can display one or more issues from a JIRA site. You can also choose to create an issue in JIRA, at the time of adding the macro to the Confluence page.

Before you can use this macro, your Confluence and JIRA sites must be connected via Application Links. People viewing the page will see the publicly accessible issues from the JIRA site. If your JIRA site has restricted viewing (that is, people need permission to view issues) then they will need to authenticate before seeing the restricted issues. See more about restricted JIRA issues below.

JIRA 課題マクロでできること

JIRA の課題マクロでできること :

  • Display a table of JIRA issues on your page, based on the results of a search using JIRA Query Language (JQL).
  • Jira の URL を使用して、ページ上に Jira 課題の表を表示する。
  • JIRA のサイトから単一の課題を表示する、または、JIRA のサーチ結果から選択された課題のサブセットを表示する
  • JIRA サイトの課題数を表示する
  • JIRA のサイト上に新しい課題を作成し、ページ上に表示する

JIRA 課題マクロの追加と更新 - 概要

Confluence ページ上のマクロを使用するためのクイックガイド:

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

On this page:

関連ページ

スクリーンショット: Confluence ページでの JIRA 課題マクロの例

JIRA クエリ言語 (JQL) 検索経由で課題を表示する

また、マクロを使用し、JIRA クエリ言語 (JQL) を使用した検索結果に基づいて、ページ上に Jira 課題の表を表示することもできます。

JQL is a simple query language, similar to SQL, which works in JIRA. A basic JQL query consists of a field, followed by an operator (such as = or >), followed by one or more values or functions.

例:

  • 次のクエリは、 プロジェクト内のすべての課題を検索します。

    project = "TEST"

  • 次のクエリは、'CONF' プロジェクトの 'documentation' コンポーネント内のすべての課題を検索します。

    project = CONF and component = documentation

For more information about JQL syntax, see the JIRA documentation: Advanced Searching.

JQL 検索に基づいて課題のテーブルを表示するには:

  1. Insert the JIRA Issues macro onto your Confluence page, as described above.
  2. 検索ボタンの横にある JIRA サーバーを選択します。
  3. プロンプトが表示されたら、JIRA サーバーにログインします。
  4. JQL クエリを検索ボックスに入力します。
  5. 検索を選択します。
  6. If you want to customise the display, choose Display options and adjust the columns that will appear in your table of issues.
  7. [挿入] を選択します。

Screenshot: The JIRA Issues macro browser with a JQL search, and display options

JIRA URL 経由で課題を表示する

You can paste any of the following JIRA URLs into the JIRA Issues macro. Confluence will immediately convert the URL to a JQL search.

  • Any URL for a JIRA issue search or filter.
  • 1 つの課題の URL。
  • The URL of the XML view of a JIRA search.

Auto-convert: You can paste a JIRA URL directly into the Confluence editor (without calling up the macro browser). Confluence will automatically convert the URL into a JIRA Issues macro.

Displaying a single JIRA issue, or selected JIRA issues

1 つの JIRA 課題を表示するには、次の方法からいずれかを選択します。

  • Confluence ページに直接課題の URL を貼り付けます。(マクロ ブラウザーを使用する必要はありません。)Confluence は JIRA 課題マクロへのリンクを自動変換します。
  • Or: Add the JIRA issues macro to the page as described above, and choose Recently Viewed to see the JIRA issues you have visited recently. Select an issue and choose Insert.
  • Or: Add the JIRA issues macro to the page as described above, and past the issue URL into the search box in the macro browser.
  • Or: Add the JIRA issues macro to the page, define your search criteria in the macro browser via JQL as described above, then select the check box next to the issue in the search results, within the macro browser.

検索結果から JIRA 課題のサブセットを表示します。

  1. ページ JIRA 課題マクロを追加します。
  2. Define your search criteria in the macro browser via JQL, as described above.
  3. マクロ ブラウザーで、検索結果の必要な課題の隣にあるチェックボックスを選択します。

スクリーンショット: 表示する課題のサブセットを選択する

課題数を表示する

You can choose to display the number of issues returned by your search, rather than a table of issues. The JIRA Issues macro will display a count of issues, linked to the search in JIRA.

スクリーンショット: Confluence ページで課題数を表示する JIRA 課題マクロ

課題カウントを表示するには:

  1. ページ JIRA 課題マクロを追加します。
  2. Define your search criteria in the macro browser via JQL, as described above.
  3. 表示オプション を選択し、マクロブラウザで [表示オプション] の横にある 合計発行数 を選択します。
  4. [挿入] を選択します。

Creating a new issue in JIRA

Confluence ページで編集を行いながら、Confluence エディターを開いたまま JIRA で課題を作成し、Confluence ページにその課題を表示させることができます。

To insert an issue into JIRA:

  1. Add the JIRA Issues macro to the page, as described above.
  2. 新しい課題作成 を選択します。
  3. 要求されたら JIRA サーバー、プロジェクト、課題に関する情報を提供します。
  4. [挿入] を選択します。

Confluence will send a request to JIRA, to add the issue to the JIRA site. Confluence will also display the resulting JIRA issue on the Confluence page.

メモ:

  • This feature works best with JIRA issue types whose mandatory field requirements have not been altered. With the exception of a JIRA issue's 'Component/s' or 'Fix Version/s' fields, You cannot use the JIRA Issies macro to add an issue whose issue type has customised mandatory field requirements. (Exception: customisations of the 'Component/s' and 'Fix Version/s' fields are accepted.)
  • If your JIRA project has customised fields, the JIRA Issues macro will not prompt you for information for those fields. In other words, those fields will not appear in the 'Create New Issue' dialog in the JIRA Issues macro browser.

Configuring Application Links to display restricted JIRA issues

Before you can use this macro, your Confluence and JIRA sites must be connected via Application Links.

If the JIRA site allows anonymous viewing of issues, you must configure an application link, but there is no need to configure any incoming or outgoing authentication between JIRA and Confluence. People viewing the Confluence page will see the publicly accessible issues from the JIRA site.

If your JIRA site has restricted viewing, or if some JIRA projects or issues are restricted to viewing by certain people, then people will need to log in before seeing the restricted issues.

In such a case, the outgoing authentication in the Confluence Application Links determines how the JIRA Issues macro handles restricted issues:

  • If the outgoing authentication is set to Trusted Applications, people can see restricted issues in JIRA if their username is the same in JIRA and Confluence, and if they have permission in JIRA to see the issue.
  • If the outgoing authentication is set to OAuth, people may need to choose Login & Approve, to gain access to the JIRA server and restricted issues.
  • If the outgoing authentication is set to Basic Access, people can see the JIRA issues that are visible to the user account configured in JIRA's outgoing authentication setting.

Rendering HTML from JIRA

Conflucnce から JIRA へのアプリケーション リンクを設定すると、JIRA の書式付きフィールドを Confluence に表示することができます。この操作を行わない場合、JIRA 課題マクロの出力内で、これらの書式付きフィールドはエスケープされます。これにより、信頼されない JIRA サーバーによる不正な HTML の可能性を防ぐことができます。これに気付く可能性が最も高いフィールドは、説明フィールドです。

この例では、JIRA での説明列の表示方法を示します。

説明

これは

  • 課題の
  • 説明です

JIRA と Confluence の間のアプリケーション リンクがない場合、JIRA 課題マクロには次のように説明が表示されます。

説明

<p>これは課題の<ul><li>説明</li><li>です</li></ul></p>

JIRA 課題マクロの無効化

The functionality is provided by an add-on (plugin) called 'JIRA Macros'. To make the macro unavailable on your site, you can disable the add-on. See Disabling and enabling apps.

注意

HTTPS: The JIRA Issues macro can access a JIRA site running under SSL provided the Confluence server is configured to accept the JIRA SSL certificate. See Connecting to LDAP or JIRA or Other Services via SSL.

Custom fields can be added as columns to the table simply by using the name of the field with no quotes. Earlier versions of the macro required you to use the custom field id, e.g. customfield_10100.

Code examples for this macro

Note: Wiki markup offers a few additional parameters that are not available via the macro browser.

参照先:

  • ラベルなし

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