Jira の作業項目をリストで表示する

If your Confluence instance is connected to Jira, you can search and display Jira work items in a list on Confluence pages. You can then customize the display to add, remove, and reorder fields.

キーワード、フィルター、または JQL (Jira クエリ言語) で検索内容を変更します。

Insert Jira work items

Edit a Confluence page or create a new one. You have 3 options to insert Jira work items:

オプション 1

Select  from the toolbar and select Jira work items

オプション 2 

While editing a page, type /jira and select Jira work items.

オプション 3

You have the option to search for work items in Jira and paste the search filter URL into a Confluence page.

Search for work items 

Start inserting Jira work items by using filters with basic keyword search or with JQL.

1. BASIC is selected by default. With this option, you can use filters and keywords to search for work items.

2. If you select JQL, enter your query or search keywords. For example, project = 'Starfish'

3. Select COUNT VIEW if you want to display just the number of workitems.

4. Select Insert work items.

フィールド列を管理する

Once your Jira work items are displayed as a list, you can drag columns to move them around. Choose the columns you want to appear by selecting the column icon .

Edit your work items

検索クエリを変更する必要がある場合は、リストの下部にある鉛筆アイコン を選択します。

リストの幅を変更するには、横にある展開アイコン を選択します。

Marketplace アプリのユーザーを対象とした従来の Jira マクロの使用

Jira のマクロを使用すると、以下のことができます。

• Display a list of work items on your page, based on a Jira Query Language (JQL) search, filter or URL.

• Display a single work item.

• Display a count of work items.

• Create new work items and display the work items on your page without leaving Confluence.

従来の Jira マクロを使用する

従来の Jira マクロを追加するには、次の手順を実行します。

従来の Jira マクロを編集するには、次の手順を実行します。

Displaying work items via a Jira Query Language (JQL) search

You can use the macro to display a list of work items on your page, based on the results of a search using Jira Query Language (JQL).

JQL は、SQL に似たシンプルなクエリ言語です。基本的な JQL のクエリは、フィールド、演算子 (= や > など)、1 つ以上の 値 または関数 で構成されています。

例：

• The following query will find all work items in the 'TEST' project:

  project = "TEST"

• The following query will find all work items in the 'documentation' component of the  'CONF' project:

  project = CONF and component = documentation

For more information about JQL syntax, see Advanced searching in the Jira documentation.

To display a list of work items based on a JQL search:

1. 上記のように、Confluence ページに Jira マクロを挿入します。

2. [検索] ボタンの横で、Jira インスタンスを選択します。

3. プロンプトが表示されたら、Jira インスタンスにログインします。

4. JQL クエリを検索ボックスに入力します。

5. [検索] を選択します。

6. If you want to customize the display, select Display options and adjust the columns and number of work items that will appear in your list of work items.

7. [挿入] を選択します。

Displaying work items via a Jira URL

You can paste any of the following Jira application URLs into the Jira work items macro. Confluence will immediately convert the URL to a JQL search.

• Any URL for a work item search or filter.

• A URL for a single work item.

• 検索の XML ビューの URL。

Displaying a single work item, or selected work items

To display a single Jira work item, choose one of the following methods:

• Paste the URL of the work item directly onto the Confluence page. (There is no need to use the macro browser.) Confluence will auto-convert the link to a Jira work items macro.

• Or: Add the Jira work items macro to the page as described above, and choose Recently Viewed to see the work items you have visited recently. Select a work item and choose Insert.

• Or: Add the Jira work items macro to the page as described above, and paste the work item URL into the search box in the macro browser.

• Or: Add the Jira work items 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 work item in the search results, within the macro browser.

You can choose to show just the work item key, or the work item key and a summary. Select the macro placeholder and choose Show Summary or Hide Summary. 

To display a subset of Jira work items from your search results:

1. Add the Jira work items macro to the page.

2. 上記のように JQL 経由でマクロ ブラウザの検索条件を定義します。

3. Select the check boxes next to the required work items in the search results, within the macro browser.

Displaying a count of work items

You can choose to display the number of work items returned by your search, rather than a list of work items. The Jira work items macro will display a count of work items, linked to the search in your Jira application.

To display a work item count:

1. Add the Jira work items macro to the page.

2. 上記のように JQL 経由でマクロ ブラウザの検索条件を定義します。

3. Select Display options, then select Total work item count next to 'Display options' in the macro browser.

4. [挿入] を選択します。

Creating a new work item 

While editing a Confluence page, you can create a work item in Jira and display it on your Confluence page, without leaving the Confluence editor.

To create a work item and add it to your page:

1. Add the Jira work items macro to the page, as described above.

2. Select Create new work item.

3. Supply the information about your Jira instance, project, and work item, as prompted.

4. [挿入] を選択します。

Confluence will send a request to your Jira application, to create the work item, then display the newly created work item on your page.

制限事項

The Jira legacy macro will notify you if it is unable to create a work item in the selected project. This may be because the project has a required field, field configuration or other customization that is not supported by the Jira legacy macro. In this situation you will need to create the work item directly in your Jira application.

JIRA アプリケーションからの HTML レンダリング

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

従来の Jira マクロの無効化