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

タイプ

円グラフ

表示するグラフの種類。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

凡例を表示します。

表

すべての第1レベルの表

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

列

すべての列

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

コンテンツの向き

水平

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

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

時系列

false

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

日付形式

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

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

時間

日

時系列データの期間です。データの解釈に対する粒度を定義します。有効な値は Millisecond、Second、Minute、Hour、Day、Week、Month、Quarter、Year です。

言語

なし

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

国

なし

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

許可

true

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

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

背景色

白

グラフの背景。

bordercolor

枠線なし

グラフの周囲の枠線。

色

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

縦軸最小値

なし

縦軸の下限。

縦軸最大値

なし

縦軸の上限。

縦軸目盛単位

なし

縦軸の 1 目盛りの単位。

縦軸ラベル角度

なし

縦軸ラベルの表示角度。

横軸下限

なし

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

横軸上限

なし

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

横軸目盛単位

なし

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

横軸ラベル角度

 なし

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

カテゴリラベル位置

 なし

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

• up45 - 45 度上向き

  • up90 - 90 度上向き

  • down45 - 45 度下向き

  • down90 - 90 度下向き

日付目盛位置

 start

日付目盛の位置。

• start - 目盛りをその期間の開始に表示します。

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

  • end - 目盛りをその期間の終了に表示します。

データ要素ラベル

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

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

• %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

タイプ

棒グラフ

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 折れ線グラフ

12

14

23

収益

41.1

31.8

12.4

費用

31.1

41.8

43.6

凡例表示

true

タイプ

xy 面グラフ

12

14

23

収益

41.1

31.8

12.4

費用

31.1

41.8

43.6

凡例表示

true

タイプ

面グラフ

満足度

2009

2010

2011

非常に満足

20

23

34

満足

40

34

23

不満

25

26

25

非常に不満

15

17

18

凡例表示

true

幅

300

高さ

300

不透明度

50

タイプ

面グラフ

満足度

2009

2010

2011

非常に満足

12

23

31

満足

1

34

36

不満

4

6

22

非常に不満

2

7

12

凡例表示

true

幅

300

高さ

300

値の積み上げ

true

タイプ

ガントチャート

PlanStartEndStatusStage 1

ステージ 2

ステージ 3

ActualStartEndStatusStage 1

ステージ 2

ステージ 3

幅

300

高さ

200

列

,,1,2,3,4

日付形式

MM/dd/yyyy

type

いいえ

pie

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

利用可能な値:

• 標準グラフ - pie, bar, line, area

• XY プロット – xyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeries

• その他のグラフ – gantt

orientation

いいえ

vertical

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

利用可能な値:

• vertical - y 軸が垂直軸

• horizontal - x 軸が垂直軸

3D

いいえ

false

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

stacked

いいえ

false

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

showShapes

いいえ

true

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

opacity

いいえ

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

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

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

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

width

いいえ

300

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

height

いいえ

300

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

dataDisplay

いいえ

false

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

利用可能な値:

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

• true または after - データがチャートのあとに表示されます。

• before – - データがチャートの前に表示されます。

imageFormat

いいえ

png

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

利用可能な値:

• png

• jpg

title

いいえ

(なし)

グラフのタイトル。

subTitle

いいえ

(なし)

グラフのサブタイトル。

xLabel

いいえ

(なし)

x 軸（項目）のラベル。

yLabel

いいえ

(なし)

y 軸（値）のラベル。

legend

いいえ

false

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

tables

いいえ

すべての第 1 レベルの表

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

columns

いいえ

すべての列

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

dataOrientation

いいえ

horizontal

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

利用可能な値:

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

• horizontal – データ表の行が系列と解釈されます。

timeSeries

いいえ

false

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

dateFormat

いいえ

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

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

timePeriod

いいえ

day

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

利用可能な値: millisecond, second, minute, hour, day, week, month, quarter, year

language

いいえ

(なし)

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

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

country

いいえ

(なし)

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

forgive

いいえ

true

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

利用可能な値:

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

• false — マクロは厳密なデータ形式を適用します。データ形式エラーが生じると、グラフは作成されません。

bgColor

いいえ

白

グラフの背景色。

borderColor

いいえ

枠線なし

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

colors

いいえ

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

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

いいえ

(なし)

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

利用可能な値:

• up45 - 45 度上向き

• up90 - 90 度上向き

• down45 - 45 度下向き

• down90 - 90 度下向き

dateTickMarkPosition

いいえ

 start

日付目盛の位置。

利用可能な値:

• start - 目盛りをその期間の開始に表示します。

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

• end - 目盛りをその期間の終了に表示します。

pieSectionLabel

いいえ

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

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

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

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

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

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

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

pieSectionExplode

いいえ

切り離しなし

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

attachment

いいえ

(なし)

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

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

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

• page name^attachmentName.png — チャートは指定したページ名に添付ファイルとして保存されます。

• spacekey:page name^attachmentName.png — チャートは、指定されたスペースの指定されたページ名に添付ファイルとして保存されます。

attachmentVersion

いいえ

new

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

利用可能な値:

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

• replace — チャートの以前のすべてのバージョンを置き換えます。既存の添付ファイルを置き換えるには、ユーザーは指定したページから添付ファイルを削除する権限を与えられている必要があります。

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

attachmentComment

いいえ

(なし)

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

thumbnail

いいえ

false

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