チャート マクロ
チャート マクロを使用すれば、表形式データに基づいたグラフを表示できます。ページにマクロを追加する場合、次のようにします。
- マクロでグラフ化するデータを、マクロのプレースホルダーに表形式で入力します。
- マクロ ブラウザーでマクロのパラメーターを編集し、グラフの書式を設定します。
スクリーンショット1 :チャート マクロのプレースホルダに納められたデータ表
スクリーンショット2 :得られたグラフ
On this page:
チャート マクロを使用する
ページにチャート マクロを追加する方法
- ページを編集し、オートコンプリートを使用してチャート マクロを追加します (「{chart}」と入力)。
- 1 つ以上の表にまとめたグラフのデータを、マクロ プレースホルダーの本文に入力します。(上のスクリーンショットを参照してください。)
- マクロ プレースホルダーをクリックして、[編集] を選択します。
- タイプ パラメーター (下記参照) を使用して、グラフの種類を選択します。
- 以下に説明するように、マクロ ブラウザで他のパラメータ設定を選択します。
- プレビュー領域で [リフレッシュ] をクリックして、グラフが期待どおりに表示されていることを確認します。
- [保存] をクリックして、ページにチャートを追加します。
- ページを保存する準備ができたら、もう一度 [保存] をクリックします。
パラメーター
グラフ タイプのパラメーター
これらのパラメーターは、表示するグラフの種類やグラフの表示方法を決定します。
パラメーター | 既定 | 説明 |
---|---|---|
タイプ | 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 以降が必要です。 |
添付ファイルのパラメーター
この添付ファイルパラメーターは、グラフのバージョン管理に使用できる高度なオプションで、これによって自動化やパフォーマンスの向上が可能となります。このオプションは慎重にご使用ください!通常、グラフ画像はページが表示されるたびに再度生成されます。このオプションを使用すれば、生成された画像が添付ファイルとして保存され、次からはこの添付ファイルを再利用してグラフを表示できます。このオプションとキャッシュプラグインを組み合わせた場合、パフォーマンスを向上させるのに特に有効です。選択したオプションに応じて、グラフの画像をバージョン管理し、履歴に残せます。
パラメーター | 既定 | 説明 |
---|---|---|
添付ファイル | なし | 添付ファイルとして保存されるグラフ画像の名前と場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。
|
添付ファイルのバージョン | 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 | ||||||||||||||||||||||||||||||||||
|
コードの例
次の例は、Confluence ページの基礎となるマークアップを編集したい上級ユーザーのために提供します。
マクロ名: chart
マクロ本文: リッチテキストに対応し、チャートのデータを含む表で構成されます。
このマクロでは、便宜上種類別の一覧にまとめられた多数のパラメーターが使用されます。
保存形式の例
Below is a simple example of a pie chart. See more examples in Storage Format Examples for Chart Macro.
<ac:structured-macro ac:name="chart">
<ac:parameter ac:name="title">Fish Sold</ac:parameter>
<ac:parameter ac:name="type">pie</ac:parameter>
<ac:rich-text-body>
<table>
<tbody>
<tr>
<th>
<p>Fish Type</p>
</th>
<th>
<p>2004</p>
</th>
<th>
<p>2005</p>
</th>
</tr>
<tr>
<th>
<p>Herring</p>
</th>
<td>
<p>9,500</p>
</td>
<td>
<p>8,300</p>
</td>
</tr>
<tr>
<th>
<p>Salmon</p>
</th>
<td>
<p>2,900</p>
</td>
<td>
<p>4,200</p>
</td>
</tr>
<tr>
<th>
<p>Tuna</p>
</th>
<td>
<p>1,500</p>
</td>
<td>
<p>1,500</p>
</td>
</tr>
</tbody>
</table>
</ac:rich-text-body>
</ac:structured-macro>
Wiki マークアップの例
下に示すのは、円グラフの簡単な例です。その他の例については、チャート マクロ用 Wiki Markup の例を参照してください 。
{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}