グラフ・コンポーネント

タグおよび属性を使用して、レポート・テンプレートのグラフ・コンポーネントを変更できます。 グラフ・コンポーネントは、fp:cells、fp:chart、および fp:prioritylist のいずれかです。

fp:cells

fp:cells コンポーネントは表に複数の fp:chart タグを表示します。コンポーネントは、共通属性と、1 つの必須属性 cols を使用します。 cols 属性により、列の数とサイズが決まります。cols のデフォルト値は false です。

fp:cells タグには、ゼロ個を上回る数のタグを組み込む必要があります。タグの数は、cols 属性で指定する列の数の倍数でなければなりません。例えば 3 つの列がある場合、タグ数は 3 の倍数でなければなりません。

次の例では、テーブルには 3 つの列があり、中央の列は他の列よりも幅が大きくなっています。
<fp:cells cols="30,40,30"
	<fp:chart ...	 />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
/>

fp:chart

fp:chart コンポーネントは、1 つ以上の基準と 1 人以上のメンバーの優先度を示すチャートを表示します。このコンポーネントには共通属性があります。fp:chart コンポーネントは、共通タグと、下の表のタグを使用します。
表 1. fp:chart タグ
タグ 説明 属性
chartType 棒グラフや XY グラフなどのグラフ・タイプを指定するためのタイプ chartType の必須タグ。
  • changeable: 値を変更できる状況を指定するための必須属性。この属性は、*Param タグの changeable 属性と同じ動作になります。
  • id: タグの ID を指定するための必須属性。
  • name: タグの名前を指定するための必須属性。名前は "chartSorting" にする必要があります。
  • descr: chartSize タグの説明を記述するためのオプション属性。 レポート・タイプの作成時や編集時、またはレポートの生成時に、この説明が表示されます。 デフォルト値は "" (説明なし) です。
  • defaultvalue: オプション属性。以下のいずれかの値に設定できます。
    • bar: 棒グラフ (デフォルト値)
    • stackedbar: 積み重ね棒グラフ
    • xy: XY グラフ
    • stackedxy: 積み重ね XY グラフ
    • pie: 円グラフ
    • radar: レーダー・チャート
<fp:chartType
	changeable="template"
	id="2"
	name="chartType"
	descr="Type of chart"
	defaultvalue="bar"
/>
  pwcDomain タグは、グラフに表示される基準-メンバーの組を指定します。 これらのタグのタイプは pwcDomain です。 少なくとも 1 つの pwcDomain タグを使用する必要があります。 必要な pwcDomain タグのセットは、グラフ・タイプによって異なります。
  • X: X 軸で基準とメンバーの組を指定するための棒グラフ・タイプのタグ。
  • no name: 積み重ね棒グラフ・タイプのタグ。pwcDomain タグはいくつでも使用できます。
  • X Y: xy グラフ・タイプのタグ。X は、X 軸の基準とメンバーの組を表します。 Y は、Y 軸の基準とメンバーの組を表します。
  • not applicable: 積み重ね xy グラフ・タイプのタグ。pwcDomain を使用しません。
  • X [Y]: 円グラフ・タイプのタグ。X は、円のセクターを使用する基準とメンバーの組を表します。 [Y] は、高さを使用する基準とメンバーの組を表します。 [Y] が設定されていない場合、高さはすべてのエレメントで同じです。
  • no name: レーダー・チャート・タイプのタグ。任意の数の pwcDomain タグを使用できます。タグの名前は適当でかまいません。
  • changeable: 値を変更できる状況を指定するための必須属性。この属性は、*Param タグの changeable 属性と同じ動作になります。
  • charttypeid: chartType タグの ID を指定するための必須属性。ユーザー・インターフェースは、chartType タグの値に基づいて、chartSorting タグを表示するかどうかを決めます。
  • id: タグの ID を指定するための必須属性。
  • masterid: このパラメーターを制御する viewParam の ID を指定するための必須属性。ユーザー・インターフェースでは、マスター viewParam を最初に設定する必要があります。 設定しないと、どの基準が使用可能かが分かりません。
  • name: タグの名前を指定するための必須属性。名前は "chartSorting" にする必要があります。
  • allmembersid: allMembers checkboxParam タグの ID を指定するためのオプション属性。
  • descr: pwcDomain タグの説明を記述するためのオプション属性。 レポート・タイプの作成時や編集時、またはレポートの生成時に、この説明が表示されます。デフォルト値は "" (説明なし) です。
<fp:pwcDomain
		changeable="template"
		charttypeid="2"
		id="9"
		masterid="1"
		name="x"
		descr="The X axis"
		allmembersid="99"
/>
viewId タイプ viewParam の必須タグ。ビュー ID が含まれます。    
fp:chartfilter クイック・レポートとして生成された積み重ね XY グラフと積み重ね棒グラフでは、X、Y、セクターの選択項目が画面で使用されます。デフォルトの場合、通常のレポートでは X、Y、およびセクターのチェック・ボックスがすべて選択されます。 通常のレポートで fp:chartfilter タグを使用すれば、選択状態になるチェック・ボックスのセットを変更できます。以下のいずれかの方法で、タグの値を見つけることができます。
  • データベースのログ・レベルを注意に設定します。
  • 選択状態にするチェック・ボックスのセットを組み込んだクイック・レポートを生成します。
  • ログ・ファイルから fp:chartfilter の値をコピーします。
 
