チャート マクロを挿入する

チャート マクロを使用すれば、表形式データをもとにグラフを表示できます。ページにマクロを追加する場合:

  • マクロでグラフ化するデータを、マクロのプレースホルダーに表形式で入力します。

  • マクロブラウザーでマクロのパラメーターを編集し、グラフの書式を設定します。

チャート マクロを使用する

チャート マクロを追加するには、次の手順に従います。

  1. 編集時には、ツールバーから を選択します。

  2. 挿入するアイテムを探して選択します

  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

チャート データを入力するには、次の手順に従います。

  1. 種類パラメーター(下記参照)を使用して、グラフの種類を選択します。

  2. 以下に説明するように、マクロブラウザーで他のパラメータ設定を選択します。

データ系列またはデータ タイプの値がないことを表すには、ゼロを使用します。セルを空欄/空値のままにすると、グラフの表示時に問題が発生します。

チャート マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

  2. 編集を選択します。右側のパネルが開きます。

  3. パラメータを修正します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します ()。

グラフの種類パラメーター

これらのパラメーターは、表示するグラフの種類やグラフの表示方法を決定します。

パラメーター

既定

説明

タイプ

円グラフ

表示するグラフの種類。XY グラフには、数値軸の x 軸と y 軸があります。x の値は、必要に応じて時間ベースにできます(時系列パラメーターを参照してください)。

標準 - 円グラフ、棒グラフ、線グラフ、面グラフ

XY プロット - xy 面グラフ、xy 棒グラフ、xy 折れ線グラフ、xy ステップ チャート、xy ステップ エリア チャート、散布図、時系列グラフ

その他 - ガントチャート

表示方向

垂直

面グラフ、棒グラフ、折れ線グラフに適用されます。

  • 垂直 - y 軸が垂直軸です

    • 水平 - x 軸が垂直軸です

3D で表示

false

面グラフ、棒グラフ、折れ線グラフに適用されます。

値の積み上げ

false

面グラフ、棒グラフに適用されます。

図形表示

true

折れ線グラフに適用されます。各データの位置に図形が表示されます。

不透明度

  • 3D チャートの場合 75 パーセント

  • 非積み上げの area チャートの場合 50 パーセント

  • 他のすべてのチャートは 100 パーセント

0 パーセント (透明) から 100 パーセント (不透明) までの値で、前景領域と棒部分の不透明度を決定します。

表示制御パラメーター

パラメーター

既定

説明

300

ピクセル単位で示されるグラフの幅。

高さ

300

ピクセル単位で示されるグラフの高さ。

元データ表示

false

マクロの本文(通常データ表)を表示するかどうかを設定します。既定では、グラフのデータ表は表示されません。

  • - データがグラフの前に表示されます。

    • - データがグラフの後に表示されます。

画像フォーマット

png

グラフに使用される画像のフォーマット。

  • png

    • jpg

タイトルとラベル パラメーター

パラメーター

既定

説明

グラフのタイトル

なし

グラフのタイトル。

グラフのサブタイトル

なし

グラフのサブタイトル、タイトル用のフォントより小さいフォントを使用します。

横軸ラベル

なし

x 軸(項目)のラベル。

縦軸ラベル

なし

y 軸(値)のラベル。

凡例表示

true

凡例を表示します。

データ仕様パラメーター

グラフに使用するデータは、マクロ本文をグラフ化する際に探し出された表から取得されます。このデータをどう解釈するか制御するのが、このオプションです。数値、日付の値は、既定では Confluence のグローバル既定言語(ロケール)フォーマットに従って解釈されます。変換が失敗した場合は、Confluence で定義されている他の言語で試行されます。追加の変換オプションは、以下のパラメータを使用して指定できます。

パラメーター

既定

説明

すべての第1レベルの表

表 ID または表番号 (1 で開始) をコンマ区切りの一覧にしたもので、チャートのデータとして使用されるマクロ本文に含まれます。データ表が他のテーブルに埋め込まれている場合、表を選択する必要があります。このような事例は、より複雑な書式設定が行われる場合 (例: セクション マクロや列マクロを使用) に生じます。

すべての列

