JIRA チャート マクロ

JIRA チャート マクロをページに追加する

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

1. In the editor choose Insert > Other macros > JIRA Chart.
2. 作成するレポートのタイプを選択します (円グラフ、作成済み vs 解決済み)

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

   複数の JIRA インスタンスが Confluence にリンクされている場合、ドロップダウンにプライマリ アプリケーション リンクが既定として表示されます。
4. 課題の検索 - クエリを JQL に入力するか、JIRA URL を検索フィールドに直接貼り付けることができます。
5.  Choose Preview to generate the chart.
6. Choose Display Options to further control how your chart appears. 
7. [挿入] をクリックします。

To find out more about searching for issues see Displaying issues via a JIRA Query Language (JQL) search.

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

円グラフ

円グラフは課題ステータス、優先度、担当者などのレポートに使用できます。 

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

• Chart by - select the JIRA field you want to segment the pie chart by such as:
  • ステータス
  • 修正バージョン
  • 担当者名
  • Priority
  • コンポーネント
  • 課題タイプ
• 幅 - チャート領域の全幅を定義します。値をピクセル、パーセントで入力するか、自動で適合させるには空白のままにすることができます。 
• 境界線の表示 - チャート領域の周囲に境界線を追加します。
• グラフ情報を表示 - チャートの下に合計課題件数とグラフの種類の値と共にテキスト サマリを表示します。 

作成済み vs 解決済みグラフ

「作成済み vs 解決済み課題」レポートは、長期間にあたる作成済み課題の数と解決済み課題の数の差を示すために使用できます。

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

• Period - choose a time frame to report by (week, month, quarter etc).
• Days previously - the total number of days to report on (counting back from today).
• Cumulative totals - choose to progressively add totals or report individual values for each period.
• Show unresolved trend - add a subplot showing unresolved issues over time.
• Show versions - indicate version release dates as a vertical line on the chart.
• 幅  - チャート領域の全幅を定義します。値をピクセル、パーセントで入力するか、自動で適合させるには空白のままにします。 
• 境界線の表示 - チャート領域の周囲に境界線を追加します。
• グラフ情報を表示 - チャートの下に合計課題件数とグラフの種類の値と共にテキスト サマリを表示します。 

2 次元グラフ

二次元グラフは課題統計をマトリックスで示すために使用されます。これらのフィールドを表示するよう X 軸または Y 軸を設定できます。

• ステータス
• Priority
• 担当者
• 修正バージョン
• コンポーネント
• 課題タイプ。

たとえば、課題をステータス別にしたグラフを使用することができます (上記のように)。 

グラフの軸を設定するには、「表示オプション:」を選択します。

• X 軸 - X 軸 (列) に表示する課題フィールド。
• Y 軸 - Y 軸 (行) に表示する課題フィールド。 
• 表示行数 - グラフに表示する最大数。 

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.

注意

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

コー​​ドの例

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

マクロ名: jirachart

マクロ本文: なし。

The following parameters are available in storage format. Note that some parameters are only available for specific chart types.

pie

periodName

createdvsresolved

daysprevious

createdvsresolved

isCumulative

createdvsresolved

showUnresolvedTrend

createdvsresolved

versionLabel

createdvsresolved

Storage format example - Pie Chart

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-e5028e8166fa</ac:parameter>
  <ac:parameter ac:name="border">true</ac:parameter>
</ac:structured-macro>

Storage format example - Created vs Resolved

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

<p><ac:structured-macro ac:name="jirachart">
  <ac:parameter ac:name="isAuthenticated">true</ac:parameter>
  <ac:parameter ac:name="versionLabel">all</ac:parameter>
  <ac:parameter ac:name="jql">project%20%3D%20confluence%20and%20component%20%3D%20documentation</ac:parameter>
  <ac:parameter ac:name="showUnresolvedTrend">true</ac:parameter>
  <ac:parameter ac:name="width">450</ac:parameter>
  <ac:parameter ac:name="daysprevious">30</ac:parameter>
  <ac:parameter ac:name="isCumulative">true</ac:parameter>
  <ac:parameter ac:name="chartType">createdvsresolved</ac:parameter>
  <ac:parameter ac:name="showinfor">false</ac:parameter>
  <ac:parameter ac:name="server">JAC</ac:parameter>
  <ac:parameter ac:name="serverId">144880e9-a353-312f-9412-e5028e8166fa</ac:parameter>
  <ac:parameter ac:name="border">true</ac:parameter>
  <ac:parameter ac:name="periodName">daily</ac:parameter>
</ac:structured-macro></p>

Storage format example - Two Dimensional Chart

Example chart - 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">twodimensional</ac:parameter>
  <ac:parameter ac:name="ystattype">issuetype</ac:parameter>
  <ac:parameter ac:name="sortBy" />
  <ac:parameter ac:name="isAuthenticated">true</ac:parameter>
  <ac:parameter ac:name="jql">project%20%3D%20CONF%20and%20Component%20%3D%20Documentation</ac:parameter>
  <ac:parameter ac:name="width" /><ac:parameter ac:name="server">JAC</ac:parameter>
  <ac:parameter ac:name="numberToShow">10</ac:parameter>
  <ac:parameter ac:name="sortDirection" />
  <ac:parameter ac:name="serverId">144880e9-a353-312f-9412-ed528e8166fa</ac:parameter>
  <ac:parameter ac:name="xstattype">statuses</ac:parameter>
</ac:structured-macro>