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

チャートマクロを使用すれば、表形式データに基づいたチャートを表示できます。このマクロをページやリアルタイム文書に追加するには、次の手順を実行します。

マクロでグラフ化するデータを、マクロのプレースホルダーに表形式で入力します。
マクロブラウザーでマクロのパラメーターを編集し、グラフの書式を設定します。

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

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

編集時には、ツールバーからを選択します。
マクロを名前で検索して選択します。
必要に応じて設定します。

このページに「/」と入力して、ツールバーからを選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

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

タイプ パラメーター (下記参照) を使用して、チャートの種類を選択します。
以下に説明するように、マクロブラウザーで他のパラメータ設定を選択します。

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

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

マクロのプレースホルダーを選択します。
[編集] アイコンを選択して、設定パネルを開きます。
パラメーターを設定します。変更内容は、移動するごとに保存されます。
ページの編集を再開すると、パネルが閉じます。

中央揃え、幅、全幅の各アイコンを使用して、一部のマクロの幅を調整することもできます。マクロを削除するには、ゴミ箱アイコンを選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページまたはリアルタイム文書に表示する方法を制御できるオプションです。

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

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

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

パラメーター	既定	説明
タイプ	円グラフ	表示するチャートの種類です。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」を参照してください。
時間	日	時系列データの期間です。データの解釈に対する粒度を定義します。有効な値は Millisecond、Second、Minute、Hour、Day、Week、Month、Quarter、Year です。
言語	なし	ロケールを形成するために、国パラメーターと組み合わせて使用します。これらの追加の数字と日付形式は、既定の言語に先だってデータ変換に使用されます。有効な値は 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	日付目盛の位置。 `start` - 目盛りをその期間の開始に表示します。 `middle` - 目盛りをその期間の中間に表示します。 `end` - 目盛りをその期間の終了に表示します。

円グラフパラメーター

パラメーター	既定	説明
データ要素ラベル	データ要素のキー値のみを表示	データ要素ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。 %0% は円グラフセクションのキーで置換されます。 %1% は円グラフセクションの数値で置換されます。 %2% は、円グラフセクションのパーセント値で置換されます。例 1: "%0% = %1%" は "Independent = 20" のように表示されます。例 2: "%0% (%2%)" は "Independent (20%)" のように表示されます。
データ要素切り離し	切り離しなし	切り離して表示する円グラフのキーをカンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。

パラメーター

既定

説明

データ要素ラベル

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

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

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

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

データ要素切り離し

切り離しなし

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

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

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

パラメーター	既定	説明
添付ファイル	なし	添付ファイルとして保存されるグラフ画像の名前と場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。 ^ 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 折れ線グラフ

収益

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 `6/25/2013` `7/10/2013` `30%` ステージ 2 `7/13/2013` `11/28/2013` `40%` ステージ 3 `12/1/2013` `12/25/2013` ActualStartEndStatusStage 1 `6/25/2013` `7/26/2013` `100%` ステージ 2 `7/29/2013` `12/01/2013` `40%` ステージ 3 `12/10/2013` `12/25/2013`
幅	300
高さ	200
列	,,1,2,3,4
日付形式	MM/dd/yyyy

コード例

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

マクロ名: chart

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

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

パラメーター

パラメーターとは、設定してマクロの内容をページまたはリアルタイム文書に表示する方法を制御できるオプションです。

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

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

パラメーター	必須	既定	説明
`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`	グラフの凡例（キー）を表示するかどうかを決定します。

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

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

パラメーター	必須	既定	説明
`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` — マクロは厳密なデータ形式を適用します。データ形式エラーが生じると、グラフは作成されません。

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

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

パラメーター	必須	既定	説明
`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」のように表示するには、次のようにします。 `%0% = %1%` 例 2:「Independent = (20%)」のように表示するには、次のようにします。 `%0% (%2%)`
`pieSectionExplode`	いいえ	切り離しなし	切り離して表示する円グラフのキーをカンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。

パラメーター

必須

既定

説明

pieSectionLabel

いいえ

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

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

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

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


    
            %0% = %1%

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


    
            %0% (%2%)

pieSectionExplode

いいえ

切り離しなし

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

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

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

パラメーター	必須	既定	説明
`attachment`	いいえ	(なし)	名前とチャート画像が添付ファイルとして保存される場所です。ユーザーは指定したコンテンツに添付ファイルを追加する権限を与えられている必要があります。このパラメータに利用可能な構文： `^attachmentName.png` — チャートは現在のページまたは文書の添付ファイルとして保存されます。 `page name^attachmentName.png` — チャートは指定したページ名または文書名の添付ファイルとして保存されます。 `spacekey:page name^attachmentName.png` — チャートは、指定されたスペースの指定されたページ名または文書名の添付ファイルとして保存されます。
`attachmentVersion`	いいえ	`new`	保存されたグラフのバージョン管理方法を定義します。利用可能な値: `new` — 新しいバージョンの添付ファイルを作成します。 `replace` — チャートの以前のすべてのバージョンを置き換えます。既存の添付ファイルを置き換えるには、ユーザーは指定したページまたは文書から添付ファイルを削除する権限を与えられている必要があります。 `keep` — 同じ名前の既存のエクスポートが存在しない場合にのみ、新しい添付ファイルを保存します。既存の添付ファイルが変更または更新されることはありません。
`attachmentComment`	いいえ	(なし)	保存されたグラフ添付ファイルに付与されるコメント。
`thumbnail`	いいえ	`false`	`true` の場合— グラフ画像の添付ファイルがサムネイル (小さいサイズ、拡大可能) として表示されます。

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}
    

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問

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

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

パラメーター

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

表示制御パラメーター

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

データ仕様パラメーター

カラー パラメーター

軸パラメータ

円グラフ パラメーター

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

例

円グラフ

棒グラフ

3D 棒グラフ

時系列グラフ

XY 折れ線グラフ

XY 面グラフ

面グラフ

例 1

例 2

ガントチャート

コー​​ド例

パラメーター

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

グラフ表示パラメーター

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

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

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

グラフ軸パラメーター

円グラフ パラメーター

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

Wiki マークアップの例

さらにヘルプが必要ですか?

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

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

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

カラーパラメーター

円グラフパラメーター

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

コード例

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

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

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

円グラフパラメーター

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