チャート データに使用される表の列ラベルや列タイトル、列番号を、コンマ区切りの一覧にしたものです。これは処理されるすべての表に適用されます。列には 1 から始まる番号が付いています。列ラベルは、ヘッダー行の列のテキストです。列タイトルは、ヘッダー行の列の (html の) title 属性です。

コンテンツの向き

水平

  • 垂直 - データ表の列が系列と解釈されます。

    • 水平 - データ表の行が系列と解釈されます。

時系列

false

  • true の場合 - XY プロットグラフの x の値は時系列データとして扱われるため、日付形式に変換されます。

日付形式

Confluence 言語で定義された日付形式

時系列データの場合、日付形式を使用すれば、データを日付値に変換するといった追加のカスタマイズが可能です。日付形式が指定されている場合、日付値の解釈をするために最初に使用されるのがこの日付形式です。時系列データに一致する形式を指定します。クラス simple date format を参照してください 。

時間

時系列データの期間です。データの解釈に対する粒度を定義します。有効な値は MillisecondSecondMinuteHour、Day、WeekMonthQuarterYear です。

言語

なし

ロケールを形成するために、パラメーターと組み合わせて使用します。これらの追加の数字と日付形式は、既定の言語に先だってデータ変換に使用されます。
有効な値は 2 文字の ISO 639-1 alpha-2 言語コードです。

なし

ロケールを形成するために、言語パラメーターと組み合わせて使用します。有効な値は 2 文字の ISO 3166 コードです。

許可

true

  • true の場合 - マクロは、既定またはユーザ指定の表示形式のいずれとも完全に一致しない数値および日付の値を変換しようとします。

    • false の場合 - 厳密なデータ形式を適用します。データ形式エラーが生じると、グラフが作成されません。

カラー パラメーター

色は、16 進数表記または HTML カラーネームを使用して指定します。

パラメーター

既定

説明

背景色

グラフの背景。

bordercolor

枠線なし

グラフの周囲の枠線。

 

カテゴリ、セクション、系列の色をカスタマイズするために使用する色をコンマ区切りの一覧にしたもの。

軸パラメータ

グラフの種類に応じて、縦軸、横軸をカスタマイズできます。軸の値はデータに基づいて自動的に生成されますが、これらのパラメータを 1 つ以上指定することにより上書きできます。

パラメーター

既定

説明

縦軸最小値

なし

縦軸の下限。

縦軸最大値

なし

縦軸の上限。

縦軸目盛単位

なし

縦軸の 1 目盛りの単位。

縦軸ラベル角度

なし

縦軸ラベルの表示角度。

横軸下限

なし

XY プロットグラフにのみ適用されます。横軸の下限。日付軸の場合、この値は、日付形式パラメーターで指定された日付形式でなければなりません

横軸上限

なし

XY プロットグラフにのみ適用されます。横軸の上限。日付軸の場合、この値は、日付形式パラメーターで指定された日付形式でなければなりません

横軸目盛単位

なし

XY プロットグラフにのみ適用されます。横軸の 1 目盛りの単位。日付軸の場合、この値は、時間パラメーターで指定された単位の数になります。時間単位は、終了文字を指定することにより上書きできます: y(年)、m(か月)、d(日)、h(時間)、m(分)、s(秒)、u(ミリ秒)。

横軸ラベル角度

 なし

XY プロットグラフにのみ適用されます。横軸ラベルの表示角度。 

カテゴリラベル位置

 なし

カテゴリの軸ラベルテキストの位置。

  • up45 — 45 度上向き

    • up90 — 90 度上向き

    • down45 — 45 度下向き

    • down90 — 90 度下向き

日付目盛位置

 start

日付目盛の位置。

  • 開始 - 日付目盛をその期間の開始位置に表示します。

    • 中間 - 日付目盛をその期間の中間に表示します。

    • 終了 - 日付目盛をその期間の終了位置に表示します。

円グラフ パラメーター

パラメーター

既定

説明

データ要素ラベル

データ要素のキー値のみを表示

データ要素ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。

  • %0% は円グラフ セクションのキーで置換されます。

    • %1% は円グラフ セクションの数値で置換されます。

    • %2% は、円グラフ セクションのパーセント値で置換されます。

