Confluence 4.3 のサポートは終了しています。
ドキュメントの最新バージョンを確認してください。
This page is a snippet
For full information, see:
snippet
Macro name: chart
Macro body: Accepts rich text, consisting of tables that hold the chart's data.
このマクロでは、便宜上種類別の一覧にまとめられた多数のパラメーターが使用されます。
チャート タイプのパラメーター
これらのパラメーターは、表示するチャートのタイプやチャートの外観を決定します。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
type | いいえ | pie | 表示するチャートの種類。XY グラフは x 軸と y 軸の数値軸を持ちます。x の値は必要に応じて時間ベースにできます。 利用可能な値:
|
orientation | いいえ | vertical | 表示の向き。area、bar、および line チャートに適用されます。 利用可能な値:
|
3D | いいえ | false | 3 次元で表示します。area、bar、および line チャートに適用されます。 |
stacked | いいえ | false | 積み重ね値。area、bar チャートに適用されます。 |
showShapes | いいえ | true | line チャートに適用されます。各データの位置に図形が表示されます。 |
opacity | いいえ |
| 0 パーセント (透明) から 100 パーセント (不透明) までの値で、前景領域と棒部分の不透明度を決定します。 |
チャートの表示パラメーター
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
width | いいえ | 300 | ピクセル単位で示されるチャートの幅。 |
height | いいえ | 300 | ピクセル単位で示されるチャートの高さ。 |
dataDisplay | いいえ | false | データ表で構成される、マクロ本文を表示するかどうかを決定します。既定では、チャートのデータ表は表示されません。 利用可能な値:
|
imageFormat | いいえ | png | チャートに使用される画像のフォーマット。 利用可能な値:
|
チャートのタイトルとラベルのパラメーター
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
title | いいえ | (なし) | チャートのタイトル。 |
subTitle | いいえ | (なし) | グラフのサブタイトル。 |
xLabel | いいえ | (なし) | x 軸 (項目) のラベル。 |
yLabel | いいえ | (なし) | y 軸 (値) のラベル。 |
legend | いいえ | false | チャートの凡例 (キー) を表示するかどうかを決定します。 |
チャートのデータのパラメーター
チャートのデータは、マクロ本文で見つかった表から取得されます。これらのパラメーターは、このデータの解釈方法を制御します。既定では、数値と日付の値は、Confluence のグローバル既定言語 (ロケール) のフォーマットに従って解釈されます。変換が失敗した場合は、Confluence で定義されている他の言語で試行されます。以下のパラメータを使用すると、追加の変換オプションを指定できます。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
tables | いいえ | すべての第 1 レベルの表 | マクロ本文に含まれ、チャートのデータとして使用される、表 ID または表番号 (1 で開始) をコンマ区切りの一覧にしたものを提供できます。データ表が他のテーブルに埋め込まれている場合、表を選択する必要があります。このような事例は、より複雑な書式設定が行われる (例: セクション マクロや列マクロを使用) 場合に生じます。 |
columns | いいえ | すべての列 | チャート データに使用される表の列ラベルや列タイトル、列番号をコンマ区切りにした一覧指定できます。これは処理されるすべての表に適用されます。列には 1 から始まる番号が付いています。列ラベルは、ヘッダー行の列のテキストです。列タイトルは、ヘッダー行の列の (html の) title 属性です。 |
dataOrientation | いいえ | horizontal | コンテンツの向きです。既定では、データ表の (水平方向の) 列が定義域および x の値を表していると解釈されます。 利用可能な値:
|
timeSeries | いいえ | false | " |
dateFormat | いいえ | Confluence 言語で定義された日付形式 | For time series data, the date format allows for additional customisation of the conversion of data to date values. If a dateFormat is specified, it will be the first format used to interpret date values. Specify a format that matches the time series data. See simple date format. |
timePeriod | いいえ | day | 時系列データに使用される期間。データの解釈粒度を定義します。 利用可能な値: |
language | いいえ | (なし) | ロケールを形成するために、 Available values are the two-character ISO 639-1 alpha-2 codes. |
country | いいえ | (なし) | Use in combination with the language parameter to form a locale. Valid values are the two-character ISO 3166 codes. |
forgive | いいえ | true | マクロがデータ形式エラーを容認 (許可) するかどうかを決定します。 利用可能な値:
|
グラフカラー パラメーター
色は、16 進数表記または HTML カラーネームを使用して指定します。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
bgColor | いいえ | 白 | グラフの背景色。 |
borderColor | いいえ | 枠線なし | グラフの周りの枠線の色。 |
colors | いいえ | カテゴリ、セクション、系列の色をカスタマイズするために使用する色をコンマ区切りの一覧にしたもの。 |
チャートの軸のパラメーター
グラフの種類に応じて、縦軸、横軸をカスタマイズできます。軸の値はデータに基づいて自動的に生成されますが、これらのパラメータを 1 つ以上指定することにより上書きできます。
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
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 | いいえ | (なし) | カテゴリの軸ラベルのテキストの位置。 利用可能な値:
|
dateTickMarkPosition | いいえ | start | 日付の目盛りの位置。 利用可能な値:
|
Pie チャートのパラメーター
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
pieSectionLabel | いいえ | 円グラフのセクションのキー値のみを表示 | 円グラフのセクション ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。
例 1: "Independent = 20" のように表示するには、次のようにします。 %0% = %1%
%0% (%2%) |
pieSectionExplode | いいえ | 切り離しなし | 切り離して表示する円グラフのキーをコンマ区切りの一覧にしたもの。注意: JFreeChart バージョン 1.0.3 以降が必要です。 |
チャートの添付ファイルのパラメーター
These are advanced options that can be used for chart versioning, to enable automation and to improve performance. Use these options carefully! Normally, the chart image is regenerated each time the page is displayed. These options allow for the generated image to be saved as an attachment and have subsequent access to re-use the attachment. This can be useful especially when combined with the Cache plugin to improve performance. Depending on the options chosen, chart images can be versioned for historical purposes.
| パラメーター | 必須 | 既定 | 説明 |
|---|---|---|---|
attachment | いいえ | (なし) | 名前とグラフ画像が添付ファイルとして保存される場所です。ユーザーは指定したページに添付ファイルを追加する権限を与えられていなければなりません。 このパラメータで利用可能な構文は次のとおりです。
|
attachmentVersion | いいえ | new | 保存されたチャートのバージョン管理方法を定義します。 利用可能な値:
|
attachmentComment | いいえ | (なし) | 保存されたチャート添付ファイルに使用されるコメント。 |
thumbnail | いいえ | false | |
