JIRA is Atlassian's issue tracking and project management system. By adding the JIRA Chart macro to a Confluence page, you can display information about JIRA issues and projects as pie charts.

このマクロを使用するには、Confluence および JIRA のサイトがアプリケーション リンクを介して接続されている必要があります。ページを表示しているユーザーは、JIRA サイトから公開されている課題のチャートを見ることができます。JIRA サイトに表示制限が設定されている場合 (したがって、ユーザーは課題を表示する権限が必要)、チャートを表示する前に認証が必要です。このマクロは、JIRA 5.x 以降と互換性があります。

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:

関連ページ

JIRA チャート マクロを使用する

JIRA チャートをご使用のページに追加するには：

  1. JIRA チャート マクロを挿入します (上記参照)。

  2. ご使用の JIRA サーバーを選択します。

      複数の JIRA インスタンスが Confluence にリンクされている場合、ドロップダウンにプライマリ アプリケーション リンクが既定として表示されます。

  3. 課題の検索 - クエリを JQL に入力するか、JIRA URL を検索フィールドに直接貼り付けることができます。
  4. プレビューを選択してチャートを表示します。
  5. [挿入] をクリックします。

課題の検索に関する詳細は、JIRA のクエリ言語 (JQL) 検索を利用した課題の表示を参照してください。

ページ上でのチャートの表示方法をさらに制御することも可能です。次の表示オプションから選択します。

  • グラフの種類 - 円グラフを分割する JIRA フィールドを選択します。
  • 幅 - チャート領域の全幅を定義します。ピクセルまたはパーセントで値を入力できます。 自動で適合させるには空白のままにします。 
  • 境界線の表示 - チャート領域の周囲に境界線を追加します。
  • グラフ情報を表示 - チャートの下に合計課題件数とグラフの種類の値と共にテキスト サマリを表示します。 

スクリーンショット：マクロ ブラウザー内の JIRA チャート マクロ

JIRA チャート マクロの無効化

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

注意

HTTPS：Confluence サーバーが JIRA SSL 証明書を受け入れるように設定されている場合には、JIRA チャート マクロは SSL で実行中の JIRA サイトにアクセスできます。SSL 経由で LDAP や JIRA などのサービスに接続するを参照してください。

認証：認証が必要な課題 (JIRA で匿名ユーザーに表示されない課題) を含むクエリの場合、Confluence ページ上のチャートを表示するために認証を求めるプロンプトが出されます。    

マクロ ブラウザーで課題を検索するには認証が必要な場合があります。 JIRA 5.x では、匿名ユーザーとして、アクセス制限のない課題を検索することができますが、JIRA 6.x では、どのような課題でも検索するには認証が必要です。

Code examples for this macro

参照先:

  • ラベルなし

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