例 1: "%0% = %1%" は "Independent = 20" のように表示されます。
例 2: "%0% (%2%)" は "Independent (20%)" のように表示されます。

データ要素切り離し

切り離しなし

切り離して表示する円グラフのキーをカンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。

添付ファイル パラメーター

この添付ファイルパラメーターは、グラフのバージョン管理に使用できる高度なオプションで、これによって自動化やパフォーマンスの向上が可能となります。このオプションは慎重にご使用ください!通常、グラフ画像はページが表示されるたびに再度生成されます。このオプションを使用すれば、生成された画像が添付ファイルとして保存され、次からはこの添付ファイルを再利用してグラフを表示できます。このオプションと キャッシュプラグイン を組み合わせた場合、パフォーマンスを向上させるのに特に有効です。選択したオプションに応じて、グラフの画像をバージョン管理し、履歴に残せます。

パラメーター

既定

説明

添付ファイル

なし

添付ファイルとして保存されるグラフ画像の名前と場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。

  • ^ attachmentName.png - グラフは現在のページに添付ファイルとして保存されます。

    • ページ^ attachmentName.png - グラフは名前が指定されたページに添付ファイルとして保存されます。

    • スペース:ページ^ attachmentName.png - グラフは指示されたスペースの指定されたページに添付ファイルとして保存されます。

添付ファイル バージョン

新規

保存されたグラフのバージョン管理方法を定義します。

  • 新規 - 新しいバージョンの添付ファイルを作成します。

    • 置換 - 以前のバージョンのグラフをすべて置き換えます。既存の添付ファイルを置き換えるには、ユーザーは指定したページから添付ファイルを削除する権限を与えられていなければなりません。

    • 保持 - 同じ名前の既存のエクスポートが存在しない場合にのみ、新しい添付ファイルを保存します。既存の添付ファイルが変更または更新されることはありません。

添付ファイルのコメント

なし

 保存されたグラフ添付ファイルに付与されるコメント。

サムネイル

false

  •  true の場合— グラフ画像の添付ファイルがサムネイルとして表示されます。

 

円グラフ

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

円グラフ

魚の種類

2011

ニシン

9,500

2,900

マグロ

1,500

チャート マクロにより作成されたグラフの例

グラフのタイトル

2011 年魚の売上

凡例表示

true

コンテンツの向き

垂直

 

 

 

 

 

 

 

 

 

 

棒グラフ

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

棒グラフ

魚の種類

2010

2011

ニシン

9,500

8,300

2,900

4,200

マグロ

1,500

1,500

チャート マクロにより作成された棒グラフの例

グラフのタイトル

魚の売上

凡例表示

true

 

 

 

 

 

 

 

 

 

 

 

3D 棒グラフ

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

棒グラフ

 

2009

2010

2011

収益

12.4

31.8

41.1

費用

43.6

41.8

31.1

チャート マクロにより作成されたグラフの例

3D で表示

true

不透明度

50

凡例表示

true

 

 

 

 

 

 

 

 

時系列グラフ

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

時系列

収益

1/2011

31.8

2/2011

41.8

3/2011

51.3

4/2011

33.8

5/2011

27.6

6/2011

49.8

7/2011

51.8

8/2011

77.3

9/2011

73.8

10/2011

97.6

11/2011

101.2

12/2011

113.7

費用

1/2011

41.1

2/2011

43.8

3/2011

45.3

4/2011

45.0

5/2011

44.6

6/2011

43.8

7/2011

51.8

8/2011

52.3

9/2011

53.8

10/2011

55.6

11/2011

61.2

12/2011

63.7

チャート マクロにより作成されたグラフの例

日付の形式

MM/yyyy

時間

コンテンツの向き

垂直

縦軸の下限

0

凡例表示

true

 

 

 

 

 

 

 

 

 

 

 

XY 折れ線グラフ

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

xy 折れ線グラフ

 

12

14

23

収益

41.1

31.8

12.4

費用

31.1

41.8

43.6

チャート マクロにより作成されたグラフの例

凡例表示

true

 

 

 

 

XY 面グラフ

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

xy 面グラフ

12

14

23

収益

41.1

31.8

12.4

費用

31.1

41.8

43.6

