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 の値は必要に応じて時間ベースにできます。timeSeries パラメーターをご参照ください。

利用可能な値:

  • 標準グラフ - pie, bar, line, area
  • XY プロットxyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeries
  • Other chartsgantt (beta)
orientationいいえvertical

表示の向き。area、bar、および line チャートに適用されます。

利用可能な値:

  • vertical - y 軸が垂直軸
  • horizontal - x 軸が垂直軸
3Dいいえfalse

3 次元で表示します。area、bar、および line チャートに適用されます。

stackedいいえfalse積み重ね値。area、bar チャートに適用されます。
showShapesいいえtrueline チャートに適用されます。各データの位置に図形が表示されます。
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 の) title 属性です。
dataOrientation いいえhorizontal

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

利用可能な値:

  • vertical  - データ表の列が系列と解釈されます。
  • horizontal – データ表の行が系列と解釈されます。
timeSeries いいえfalse

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

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

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

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

languageいいえ(なし)

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

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

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

利用可能な値:

  • true - マクロは、既定の形式またはユーザ指定の表示形式に完全に一致しない数値および日付の値の変換を試みます。
  • false — マクロは厳密なデータ形式を適用します。データ形式エラーが生じると、グラフは作成されません。

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

色は、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いいえ(なし)

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

利用可能な値:

  • up45 - 45 度上向き
  • up90 - 90 度上向き
  • down45 - 45 度下向き
  • down90 - 90 度下向き
dateTickMarkPositionいいえ start

日付の目盛りの位置。

利用可能な値:

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

Pie チャートのパラメーター

パラメーター必須既定説明
pieSectionLabelいいえ円グラフのセクションのキー値のみを表示円グラフのセクション ラベルの表示形式。表示形式には、特別な置換変数の文字列が使用されます。
  • %0% は円グラフ セクションのキーで置換されます。
  • %1% は円グラフ セクションの数値で置換されます。
  • %2% は円グラフ セクションのパーセント値で置換されます。

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

%0% = %1%


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

%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いいえ(なし)

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

このパラメータで利用可能な構文は次のとおりです。

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

保存されたチャートのバージョン管理方法を定義します。

利用可能な値:

  • new — 新しいバージョンの添付ファイルを作成します。
  • replace — replaces all previous versions of the chart. To replace an existing attachment, the user must be authorised to remove attachments for the page specified.
  • keep — 同じ名前の既存のエクスポートが存在しない場合にのみ、新しい添付ファイルを保存します。既存の添付ファイルが変更または更新されることはありません。
attachmentCommentいいえ(なし) 保存されたチャート添付ファイルに使用されるコメント。
thumbnailいいえfalse

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

  • ラベルなし