JIRA チャート マクロ

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.

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

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

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 では、どのような課題でも検索するには認証が必要です。

コー​​ドの例

次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。 

マクロ名: jirachart

マクロ本文: なし。

次のパラメーターは保存形式で使用可能です。

保存形式の例

Example chart by Issue Type - note that Confluence will insert the server and serverId parameters, based on settings in Application Links:

<ac:structured-macro ac:name="jirachart">
  <ac:parameter ac:name="chartType">pie</ac:parameter>
  <ac:parameter ac:name="statType">issuetype</ac:parameter>
  <ac:parameter ac:name="showinfor">true</ac:parameter>
  <ac:parameter ac:name="jql">project%20%3D%20CONF%20and%20fixVersion%20in%20('5.3')</ac:parameter>
  <ac:parameter ac:name="width">600</ac:parameter>
  <ac:parameter ac:name="server">JAC</ac:parameter>
  <ac:parameter ac:name="serverId">144880e9-a353-312f-9412-ed028e8166fa</ac:parameter>
  <ac:parameter ac:name="border">true</ac:parameter>
</ac:structured-macro>