チャート マクロにより作成されたグラフの例

凡例表示

true

 

 

 

 

 

 

 

 

 

 

 

面グラフ

例 1

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

面グラフ

満足度

2009

2010

2011

非常に満足

20

23

34

満足

40

34

23

不満

25

26

25

非常に不満

15

17

18

チャート マクロにより作成された面グラフの例

凡例表示

true

300

高さ

300

不透明度

50

 

 

 

 

例 2

マクロブラウザーのパラメーター

 

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

面グラフ

満足度

2009

2010

2011

非常に満足

12

23

31

満足

1

34

36

不満

4

6

22

非常に不満

2

7

12

チャート マクロで作成された面グラフの例

 

凡例表示

true

300

高さ

300

値の積み上げ

true

 

 

 

ガントチャート

マクロブラウザーのパラメーター

マクロ プレースホルダー内のデータ表

描画されたグラフ

タイプ

ガントチャート

PlanStartEndStatusStage 1

1 6/25/2013
1 7/10/2013
1 30%

ステージ 2

1 7/13/2013
1 11/28/2013
1 40%

ステージ 3

1 12/1/2013
1 12/25/2013

ActualStartEndStatusStage 1

1 6/25/2013
1 7/26/2013 
1 100%

ステージ 2

1 7/29/2013
1 12/01/2013
1 40%

ステージ 3

1 12/10/2013
1 12/25/2013
チャート マクロで作成されたガント チャートの例

 

 

300

高さ

200

,,1,2,3,4

日付形式

MM/dd/yyyy

 

 

 

コー​​ド例

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

Macro name: chart

マクロ本文: リッチテキストに対応し、グラフのデータを含む表からなっています。

このマクロでは、便宜上種類別の一覧にまとめられた多数のパラメーターが使用されます。

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します ()。

グラフの種類パラメーター

これらのパラメーターは、表示するグラフの種類やグラフの表示方法を決定します。

パラメーター

必須

既定

説明

type

いいえ

円グラフ

表示するチャートの種類です。XY グラフには x 軸と y 軸の数値軸があります。値 x は必要に応じて時間ベースにできます。timeSeries パラメーターをご参照ください。

利用可能な値:

  • Standard charts - pie, bar, line, area

  • XY プロットxy 面グラフ、xy 棒グラフ、xy 折れ線グラフ、xy ステップ チャート、xy ステップ エリア チャート、散布図、時系列グラフ

  • その他のグラフガントチャート

表示方向

いいえ

垂直

表示方向面グラフ、棒グラフ、折れ線グラフに適用されます。

利用可能な値:

  • 垂直 - y 軸が垂直軸です

  • 水平 - x 軸が垂直軸です

3D

いいえ

false

3 次元で表示します。面グラフ、棒グラフ、折れ線グラフに適用されます。

積み重ね

いいえ

false

積み重ね値。面グラフ、棒グラフに適用されます。

図形表示

いいえ

true

折れ線グラフに適用されます。各データの位置に図形が表示されます。

不透明度

いいえ

  • 3D チャートの場合 75 パーセント

  • 非積み上げの area チャートの場合 50 パーセント

  • 他のすべてのチャートは 100 パーセント

0 パーセント (透明) から 100 パーセント (不透明) までの値で、前景領域と棒部分の不透明度を決定します。

グラフ表示パラメーター

パラメーター

必須

既定

説明

width

いいえ

300

ピクセル単位で示されるグラフの幅。

height

いいえ

300

ピクセル単位で示されるグラフの高さ。

元データ表示

いいえ

false

データ表からなるマクロの本文を表示するかどうかを設定します。既定では、グラフのデータ表は表示されません。

利用可能な値:

  • false - データは表示されません。

  • trueまたは - データがグラフの後に表示されます。

  • - データがグラフの前に表示されます。

画像フォーマット

いいえ

png

グラフに使用される画像のフォーマット。

利用可能な値:

  • png

  • jpg

グラフタイトルとラベル パラメーター

パラメーター

必須

既定

説明

title

いいえ

(なし)

グラフのタイトル。

サブタイトル

いいえ

(なし)

グラフのサブタイトル。

x 軸ラベル

いいえ

(なし)

