チャート マクロ
チャート マクロを使用する
ページにチャート マクロを追加するには:
- ページを編集し、オートコンプリートを使用して、チャート マクロを追加します。(「{chart}」と入力。)
- 1 つ以上の表にまとめたグラフのデータを、マクロ プレースホルダーの本文に入力します。(上のスクリーンショットを参照してください。)
- マクロ プレースホルダーをクリックして、編集を選択します 。
- 種類パラメーター(下記参照)を使用して、グラフの種類を選択します。
- 以下に説明するように、マクロブラウザーで他のパラメータ設定を選択します。
- 「プレビュー」領域で、リフレッシュをクリックして、グラフが期待どおりに表示されていることを確認します。
- 保存をクリックして、ページにグラフを追加します。
- ページを保存する準備ができたら、もう一度保存をクリックします。
パラメータ
グラフの種類パラメーター
これらのパラメーターは、表示するグラフの種類やグラフの表示方法を決定します。
パラメータ | 既定 | 説明 |
---|---|---|
Type | 円グラフ | 表示するグラフの種類。XY グラフには、数値軸の x 軸と y 軸があります。x の値は、必要に応じて時間ベースにできます(時系列パラメーターを参照してください)。 標準 - 円グラフ、棒グラフ、線グラフ、面グラフ XY プロット - xy 面グラフ、xy 棒グラフ、xy 折れ線グラフ、xy ステップ チャート、xy ステップ エリア チャート、散布図、時系列グラフ その他 - ガントチャート |
表示方向 | 垂直 | 面グラフ、棒グラフ、折れ線グラフに適用されます。
|
3D表示 | false | 面グラフ、棒グラフ、折れ線グラフに適用されます。 |
値の積み上げ | false | 面グラフ、棒グラフに適用されます。 |
図形表示 | true | 折れ線グラフに適用されます。各データの位置に図形が表示されます。 |
不透明度 |
|
0 パーセント(透明)から 100 パーセント(不透明)までの値で、前景領域と棒部分の不透明度を決定します。 |
表示制御パラメーター
パラメータ | 既定 | 説明 |
---|---|---|
幅 | 300 | ピクセル単位で示されるグラフの幅。 |
高さ | 300 | ピクセル単位で示されるグラフの高さ。 |
元データ表示 | false | マクロの本文(通常データ表)を表示するかどうかを設定します。既定では、グラフのデータ表は表示されません。
|
画像フォーマット | png | グラフに使用される画像のフォーマット。
|
タイトルとラベル パラメーター
パラメータ | 既定 | 説明 |
---|---|---|
グラフのタイトル | なし | グラフのタイトル。 |
グラフのサブタイトル | なし | グラフのサブタイトル、タイトル用のフォントより小さいフォントを使用します。 |
横軸ラベル | なし | x 軸(項目)のラベル。 |
縦軸ラベル | なし | y 軸(値)のラベル。 |
凡例表示 | true | 凡例を表示します。 |
データ仕様パラメーター
グラフに使用するデータは、マクロ本文をグラフ化する際に探し出された表から取得されます。このデータをどう解釈するか制御するのが、このオプションです。数値、日付の値は、既定では Confluence のグローバル既定言語(ロケール)フォーマットに従って解釈されます。変換が失敗した場合は、Confluence で定義されている他の言語で試行されます。追加の変換オプションは、以下のパラメータを使用して指定できます。
パラメータ | 既定 | 説明 |
---|---|---|
テーブル | すべての第1レベルの表 | 表 ID または表番号( 1 で始まる)をコンマ区切りの一覧にしたもので、グラフのデータとして使用されるマクロの本文内に含まれています。データ表が他のテーブルに埋め込まれている場合、表を選択する必要があります。このような例は、より複雑な書式設定が行われる(例えば、セクションマクロや列マクロを使用する)場合に生じます。 |
列 | すべての列 | グラフデータの元になる表に付与された列ラベルや列タイトル、列番号を、コンマ区切りの一覧にしたものです。これはすべての表の処理に適用されます。列には 1 から始まる番号が付いています。列ラベルは、ヘッダー行の列に表示されるテキストです。列タイトルは、ヘッダー行の列に表示される( html の)title 属性です。 |
コンテンツの向き | 水平 |
|
時系列 | false |
|
日付形式 | Confluence 言語で定義された日付形式 | 時系列データの場合、日付形式を使用すれば、データを日付値に変換するといった追加のカスタマイズが可能です。日付形式が指定されている場合、日付値の解釈をするために最初に使用されるのがこの日付形式です。時系列データに一致する形式を指定します。クラス simple date format を参照してください 。 |
時間 | 日 | 時系列データに使用される時間。データが解釈される精度を定義します。有効な値は以下のとおりです。 ミリ秒、秒、分、時間、日、週、月、四半期、年。 |
言語 | なし | ロケールを形成するために、国 パラメーターと組み合わせて使用します。これらの追加の数字と日付形式は、既定の言語に先だってデータ変換に使用されます。 有効な値は 2 文字の ISO 639-1 alpha-2 言語コード です。 |
国 | なし | ロケールを形成するために、言語 パラメーターと組み合わせて使用します。有効な値は2 文字の ISO 3166 コードです。 |
許可 | true |
|
カラー パラメーター
色は、16 進数表記または HTML カラーネームを使用して指定します。
パラメータ | 既定 | 説明 |
---|---|---|
背景色 | 白 | グラフの背景。 |
bordercolor | 枠線なし | グラフの周囲の枠線。 |
色 | カテゴリ、セクション、系列の色をカスタマイズするために使用する色をコンマ区切りの一覧にしたもの。 |
軸パラメータ
グラフの種類に応じて、縦軸、横軸をカスタマイズできます。軸の値はデータに基づいて自動的に生成されますが、これらのパラメータを 1 つ以上指定することにより上書きできます。
パラメータ | 既定 | 説明 |
---|---|---|
縦軸最小値 | なし | 縦軸の下限。 |
縦軸最大値 | なし | 縦軸の上限。 |
縦軸目盛単位 | なし | 縦軸の 1 目盛りの単位。 |
縦軸ラベル角度 | なし | 縦軸ラベルの表示角度。 |
横軸下限 | なし | XY プロットグラフにのみ適用されます。横軸の下限。日付軸の場合、この値は、日付形式パラメーターで指定された日付形式でなければなりません |
横軸上限 | なし | XY プロットグラフにのみ適用されます。横軸の上限。日付軸の場合、この値は、日付形式パラメーターで指定された日付形式でなければなりません |
横軸目盛単位 | なし | XY プロットグラフにのみ適用されます。横軸の 1 目盛りの単位。日付軸の場合、この値は、時間パラメーターで指定された単位の数になります。時間単位は、終了文字を指定することにより上書きできます: y(年)、m(か月)、d(日)、h(時間)、m(分)、s(秒)、u(ミリ秒)。 |
横軸ラベル角度 | なし | XY プロットグラフにのみ適用されます。横軸ラベルの表示角度。 |
カテゴリラベル位置 | なし | カテゴリの軸ラベルテキストの位置。
|
日付目盛位置 | start | 日付目盛の位置。
|
円グラフ パラメーター
パラメータ | 既定 | 説明 |
---|---|---|
データ要素ラベル | データ要素のキー値のみを表示 | データ要素ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。
例 1 : " % 0 % = % 1 % " は " 独立 = 20 "のように表示されます。 |
データ要素切り離し | 切り離しなし | 切り離して表示されるデータ要素をコンマ区切りの一覧にしたもの。注意: JFreeChart のバージョン 1.0.3 以上が必要です。 |
添付ファイル パラメーター
この添付ファイルパラメーターは、グラフのバージョン管理に使用できる高度なオプションで、これによって自動化やパフォーマンスの向上が可能となります。このオプションは慎重にご使用ください!通常、グラフ画像はページが表示されるたびに再度生成されます。このオプションを使用すれば、生成された画像が添付ファイルとして保存され、次からはこの添付ファイルを再利用してグラフを表示できます。このオプションとキャッシュプラグインを組み合わせた場合、パフォーマンスを向上させるのに特に有効です。選択したオプションに応じて、グラフの画像をバージョン管理し、履歴に残せます。
パラメータ | 既定 | 説明 |
---|---|---|
添付ファイル | なし | 添付ファイルとして保存されるグラフ画像の名前と場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。
|
添付ファイル バージョン | 新規 | 保存されたグラフのバージョン管理方法を定義します。
|
添付ファイルのコメント | なし | 保存されたグラフ添付ファイルに付与されるコメント。 |
サムネイル | false |
|
例
円グラフ
マクロブラウザーのパラメーター |
マクロ プレースホルダー内のデータ表 | 描画されたグラフ |
|||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Type | 円グラフ |
|
![]() |
||||||||
グラフのタイトル | 2011 年の魚の売上 | ||||||||||
凡例表示 | true | ||||||||||
コンテンツの向き | 垂直 | ||||||||||
棒グラフ
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | 棒グラフ |
|
![]() |
||||||||||||
グラフのタイトル | 魚の売上 | ||||||||||||||
凡例表示 | true | ||||||||||||||
3 次元棒グラフ
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | 棒グラフ |
|
![]() |
||||||||||||
3D表示 | true | ||||||||||||||
不透明度 | 50 | ||||||||||||||
凡例表示 | true | ||||||||||||||
時系列グラフ
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | 時系列 |
|
|
![]() |
||||||||||||||||||||||||||||||||||||||||||||||||||||
日付の形式 | MM/yyyy | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
時間 | 月 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
コンテンツの向き | 垂直 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
縦軸の下限 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
凡例表示 | true | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
XY 折れ線グラフ
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | xy 折れ線グラフ |
|
![]() |
||||||||||||
凡例表示 | true | ||||||||||||||
XY 面グラフ
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | xy 面グラフ |
|
![]() |
||||||||||||
凡例表示 | true | ||||||||||||||
面グラフ
例 1
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | 面グラフ |
|
![]() |
||||||||||||||||||||
凡例表示 | true | ||||||||||||||||||||||
幅 | 300 | ||||||||||||||||||||||
高さ | 300 | ||||||||||||||||||||||
不透明度 | 50 | ||||||||||||||||||||||
例 2
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | 面グラフ |
|
![]() |
||||||||||||||||||||
凡例表示 | true | ||||||||||||||||||||||
幅 | 300 | ||||||||||||||||||||||
高さ | 300 | ||||||||||||||||||||||
値の積み上げ | true | ||||||||||||||||||||||
ガントチャート
マクロブラウザーのパラメーター | マクロ プレースホルダー内のデータ表 | 描画されたグラフ | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | ガントチャート |
|
![]() |
||||||||||||||||||||||||||||||||
幅 | 300 | ||||||||||||||||||||||||||||||||||
高さ | 200 | ||||||||||||||||||||||||||||||||||
列 | ,,1,2,3,4 | ||||||||||||||||||||||||||||||||||
日付形式 | MM/dd/yyyy | ||||||||||||||||||||||||||||||||||
コード例
Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) に便利です。
Macro name: chart
マクロ本文: リッチテキストに対応し、グラフのデータを含む表からなっています。
このマクロでは、便宜上種類別の一覧にまとめられた多数のパラメーターが使用されます。
Wiki マークアップの例
円グラフの簡単な例を示します。
{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}