<fp:chart ...>
...
<fp:chartfilter name="x" value="16/10" />
<fp:chartfilter name="y" value="162" />
<fp:chartfilter name="z" value="162,16/10"/>
...
</fp:chart>
allMembers 組み込む優先度 (すべてのメンバーの優先度または現在ログインしているメンバーの優先度) を決定する、タイプ checkboxParam のオプション・タグ。 デフォルト値は false (現在のメンバーの優先度のみを組み込む) です。    
chartSize チャートのサイズを指定するためのタイプ chartSize のオプション・タグ。
  • changeable: 値を変更できる状況を指定するための必須属性。この属性は、*Param タグの changeable 属性と同じ動作になります。
  • id: タグの ID を指定するための必須属性。
  • name: タグの名前を指定するための必須属性。タグの名前は "chartSize" にする必要があります。
  • descr: chartSize タグの説明を記述するためのオプション属性。 レポート・タイプの作成時や編集時、またはレポートの生成時に、この説明が表示されます。デフォルト値は "" (説明なし) です。
  • defaultvalue: オプション属性。この属性は、以下のいずれかの値に設定できます。
    • extra_small
    • small
    • normal (デフォルト値)
    • large
    • extra_large
<fp:chartSize
	changeable="template"
	id="3"
	name="chartSize"
	descr="Size of chart"
	defaultvalue="small"
/>
chartSorting チャートのソート順を指定するためのタイプ chartSorting のオプション・タグ。このタグは、棒グラフまたは積み重ね棒グラフにのみ適用可能です。
  • changeable: 値を変更できる状況を指定するための必須属性。この属性は、*Param タグの changeable 属性と同じ動作になります。
  • charttypeid: chartType タグの ID を指定するための必須属性。ユーザー・インターフェースは、chartType タグの値に基づいて、chartSorting タグを表示するかどうかを決めます。
  • id: タグの ID を指定するための必須属性。
  • name: タグの名前を指定するための必須属性。この属性は "chartSorting" に設定する必要があります。
  • descr: chartSorting タグの説明を記述するためのオプション属性。 レポート・タイプの作成時や編集時、またはレポートの生成時に、この説明が表示されます。デフォルト値は "" (説明なし) です。
  • defaultvalue: オプション属性。以下のいずれかの値に設定できます。
    • original: ツリー内のエレメントの順序。
    • bestattop: 最高のエレメントを最初に表示します (デフォルト値)。
    • bestatbottom: 最高のエレメントを最後に表示します。
<fp:chartSorting
	changeable="template"
	charttypeid="2"
	id="4"
	name="chartSorting"
	descr="Sorting"
	defaultvalue="bestatbottom"
/>
disagree チャートで不一致を表示するかどうかを指定するためのタイプ checkboxParam のオプション・タグ。このタグは、積み重ね棒グラフにのみ適用可能です。 デフォルト値は false (不一致を表示しないことを示す標識) です。    
prefix チャートで接頭部を表示するかどうかを指定するためのタイプ checkboxParam のオプション・タグ。デフォルト値は true です。    
title チャートでタイトルを表示するかどうかを指定するためのタイプ checkboxParam のオプション・タグ。デフォルト値は true です。    
<fp:chart descr="A chart" id="430">
	<fp:viewParam
		name="viewId"
		descr="The view that contains the elements"
		changeable="template"
		id="1"
	/>
	<fp:chartType
		name="chartType"
		descr="Type of chart"
		changeable="template"
		id="2"
		defaultvalue="xy"
	/>
	<fp:chartSize
		name="chartSize"
		descr="Size of chart"
		changeable="template"
		id="3"
		defaultvalue="small"
	/>
	<fp:chartSorting
		name="chartSorting"
		descr="Sorting"
		changeable="template"
		id="4"
		charttypeid="2"
		defaultvalue="bestattop"
	/>
	<fp:checkboxParam
		name="allMembers"
		descr="Use all members' prioritizations"
		changeable="template"
		defaultvalue="false"
		id="5"
	/>
	<fp:checkboxParam
		name="disagree"
		descr="Show disagreement in stacked bar"
		changeable="template"
		defaultvalue="false"
		id="6"
	/>
	<fp:checkboxParam
		name="prefix"
		descr="Show element prefix"
		changeable="template"
		defaultvalue="false"
		id="7"
	/>
	<fp:checkboxParam
		name="title"
		descr="Show element titles"
		changeable="template"
		defaultvalue="true"
		id="8"
	/>
	<fp:pwcDomain
		name="x"
		descr="X axis"
		changeable="template"
		id="9"
		charttypeid="2"
		masterid="1"
		allmembersid="5"
	/>
	<fp:pwcDomain
		name="y"
		descr="Y axis"
		changeable="template"
		id="10"
		charttypeid="2"
		masterid="1"
		allmembersid="5"
	/>
	<fp:pwcDomain
		name="z"
		descr="Z axis"
		changeable="template"
		id="11"
		charttypeid="2"
		masterid="1"
		allmembersid="5"
	/>
</fp:chart>

fp:prioritylist

fp:prioritylist コンポーネントは、チャートではなく表で優先度を表示します。優先度リストには、ビューに関連したすべての基準が組み込まれます。

fp:priority リスト・コンポーネントは、共通属性および共通タグを使用し、1 つの必須タグ viewId も使用します。 viewId タグは、タイプが viewParam であり、ビュー ID を含んでいます。

<fp:prioritylist descr="A priority list" id="430">
	<fp:viewParam
			name="viewId"
			descr="The view that contains the elements"
			changeable="template"
			id="1"
/>
</fp:prioritylist>

フィードバック