x 軸(項目)のラベル。

y 軸ラベル

いいえ

(なし)

y 軸(値)のラベル。

凡例

いいえ

false

グラフの凡例(キー)を表示するかどうかを決定します。

グラフデータ パラメーター

グラフに使用するデータは、マクロ本文内で探し出された表から取得されます。このデータをどう解釈するか制御するのが、以下のパラメーターです。数値、日付の値は、既定では Confluence のグローバル既定言語(ロケール)フォーマットに従って解釈されます。変換が失敗した場合は、Confluence で定義されている他の言語で試行されます。以下のパラメータを使用すると、追加の変換オプションを指定できます。

パラメーター

必須

既定

説明

テーブル

いいえ

すべての第 1 レベルの表

チャートのデータとして使用され、マクロ本体に含まれる表 ID や表番号 (1 で開始) をカンマ区切りの一覧で指定できます。データ表が他の表に埋め込まれている場合は、表を選択する必要があります。これは、より複雑な書式設定が行われる (例: セクション マクロや列マクロを使用) 場合に生じます。

いいえ

すべての列

チャート データに使用される表の列ラベル、列タイトル、列番号をカンマ区切りの一覧で指定できます。これは処理されるすべての表に適用されます。列には 1 から始まる番号が付いています。列ラベルは、ヘッダー行の列のテキストです。列タイトルは、ヘッダー行の列の HTML タイトル属性です。

データの向き

いいえ

水平

コンテンツの向き既定では、データ表の(水平方向の)列の並びが定義域および x の値を表していると解釈されます。

利用可能な値:

  • 垂直 - データ表の列が系列と解釈されます。

  • 水平 - データ表の行が系列と解釈されます。

時系列

いいえ

false

true 」の場合 - XY プロットグラフの x の値は、時系列データとして扱われるので、日付形式に変換されます。

日付形式

いいえ

Confluence 言語で定義された日付形式

時系列データの場合、日付形式を使用すれば、データを日付値に変換するといった追加のカスタマイズが可能です。日付形式が指定されている場合、日付値の解釈をするために最初に使用されるのがこの日付形式です。時系列データに一致する形式を指定します。クラス simple date format を参照してください 。

時間

いいえ

時系列データに使用される時間。データが解釈される精度を定義します。

利用可能な値: ミリ秒、秒、分、時間、日、週、月、四半期、年

language

いいえ

(なし)

ロケールを形成するために、 パラメーターと組み合わせて使用​​します。これらの追加の数字と日付形式は、既定の言語に先だってデータ変換に使用されます。

利用可能な値は 2 文字の ISO 639-1 alpha-2 言語コードです。

いいえ

(なし)

ロケールを形成するために、言語 パラメーターと組み合わせて使用​​します。有効な値は 2 文字の ISO 3166 コードです。

許可

いいえ

true

マクロがデータ形式エラーを容認(許可)するかどうかを決定します。

利用可能な値:

  • true の場合 - マクロは、既定またはユーザ指定の表示形式のいずれとも完全に一致しない数値および日付の値を変換しようとします。

  • false の場合 - 厳密なデータ形式を適用します。データ形式エラーが生じると、グラフが作成されません。

グラフカラー パラメーター

色は、16 進数表記または HTML カラーネームを使用して指定します。

パラメーター

必須

既定

説明

bgColor

いいえ

グラフの背景色。

bordercolor

いいえ

枠線なし

グラフの周りの枠線の色。

いいえ

 

カテゴリ、セクション、系列の色をカスタマイズするために使用する色をコンマ区切りの一覧にしたもの。

グラフ軸パラメーター

グラフの種類に応じて、縦軸、横軸をカスタマイズできます。軸の値はデータに基づいて自動的に生成されますが、これらのパラメータを 1 つ以上指定することにより上書きできます。

パラメーター

必須

既定

説明

rangeAxisLowerBound

いいえ

(なし)

縦軸の最小値。

rangeAxisUpperBound

いいえ

(なし)

縦軸の最大値。

rangeAxisTickUnit

いいえ

(なし)

縦軸の 1 目盛りの単位。

rangeAxisLabelAngle

いいえ

(なし)

縦軸ラベルの表示角度。

