Bar-Graph
説明
グラフにする数値データが含まれている Info*Engine グループを入力として取得し、JPEG イメージを出力として生成します。
構文
<ie:webject name="Bar-Graph" type="IMG">
<ie:param name="BACKDROP_COLOR " data="html_color"/>
<ie:param name="BACKGROUND_COLOR " data="html_color"/>
<ie:param name="COLOR " data="html_color"/>
<ie:param name="DECIMAL_PLACES" data="integer_places"/>
<ie:param name="GRAPH" data="column_name"/>
<ie:param name="GROUP_IN" data="input_groupname"/>
<ie:param name="HEIGHT" data="integer_height"/>
<ie:param name="INSET_BOTTOM" data="integer_inset"/>
<ie:param name="INSET_LEFT" data="integer_inset"/>
<ie:param name="INSET_RIGHT" data="integer_inset"/>
<ie:param name="INSET_TOP" data="integer_inset"/>
<ie:param name="INSETS" data="integer_inset"/>
<ie:param name="LABEL" data="column_name"/>
<ie:param name="LABEL_ANGLE" data="integer_angle"/>
<ie:param name="SCALE_INCREMENT" data="double"/>
<ie:param name="TEXT_COLOR " data="html_color"/>
<ie:param name="WIDTH" data="integer_width"/>
</ie:webject>
<ie:param name="BACKDROP_COLOR " data="html_color"/>
<ie:param name="BACKGROUND_COLOR " data="html_color"/>
<ie:param name="COLOR " data="html_color"/>
<ie:param name="DECIMAL_PLACES" data="integer_places"/>
<ie:param name="GRAPH" data="column_name"/>
<ie:param name="GROUP_IN" data="input_groupname"/>
<ie:param name="HEIGHT" data="integer_height"/>
<ie:param name="INSET_BOTTOM" data="integer_inset"/>
<ie:param name="INSET_LEFT" data="integer_inset"/>
<ie:param name="INSET_RIGHT" data="integer_inset"/>
<ie:param name="INSET_TOP" data="integer_inset"/>
<ie:param name="INSETS" data="integer_inset"/>
<ie:param name="LABEL" data="column_name"/>
<ie:param name="LABEL_ANGLE" data="integer_angle"/>
<ie:param name="SCALE_INCREMENT" data="double"/>
<ie:param name="TEXT_COLOR " data="html_color"/>
<ie:param name="WIDTH" data="integer_width"/>
</ie:webject>
パラメータ
|
必須
|
選択
|
オプション
|
|---|---|---|
|
GRAPH
|
BACKDROP_COLOR
|
|
|
GROUP_IN
|
BACKGROUND_COLOR
|
|
|
COLOR
|
||
|
DECIMAL_PLACES
|
||
|
HEIGHT
|
||
|
INSET_BOTTOM
|
||
|
INSET_LEFT
|
||
|
INSET_RIGHT
|
||
|
INSET_TOP
|
||
|
INSETS
|
||
|
LABEL
|
||
|
LABEL_ANGLE
|
||
|
SCALE_INCREMENT
|
||
|
TEXT_COLOR
|
||
|
WIDTH
|
BACKDROP_COLOR
生成されるイメージのバックドロップに使用される色を #RRGGBB フォーマットで指定します。デフォルト値は lightGray (#868686) です。
BACKGROUND_COLOR
生成されるイメージの背景に使用される色を #RRGGBB フォーマットで指定します。デフォルト値は white です。
COLOR
生成されるバーのレンダリングに使用される色を #RRGGBB フォーマットで指定します。このパラメータには複数の値を指定できます。複数の値を指定した場合、指定した色が順番に使用され、入力グループ内のデータがすべてグラフに表示されるまで、すべての値に作業版数が適用されます。たとえば、色パラメータを 2 つ指定するには以下のようにします。
<ie:param name="COLOR" data="#FF0000,#0000FF" delim=","/>
その結果、赤と青が交互に表示されます。
オプションとして、各入力グループに "COLOR" という名前の列を含め、各入力グループのデータ点に使用する色を指定できます。COLOR パラメータは、入力グループに含まれているデータをオーバーライドします。
デフォルト値は #0000C8 です。
DECIMAL_PLACES
目盛りに表示される小数点以下の桁数を決定する整数を指定します。SCALE_INCREMENT の値が指定されていない場合、このパラメータは無視されます。デフォルト値は 0 です。
GRAPH
グラフにするデータが含まれている列の名前を指定します。
GROUP_IN
グラフにするデータが含まれている入力グループの名前を指定します。
HEIGHT
生成されるイメージの高さを整数で指定します。デフォルト値は 400 です。
INSET_BOTTOM
イメージの下部を埋めるための値を整数で指定します。デフォルト値は 10 です。
INSET_LEFT
イメージの左側を埋めるための値を整数で指定します。デフォルト値は 10 です。
INSET_RIGHT
イメージの右側を埋めるための値を整数で指定します。デフォルト値は 10 です。
INSET_TOP
イメージの上部を埋めるための値を整数で指定します。デフォルト値は 10 です。
INSETS
イメージの外側を埋めるための値を整数で指定します。このパラメータを指定すると、既存の INSET_LEFT、INSET_RIGHT、INSET_TOP および INSET_BOTTOM がオーバーライドされます。デフォルト値は 10 です。
LABEL
生成されるバーのラベルに使用する文字列が含まれている列の名前を指定します。デフォルトでは、ラベルは表示されません。
LABEL_ANGLE
ラベルの表示角度を整数で指定します。これは、1 つまたは複数のラベルが特別に長い場合にラベルが重なり合うのを防ぐために使用できます。デフォルト値は 0 です。
SCALE_INCREMENT
Y 軸の目盛りの表示方法を制御する浮動小数点値を指定します。値を指定すると、0 からグラフの最大のデータ点まで、SCALE_INCREMENT ごとに目盛りが表示されます。デフォルトでは、目盛りは表示されません。
TEXT_COLOR
生成されるイメージ内のテキストに使用される色を #RRGGBB フォーマットで指定します。デフォルト値は黒です。
WIDTH
生成されるイメージの幅を整数で指定します。デフォルト値は 600 です。
例
以下の入力データが指定されています (GROUP_IN の Employees)。
|
名前
|
営業
|
|---|---|
|
joe
|
7000
|
|
fred
|
5000
|
|
king
|
15000
|
|
bill
|
2500
|
|
frank
|
7500
|
以下の JSP を適用します。
<%@page language="java" session="true"
contentType="image/jpeg"
%><%@taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"
%><ie:webject name="Bar-Graph" type="IMG">
<ie:param name="GROUP_IN" data="Employees"/>
<ie:param name="COLOR" data="#5B5B97,#AAAAAA" delim=","/>
<ie:param name="GRAPH" data="SAL"/>
<ie:param name="WIDTH" data="300"/>
<ie:param name="HEIGHT" data="200"/>
<ie:param name="SCALE_INCREMENT" data="2000"/>
<ie:param name="LABEL" data="NAME"/>
<ie:param name="INSET_LEFT" data="20"/>
</ie:webject>
contentType="image/jpeg"
%><%@taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"
%><ie:webject name="Bar-Graph" type="IMG">
<ie:param name="GROUP_IN" data="Employees"/>
<ie:param name="COLOR" data="#5B5B97,#AAAAAA" delim=","/>
<ie:param name="GRAPH" data="SAL"/>
<ie:param name="WIDTH" data="300"/>
<ie:param name="HEIGHT" data="200"/>
<ie:param name="SCALE_INCREMENT" data="2000"/>
<ie:param name="LABEL" data="NAME"/>
<ie:param name="INSET_LEFT" data="20"/>
</ie:webject>
以下のイメージが生成されます。
