圖表元件

您可以使用標籤及屬性來變更報告範本中的圖表元件。圖表元件為 fp:cells、fp:chart 及 fp:prioritylist。

fp:cells

fp:cells 元件會在表格中顯示兩個以上的 fp:chart 標籤。此元件使用共同屬性及一個必要屬性:cols。cols 屬性可決定欄數及其大小。cols 的預設值是 false。

fp:cells 標籤必須包含零個以上的標籤,且標籤數必須是 cols 屬性所指定之欄數的倍數。例如,如果您有三個直欄,標籤數就必須是三的倍數。

在本範例中,表格有三個直欄,中間直欄的寬度大於其他直欄。
<fp:cells cols="30,40,30"
	<fp:chart ...	 />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
/>

fp:chart

fp:chart 元件會顯示一個圖表,此圖表會顯示一個以上的準則與一個以上成員的優先順序。此元件有共同屬性。fp:chart 元件使用共同標籤及下表中的標籤。
表 1. fp:chart 標籤
標籤 說明 屬性 範例
chartType chartType 類型的必要標籤,可決定圖表類型,例如長條圖或 XY 圖表。
  • changeable:必要屬性,可決定可於何時變更值。此屬性的作用與 fp:*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="圖表類型"
	defaultvalue="bar"
/>
  pwcDomain 標籤指定顯示在圖表中的「準則-成員」值組。這些標籤都屬於 pwcDomain 類型。您必須使用至少一個 pwcDomain 標籤。所需的 pwcDomain 標籤集由圖表類型決定:
  • X:bar 圖表類型的標籤;指定 X 軸上的「準則-成員」值組
  • 無名稱:stackedbar 圖表類型的標籤。您可以使用任何數目的 pwcDomain 標籤。
  • X Y:xy 圖表類型的標籤。X 代表 X 軸上的「準則-成員」值組。Y 代表 Y 軸上的「準則-成員」值組。
  • 不適用:stackedxy 圖表類型的標籤。不會使用 pwcDomains。
  • X [Y]:pie 圖表類型的標籤。X 代表使用圓形區塊的「準則-成員」值組。[Y] 代表使用高度的「準則-成員」值組。如果沒有設定 [Y],則所有元素的高度都相同。
  • 無名稱:radar 圖表類型的標籤。可使用任意數目的 pwcDomain 標籤,且其名稱不具重要性。
  • changeable:必要屬性,可決定可於何時變更值。此屬性的作用與 fp:*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="X 軸"
		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:必要屬性,可決定可於何時變更值。此屬性的作用與 fp:*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="圖表大小"
	defaultvalue="small"
/>
chartSorting chartSorting 類型的選用標籤,可決定圖表中的排序。此標籤僅適用於長條圖與堆疊長條圖。
  • changeable:必要屬性,可決定可於何時變更值。此屬性的作用與 fp:*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="排序"
	defaultvalue="bestatbottom"
/>
disagree checkboxParam 類型的選用標籤,可決定是否要在圖表中顯示偏離。此標籤僅適用於堆疊長條圖。預設值是 false(無偏離指示器)。    
prefix checkboxParam 類型的選用標籤,可決定是否要在圖表中顯示字首。預設值是 true。    
title checkboxParam 類型的選用標籤,可決定是否要在圖表中顯示標題。預設值是 true。    
<fp:chart descr="圖表" id="430">
	<fp:viewParam
		name="viewId"
		descr="包含元素的視圖"
		changeable="template"
		id="1"
	/>
	<fp:chartType
		name="chartType"
		descr="圖表類型"
		changeable="template"
		id="2"
		defaultvalue="xy"
	/>
	<fp:chartSize
		name="chartSize"
		descr="圖表大小"
		changeable="template"
		id="3"
		defaultvalue="small"
	/>
	<fp:chartSorting
		name="chartSorting"
		descr="排序"
		changeable="template"
		id="4"
		charttypeid="2"
		defaultvalue="bestattop"
	/>
	<fp:checkboxParam
		name="allMembers"
		descr="使用所有成員的優先順序設定"
		changeable="template"
		defaultvalue="false"
		id="5"
	/>
	<fp:checkboxParam
		name="disagree"
		descr="顯示堆疊長條中的偏離"
		changeable="template"
		defaultvalue="false"
		id="6"
	/>
	<fp:checkboxParam
		name="prefix"
		descr="顯示元素字首"
		changeable="template"
		defaultvalue="false"
		id="7"
	/>
	<fp:checkboxParam
		name="title"
		descr="顯示元素標題"
		changeable="template"
		defaultvalue="true"
		id="8"
	/>
	<fp:pwcDomain
		name="x"
		descr="X 軸"
		changeable="template"
		id="9"
		charttypeid="2"
		masterid="1"
		allmembersid="5"
	/>
	<fp:pwcDomain
		name="y"
		descr="Y 軸"
		changeable="template"
		id="10"
		charttypeid="2"
		masterid="1"
		allmembersid="5"
	/>
	<fp:pwcDomain
		name="z"
		descr="Z 軸"
		changeable="template"
		id="11"
		charttypeid="2"
		masterid="1"
		allmembersid="5"
	/>
</fp:chart>

fp:prioritylist

fp:prioritylist 元件會顯示表格而非圖表中的優先順序。優先順序清單包含與此視圖相關聯的所有準則。

fp:priority 清單元件使用共同屬性及共同標籤,還使用一個必要標籤:viewId。viewId 標籤屬於 viewParam 類型,並且包含視圖 ID。

<fp:prioritylist descr="優先順序清單" id="430">
	<fp:viewParam
			name="viewId"
			descr="包含元素的視圖"
			changeable="template"
			id="1"
/>
</fp:prioritylist>

建議與意見