domainAxisLowerBound

いいえ

(なし)

XY プロットグラフにのみ適用されます。横軸の下限。日付軸の場合、この値は、日付形式パラメーターで指定された日付形式でなければなりません

domainAxisUpperBound

いいえ

(なし)

XY プロットグラフにのみ適用されます。横軸の上限。日付軸の場合、この値は、日付形式パラメーターで指定された日付形式でなければなりません

domainAxisTickUnit

いいえ

(なし)

XY プロットグラフにのみ適用されます。横軸の 1 目盛りの単位。日付軸の場合、この値は、時間パラメーターで指定された単位の数になります。時間単位は、終了文字を指定することで上書きできます: y (年)、m (月)、d (日)、h (時間)、m (分)、s (秒)、u (ミリ秒)。

domainAxisLabelAngle

いいえ

(なし)

XY プロットグラフにのみ適用されます。横軸ラベルの表示角度。 

categoryLabelPosition

いいえ

(なし)

カテゴリの軸ラベルテキストの位置。

利用可能な値:

  • up45 — 45 度上向き

  • up90 — 90 度上向き

  • down45 — 45 度下向き

  • down90 — 90 度下向き

dateTickMarkPosition

いいえ

 start

日付目盛の位置。

利用可能な値:

  • 開始 - 日付目盛をその期間の開始位置に表示します。

  • 中間 - 日付目盛をその期間の中間に表示します。

  • 終了 - 日付目盛をその期間の終了位置に表示します。

円グラフ パラメーター

パラメーター

必須

既定

説明

pieSectionLabel

いいえ

データ要素のキー値のみを表示

データ要素ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。

  • %0% は円グラフ セクションのキーで置換されます。

  • %1% は円グラフ セクションの数値で置換されます。

  • %2% は円グラフ セクションのパーセント値で置換されます。

例 1: 「Independent = 20」のように表示するには、次のようにします。

1 2 3 4 %0% = %1%


Example 2: To display something like 'Independent (20%)':

1 2 3 4 %0% (%2%)

pieSectionExplode

いいえ

切り離しなし

切り離して表示する円グラフのキーをカンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。

グラフ添付ファイル パラメーター

この添付ファイルパラメーターは、グラフのバージョン管理に使用できる高度なオプションで、これによって自動化やパフォーマンスの向上が可能となります。このオプションは慎重にご使用ください!通常、グラフ画像はページが表示されるたびに再度生成されます。このオプションを使用すれば、生成された画像が添付ファイルとして保存され、次からはこの添付ファイルを再利用してグラフを表示できます。このオプションと キャッシュプラグイン を組み合わせた場合、パフォーマンスを向上させるのに特に有効です。選択したオプションに応じて、グラフの画像をバージョン管理し、履歴に残せます。

パラメーター

必須

既定

説明

attachment

いいえ

(なし)

名前とグラフ画像が添付ファイルとして保存される場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。

このパラメータに利用可能な構文:

  • ^ attachmentName.png - グラフは現在のページに添付ファイルとして保存されます。

  • page name^attachmentName.png- グラフは名前が指定されたページに添付ファイルとして保存されます。

  • spacekey:page name^attachmentName.png - グラフは指定したスペースの指定したページに添付ファイルとして保存されます。

attachmentVersion

いいえ

新規

保存されたグラフのバージョン管理方法を定義します。

利用可能な値:

  • 新規 - 新しいバージョンの添付ファイルを作成します。

  • 置換 -以前のバージョンのグラフをすべて置き換えます。既存の添付ファイルを置き換えるには、ユーザーは指定したページから添付ファイルを削除する権限を与えられていなければなりません。

  • 保持 - 同じ名前の既存のエクスポートが存在しない場合にのみ、新しい添付ファイルを保存します。既存の添付ファイルが変更または更新されることはありません。

attachmentComment

いいえ

(なし)

 保存されたグラフ添付ファイルに付与されるコメント。

サムネイル

いいえ

false

 true の場合は、グラフ画像の添付ファイルがサムネイル (小さいサイズ、拡大可能) として表示されます。

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

円グラフの簡単な例を示します。

1 2 3 4 5 6 7 8 9 {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}

その他のヘルプ