チャート マクロ
チャート マクロを使用すれば、表形式データに基づいたグラフを表示できます。ページにマクロを追加する場合、次のようにします。
- マクロでグラフ化するデータを、マクロのプレースホルダーに表形式で入力します。
- マクロ ブラウザーでマクロのパラメーターを編集し、グラフの書式を設定します。
マクロのコンテンツ
描画されたグラフ
チャート マクロを使用する
チャート マクロを追加するには、次の手順に従います。
- Confluence エディタで、
> [詳細を表示] の順に選択します - 挿入するアイテムを探して選択します
- [挿入] を選択します。
このページに「/」と入力してツールバーからを選択し、同じリストを表示することも可能です。
チャート データを入力するには、次の手順に従います。
- タイプ パラメーター (下記参照) を使用して、チャートの種類を選択します。
- 以下に説明するように、マクロ ブラウザで他のパラメータ設定を選択します。
データ系列またはデータ タイプの値がないことを表すには、ゼロを使用します。セルを空欄/空値のままにすると、グラフの表示時に問題が発生します。
チャート マクロを編集するには、次の手順に従います。
- マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
- [編集] を選択します。右側のパネルが開きます。
- パラメーターを修正します。変更内容は、移動するごとに保存されます。
- ページの編集を再開すると、パネルが閉じます。
パラメーター
グラフ タイプのパラメーター
これらのパラメーターは、表示するグラフの種類やグラフの表示方法を決定します。
| パラメーター | 既定 | 説明 |
|---|---|---|
| タイプ | pie | 表示するチャートのタイプ。XY チャートには、数値の x 軸と y 軸があります。x の値は、必要に応じて時間ベースにできます(時系列パラメーターを参照してください)。 標準 - pie、bar、line、area XY プロット — xyArea、xyBar、xyLine、xyStep、xyStepArea、scatter、timeSeries その他 - gantt |
| 表示の向き | vertical | area、bar、および line チャートに適用されます。
|
| 3D で表示 | false | area、bar、および line チャートに適用されます。 |
| 積み重ね値 | false | area、bar チャートに適用されます。 |
| シェイプを表示 | true | line チャートに適用されます。各データの位置に図形が表示されます。 |
| 不透明度 |
| 0 パーセント (透明) から 100 パーセント (不透明) までの値で、前景領域と棒部分の不透明度を決定します。 |
表示を制御するパラメーター
| パラメーター | 既定 | 説明 |
|---|---|---|
| 幅 | 300 | ピクセル単位で示されるチャートの幅。 |
| 高さ | 300 | ピクセル単位で示されるチャートの高さ。 |
| 描画データの表示 | false | マクロの本文 (通常はデータの表) を表示するかどうかを設定します。既定では、チャートのデータ表は表示されません。
|
| 画像の形式 | png | チャートに使用される画像のフォーマット。
|
タイトルとラベルのパラメーター
| パラメーター | 既定 | 説明 |
|---|---|---|
| チャートのタイトル | なし | チャートのタイトル。 |
| グラフのサブタイトル | なし | グラフのサブタイトル。タイトル用のフォントより小さいフォントが使用されます。 |
| 横軸のラベル | なし | x 軸 (項目) のラベル。 |
| 縦軸のラベル | なし | y 軸 (値) のラベル。 |
| 凡例を表示しますか? | true | 凡例またはキーを表示します。 |
データの仕様のパラメーター
チャートのデータは、マクロ本文をレンダリングする際に見つかった表から取得されます。これらのオプションは、このデータの解釈方法を制御します。既定では、数値と日付の値は、Confluence のグローバル既定言語 (ロケール) のフォーマットに従って解釈されます。変換に失敗した場合は、Confluence に定義されている他の言語で試行されます。追加の変換オプションを、次のパラメータを使用して指定できます。
| パラメーター | 既定 | 説明 |
|---|---|---|
| 表 | すべての第 1 レベルの表 | 表 ID または表番号 (1 で開始) をコンマ区切りの一覧にしたもので、チャートのデータとして使用されるマクロ本文に含まれます。データ表が他のテーブルに埋め込まれている場合、表を選択する必要があります。このような事例は、より複雑な書式設定が行われる (例: セクション マクロや列マクロを使用) 場合に生じます。 |
| 列 | すべての列 | チャート データに使用される表の列ラベルや列タイトル、列番号を、コンマ区切りの一覧にしたものです。これは処理されるすべての表に適用されます。列には 1 から始まる番号が付いています。列ラベルは、ヘッダー行の列のテキストです。列タイトルは、ヘッダー行の列の (html の) title 属性です。 |
| コンテンツの向き | horizontal |
|
| 時系列? | false |
|
| 日付の形式 | Confluence 言語で定義された日付形式 | 時系列データの場合、日付の形式を使用すれば、データを日付値に変換する追加のカスタマイズが可能です。[日付の形式] が指定されている場合、これが日付値の解釈をするための最初の形式として使用されます。時系列データに一致する形式を指定します。「simple date format」を参照してください 。 |
| 期間 | Day | 時系列データ用の期間。データの解釈粒度を定義します。有効な値は以下のとおりです。 Millisecond、Second、Minute、Hour、, Day、Week、Month、Quarter、Year。 |
| 言語 | なし | ロケールを形成する国パラメーターと組み合わせて使用します。これらの追加の数字と日付形式は、既定の言語に先だってデータ変換に使用されます。 有効な値は 2 文字の ISO 639-1 alpha-2 言語コード です。 |
| 国 | なし | ロケールを形成する言語パラメーターと組み合わせて使用します。有効な値は2 文字の ISO 3166 コードです。 |
| 許可 | true |
|
色のパラメーター
色は、16 進数表記または HTML カラー ネームを使用して指定します。
| パラメーター | 既定 | 説明 |
|---|---|---|
| 背景色 | 白 | チャートの背景。 |
| 枠線の色 | 枠線なし | チャートの周囲の枠線。 |
| 色 | カテゴリ、セクション、系列の色をカスタマイズするために使用する色をコンマ区切りの一覧にしたもの。 |
軸のパラメーター
チャートのタイプに応じて、縦軸と横軸をカスタマイズできます。軸の値はデータに基づいて自動的に生成されますが、これらのパラメーターを 1 つ以上指定することで上書きできます。
| パラメーター | 既定 | 説明 |
|---|---|---|
| 縦軸の最小値 | なし | 縦軸の下限。 |
| 縦軸の最大値 | なし | 縦軸の上限。 |
| 縦軸の目盛り単位 | なし | 縦軸の 1 目盛りの単位。 |
| 縦軸ラベルの角度 | なし | 縦軸ラベルの表示角度。 |
| 横軸の下限値 | なし | XY プロットにのみ適用されます。横軸の下限。日付軸の場合、この値は、日付の形式パラメーターで指定された日付形式である必要があります。 |
| 横軸の上限 | なし | XY プロットにのみ適用されます。横軸の上限。日付軸の場合、この値は、日付の形式パラメーターで指定された日付形式である必要があります。 |
| 横軸の目盛り単位 | なし | XY プロットにのみ適用されます。横軸の 1 目盛りの単位。日付軸の場合、この値は、期間パラメーターで指定された単位の数になります。期間単位は、以降に文字を指定することで上書きできます: y (年)、m (月)、d (日)、h (時間)、m (分)、s (秒)、u (ミリ秒)。 |
| 横軸ラベルの角度 | なし | XY プロットにのみ適用されます。横軸ラベルの表示角度。 |
| カテゴリ ラベルの位置 | なし | カテゴリの軸ラベルのテキストの位置。
|
| 日付の目盛りの位置 | start | 日付の目盛りの位置。
|
Pie チャートのパラメーター
| パラメーター | 既定 | 説明 |
|---|---|---|
| 円グラフ セクション ラベル | 円グラフのセクションのキー値のみを表示 | 円グラフのラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。
例 1: "% 0 % = % 1 %" は "Independent = 20" のように表示されます。 |
| 円グラフ セクション分離表示 | 切り離しなし | 切り離して表示する円グラフのキーをコンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。 |
添付ファイルのパラメーター
これらの高度なオプションをチャートのバージョン管理に使用し、自動化やパフォーマンスの向上を実現できます。このオプションは慎重に使用してください。通常、チャートの画像はページが表示されるたびに再度生成されます。これらのオプションを使用すれば、生成された画像を添付ファイルとして保存し、次からはこの添付ファイルを再利用できます。このオプションは Cache Plugin と組み合わせた場合、パフォーマンスの向上に特に有効です。選択したオプションに応じて、チャートの画像をバージョン管理し、履歴を残すことができます。
| パラメーター | 既定 | 説明 |
|---|---|---|
| 添付ファイル | なし | チャートを添付ファイルとして保存するときの名前と場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられている必要があります。
|
| 添付ファイルのバージョン | new | 保存されたチャートのバージョン管理方法を定義します。
|
| 添付ファイルのコメント | なし | 保存されたチャート添付ファイルに使用されるコメント。 |
| サムネイル? | false |
|
例
Pie チャート
マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | pie |
|
| ||||||||
| チャートのタイトル | Fish Sold 2011 | ||||||||||
| 凡例を表示しますか? | true | ||||||||||
| コンテンツの向き | vertical | ||||||||||
Bar チャート
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | bar |
|
| ||||||||||||
| チャートのタイトル | Fish Sold | ||||||||||||||
| 凡例を表示しますか? | true | ||||||||||||||
3D Bar チャート
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | bar |
|  | ||||||||||||
| 3D で表示 | true | ||||||||||||||
| 不透明度 | 50 | ||||||||||||||
| 凡例を表示しますか? | true | ||||||||||||||
Time Series チャート
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | 時系列? |
|
|  | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| 日付の形式 | MM/yyyy | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 期間 | Month | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| コンテンツの向き | vertical | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 縦軸の下限 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 凡例を表示しますか? | true | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
XY Line チャート
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | xyLine |
|  | ||||||||||||
| 凡例を表示しますか? | true | ||||||||||||||
XY Area チャート
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | xyArea |
|  | ||||||||||||
| 凡例を表示しますか? | true | ||||||||||||||
Area チャート
例 1
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | area |
|
| ||||||||||||||||||||
| 凡例を表示しますか? | true | ||||||||||||||||||||||
| 幅 | 300 | ||||||||||||||||||||||
| 高さ | 300 | ||||||||||||||||||||||
| 不透明度 | 50 | ||||||||||||||||||||||
例 2
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | area |
|
| ||||||||||||||||||||
| 凡例を表示しますか? | true | ||||||||||||||||||||||
| 幅 | 300 | ||||||||||||||||||||||
| 高さ | 300 | ||||||||||||||||||||||
| 積み重ね値 | true | ||||||||||||||||||||||
Gantt チャート
| マクロ ブラウザのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されるチャート | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| タイプ | gantt |
|
| ||||||||||||||||||||||||||||||||
| 幅 | 300 | ||||||||||||||||||||||||||||||||||
| 高さ | 200 | ||||||||||||||||||||||||||||||||||
| 列 | ,,1,2,3,4 | ||||||||||||||||||||||||||||||||||
| 日付の形式 | MM/dd/yyyy | ||||||||||||||||||||||||||||||||||
コードの例
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。
マクロ名: chart
マクロ本文: リッチテキストに対応し、チャートのデータを含む表で構成されます。
このマクロでは、この一覧にある多数のパラメーターが認識されます。
チャート タイプのパラメーター
これらのパラメーターは、表示するチャートのタイプやチャートの外観を決定します。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
type | いいえ | pie | 表示するチャートの種類。XY グラフは x 軸と y 軸の数値軸を持ちます。x の値は必要に応じて時間ベースにできます。 利用可能な値:
|
orientation | いいえ | vertical | 表示の向き。area、bar、および line チャートに適用されます。 利用可能な値:
|
3D | いいえ | false | 3 次元で表示します。area、bar、および line チャートに適用されます。 |
stacked | いいえ | false | 積み重ね値。area、bar チャートに適用されます。 |
showShapes | いいえ | true | line チャートに適用されます。各データの位置に図形が表示されます。 |
opacity | いいえ |
| 0 パーセント (透明) から 100 パーセント (不透明) までの値で、前景領域と棒部分の不透明度を決定します。 |
チャートの表示パラメーター
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
width | いいえ | 300 | ピクセル単位で示されるチャートの幅。 |
height | いいえ | 300 | ピクセル単位で示されるチャートの高さ。 |
dataDisplay | いいえ | false | データ表で構成される、マクロ本文を表示するかどうかを決定します。既定では、チャートのデータ表は表示されません。 利用可能な値:
|
imageFormat | いいえ | png | チャートに使用される画像のフォーマット。 利用可能な値:
|
チャートのタイトルとラベルのパラメーター
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
title | いいえ | (なし) | チャートのタイトル。 |
subTitle | いいえ | (なし) | グラフのサブタイトル。 |
xLabel | いいえ | (なし) | x 軸 (項目) のラベル。 |
yLabel | いいえ | (なし) | y 軸 (値) のラベル。 |
legend | いいえ | false | チャートの凡例 (キー) を表示するかどうかを決定します。 |
チャートのデータのパラメーター
チャートのデータは、マクロ本文で見つかった表から取得されます。これらのパラメーターは、このデータの解釈方法を制御します。既定では、数値と日付の値は、Confluence のグローバル既定言語 (ロケール) のフォーマットに従って解釈されます。変換が失敗した場合は、Confluence で定義されている他の言語で試行されます。以下のパラメータを使用すると、追加の変換オプションを指定できます。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
tables | いいえ | すべての第 1 レベルの表 | マクロ本文に含まれ、チャートのデータとして使用される、表 ID または表番号 (1 で開始) をコンマ区切りの一覧にしたものを提供できます。データ表が他のテーブルに埋め込まれている場合、表を選択する必要があります。このような事例は、より複雑な書式設定が行われる (例: セクション マクロや列マクロを使用) 場合に生じます。 |
columns | いいえ | すべての列 | チャート データに使用される表の列ラベルや列タイトル、列番号をコンマ区切りにした一覧指定できます。これは処理されるすべての表に適用されます。列には 1 から始まる番号が付いています。列ラベルは、ヘッダー行の列のテキストです。列タイトルは、ヘッダー行の列の (html の) title 属性です。 |
dataOrientation | いいえ | horizontal | コンテンツの向きです。既定では、データ表の (水平方向の) 列が定義域および x の値を表していると解釈されます。 利用可能な値:
|
timeSeries | いいえ | false | " |
dateFormat | いいえ | Confluence 言語で定義された日付形式 | 時系列データの場合、日付形式を使用すると、データを日付値に変換する追加のカスタマイズが可能です。dateFormat が指定されている場合、それが日付値の解釈に最初に使用されます。時系列データに一致する形式を指定します。「simple date format」を参照してください。 |
timePeriod | いいえ | day | 時系列データに使用される期間。データの解釈粒度を定義します。 利用可能な値: |
language | いいえ | (なし) | ロケールを形成するために、 利用可能な値は 2 文字の ISO 639-1 alpha-2 言語コードです。 |
country | いいえ | (なし) | ロケールを形成するために、language パラメータと組み合わせて使用します。有効な値は 2 文字の ISO 3166 コードです。 |
forgive | いいえ | true | マクロがデータ形式エラーを容認 (許可) するかどうかを決定します。 利用可能な値:
|
チャートの色のパラメーター
色は、16 進数表記または HTML カラー ネームを使用して指定します。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
bgColor | いいえ | 白 | チャートの背景色。 |
borderColor | いいえ | 枠線なし | チャートの周りの枠線の色。 |
colors | いいえ | カテゴリ、セクション、系列の色をカスタマイズするために使用する色をコンマ区切りの一覧にしたもの。 |
チャートの軸のパラメーター
チャートのタイプに応じて、縦軸と横軸をカスタマイズできます。軸の値はデータに基づいて自動的に生成されますが、これらのパラメーターを 1 つ以上指定することで上書きできます。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
rangeAxisLowerBound | いいえ | (なし) | 縦軸の最小値。 |
rangeAxisUpperBound | いいえ | (なし) | 縦軸の最大値。 |
rangeAxisTickUnit | いいえ | (なし) | 縦軸の 1 目盛りの単位。 |
rangeAxisLabelAngle | いいえ | (なし) | 縦軸ラベルの表示角度。 |
domainAxisLowerBound | いいえ | (なし) | XY プロットにのみ適用されます。横軸の下限。日付軸の場合、この値は、dateFormat パラメータで指定された日付形式である必要があります。 |
domainAxisUpperBound | いいえ | (なし) | XY プロットにのみ適用されます。横軸の上限。日付軸の場合、この値は、dateFormat パラメータで指定された日付形式である必要があります。 |
domainAxisTickUnit | いいえ | (なし) | XY プロットにのみ適用されます。横軸の 1 目盛りの単位。日付軸の場合、この値は、timePeriodパラメーターで指定された単位の数になります。timePeriod 単位は、終了文字を指定することで上書きできます：y (年)、M (月)、d (日)、h (時間)、m (分)、s (秒)、u (ミリ秒)。 |
domainAxisLabelAngle | いいえ | (なし) | XY プロットにのみ適用されます。横軸ラベルの表示角度。 |
categoryLabelPosition | いいえ | (なし) | カテゴリの軸ラベルのテキストの位置。 利用可能な値:
|
dateTickMarkPosition | いいえ | start | 日付の目盛りの位置。 利用可能な値:
|
Pie チャートのパラメーター
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
pieSectionLabel | いいえ | 円グラフのセクションのキー値のみを表示 | 円グラフのセクション ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。
例 1: "Independent = 20" のように表示するには、次のようにします。
|
pieSectionExplode | いいえ | 切り離しなし | 切り離して表示する円グラフのキーをコンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。 |
チャートの添付ファイルのパラメーター
これらの高度なオプションをチャートのバージョン管理に使用し、自動化やパフォーマンスの向上を実現できます。このオプションは慎重に使用してください。通常、チャートの画像はページが表示されるたびに再度生成されます。これらのオプションを使用すれば、生成された画像を添付ファイルとして保存し、次からはこの添付ファイルを再利用できます。このオプションは Cache プラグインと組み合わせた場合、パフォーマンスの向上に特に有効です。選択したオプションに応じて、チャートの画像をバージョン管理し、履歴を残すことができます。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
attachment | いいえ | (なし) | チャートを添付ファイルとして保存するときの名前と場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられている必要があります。 このパラメータで利用可能な構文は次のとおりです。
|
attachmentVersion | いいえ | new | 保存されたチャートのバージョン管理方法を定義します。 利用可能な値:
|
attachmentComment | いいえ | (なし) | 保存されたチャート添付ファイルに使用されるコメント。 |
thumbnail | いいえ | false | |
Wiki マークアップの例
Wiki マークアップは従来のエディタでのみサポートされます。
pie チャートの簡単な例を示します。
{chart:type=pie|title=Fish Sold}
|| Fish Type || 2004 || 2005 ||
|| Herring | 9,500 | 8,300 |
|| Salmon | 2,900 | 4,200 |
|| Tuna | 1,500 | 1,500 |
{chart}