Komponenty wykresu

Aby zmienić komponenty wykresów w szablonie raportu, można użyć znaczników i atrybutów. Komponenty wykresów to fp:cells, fp:chart i fp:prioritylist.

fp:cells

Komponent fp:cells wyświetla co najmniej dwa znaczniki fp:chart w tabeli. Komponent ten korzysta ze wspólnych atrybutów i jednego obowiązkowego atrybutu cols. Atrybut cols określa liczbę kolumn i ich wielkość. Wartością domyślną atrybutu cols jest false.

Znacznik fp:cells musi zawierać co najmniej jeden znacznik, a liczba znaczników musi być wielokrotnością liczby kolumn określonej w atrybucie cols. Jeśli na przykład w tabeli są trzy kolumny, liczba znaczników musi być wielokrotnością trójki.

W tym przykładzie tabela ma trzy kolumny, przy czym środkowa jest szersza od pozostałych.
<fp:cells cols="30,40,30"
	<fp:chart ...	 />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
	<fp:chart ... />
/>

fp:chart

Komponent fp:chart wyświetla wykres ilustrujący priorytety dla co najmniej jednego kryterium oraz co najmniej jednego członka. Ten komponent ma atrybuty wspólne. Komponent fp:chart korzysta ze wspólnych znaczników oraz znaczników z następującej tabeli.
Tabela 1. Znaczniki komponentu fp:chart
Znacznik Opis Atrybuty Przykład
chartType Obowiązkowy znacznik typu chartType określający typ wykresu, na przykład wykres słupkowy lub wykres XY.
  • changeable: obowiązkowy atrybut określający, kiedy zmiana wartości jest możliwa. Ten atrybut działa tak samo jak atrybut changeable znaczników fp:*Param.
  • id: obowiązkowy atrybut określający identyfikator znacznika.
  • name: obowiązkowy atrybut określający nazwę znacznika. Nazwa musi mieć wartość chartSorting.
  • descr: opcjonalny atrybut opisujący znacznik chartSize. Opis jest wyświetlany podczas tworzenia lub edytowania typu raportu bądź podczas generowania raportu. Wartość domyślna to "" (brak opisu).
  • defaultvalue: opcjonalny atrybut, dla którego można ustawić jedną z następujących wartości:
    • bar: wykres słupkowy (wartość domyślna)
    • stackedbar: skumulowany wykres słupkowy
    • xy: wykres XY
    • stackedxy: skumulowany wykres XY
    • pie: wykres kołowy
    • radar: wykres radarowy
<fp:chartType
	changeable="template"
	id="2"
	name="chartType"
	descr="Type of chart"
	defaultvalue="bar"
/>
  Znaczniki pwcDomain określają krotki kryterium-członek wyświetlane na wykresie. Znaczniki te są typu pwcDomain. Należy użyć co najmniej jednego znacznika pwcDomain. Zestaw niezbędnych znaczników pwcDomain określa typ wykresu:
  • X: znacznik typu wykresu słupkowego określający krotkę kryterium-członek na osi X.
  • no name: znacznik typu skumulowanego wykresu słupkowego. Użyć można dowolnej liczby znaczników pwcDomain.
  • X Y: znacznik typu wykresu XY. Wartość X reprezentuje krotkę kryterium-członek na osi X. Wartość Y reprezentuje krotkę kryterium-członek na osi Y.
  • not applicable: znacznik typu skumulowanego wykresu XY. Znaczniki pwcDomain nie są używane.
  • X [Y]: znacznik typu wykresu kołowego. Wartość X reprezentuje krotkę kryterium-członek używającą sektora koła. Wartość [Y] reprezentuje krotkę kryterium-członek używającą wysokości. Jeśli nie ustawiono wartości [Y], wysokość jest taka sama dla wszystkich składników.
  • no name: znacznik typu wykresu radarowego. Można użyć dowolnej liczby znaczników pwcDomain, a ich nazwy nie mają znaczenia.
  • changeable: obowiązkowy atrybut określający, kiedy zmiana wartości jest możliwa. Ten atrybut działa tak samo jak atrybut changeable znaczników fp:*Param.
  • charttypeid: obowiązkowy atrybut określający identyfikator znacznika chartType. Interfejs użytkownika korzysta z wartości znacznika chartType w celu określenia, czy znacznik chartSorting jest wyświetlany.
  • id: obowiązkowy atrybut określający identyfikator znacznika.
  • masterid: obowiązkowy atrybut określający identyfikator znacznika viewParam, który steruje tym parametrem. W interfejsie użytkownika należy najpierw ustawić główny parametr viewParam. W przeciwnym razie nie będzie wiadomo, które kryteria są dostępne.
  • name: obowiązkowy atrybut określający nazwę znacznika. Nazwa musi mieć wartość chartSorting.
  • allmembersid: opcjonalny atrybut określający identyfikator znacznika allMembers checkboxParam.
  • descr: opcjonalny atrybut opisujący znacznik pwcDomain. Opis jest wyświetlany podczas tworzenia lub edytowania typu raportu bądź podczas generowania raportu. Wartość domyślna to "" (brak opisu).
<fp:pwcDomain
		changeable="template"
		charttypeid="2"
		id="9"
		masterid="1"
		name="x"
		descr="The X axis"
		allmembersid="99"
/>
viewId Obowiązkowy znacznik typu viewParam zawierający identyfikator widoku.    
fp:chartfilter Skumulowane wykresy XY i skumulowane wykresy słupkowe generowane jako szybkie raporty korzystają z zaznaczonych wartości X i Y oraz sektorów wyświetlanych na ekranie. Domyślnie w normalnych raportach zaznaczone są wszystkie pola wyboru dla wartości X i Y oraz sektorów. Znaczniki fp:chartfilter umożliwiają zmianę zestawu zaznaczanych pól wyboru dla normalnych raportów. Wartości znaczników można określić w jeden z następujących sposobów:
  • Ustawienie atrybutu loglevel bazy danych na wartość notice.
  • Wygenerowanie szybkiego raportu zawierającego żądany zestaw zaznaczonych pól wyboru.
  • Skopiowanie wartości znacznika fp:chartfilter z pliku dziennika.
 
<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 Opcjonalny znacznik typu checkboxParam określający, które priorytety są uwzględniane: wszystkich członków czy tylko aktualnie zalogowanego członka. Wartością domyślną jest false (uwzględniane są tylko priorytety bieżącego członka).    
chartSize Opcjonalny znacznik typu chartSize określający wielkość wykresu.
  • changeable: obowiązkowy atrybut określający, kiedy zmiana wartości jest możliwa. Ten atrybut działa tak samo jak atrybut changeable znaczników fp:*Param.
  • id: obowiązkowy atrybut określający identyfikator znacznika.
  • name: obowiązkowy atrybut określający nazwę znacznika. Nazwa znacznika musi mieć wartość chartSize.
  • descr: opcjonalny atrybut opisujący znacznik chartSize. Opis jest wyświetlany podczas tworzenia lub edytowania typu raportu bądź podczas generowania raportu. Wartość domyślna to "" (brak opisu).
  • defaultvalue: atrybut opcjonalny. Dla tego atrybutu można ustawić jedną z następujących wartości:
    • extra_small
    • small
    • normal (wartość domyślna)
    • large
    • extra_large
<fp:chartSize
	changeable="template"
	id="3"
	name="chartSize"
	descr="Size of chart"
	defaultvalue="small"
/>
chartSorting Opcjonalny znacznik typu chartSorting określający kolejność sortowania na wykresie. Ten znacznik dotyczy wyłącznie wykresów słupkowych i skumulowanych wykresów słupkowych.
  • changeable: obowiązkowy atrybut określający, kiedy zmiana wartości jest możliwa. Ten atrybut działa tak samo jak atrybut changeable znaczników fp:*Param.
  • charttypeid: obowiązkowy atrybut określający identyfikator znacznika chartType. Interfejs użytkownika korzysta z wartości znacznika chartType w celu określenia, czy znacznik chartSorting jest wyświetlany.
  • id: obowiązkowy atrybut określający identyfikator znacznika.
  • name: obowiązkowy atrybut określający nazwę znacznika. Atrybut ten musi mieć wartość chartSorting.
  • descr: opcjonalny atrybut opisujący znacznik chartSorting. Opis jest wyświetlany podczas tworzenia lub edytowania typu raportu bądź podczas generowania raportu. Wartość domyślna to "" (brak opisu).
  • defaultvalue: opcjonalny atrybut, dla którego można ustawić jedną z następujących wartości:
    • original: kolejność składników w drzewie.
    • bestattop: najlepszy składnik na początku (wartość domyślna).
    • bestatbottom: najlepszy składnik na końcu.
<fp:chartSorting
	changeable="template"
	charttypeid="2"
	id="4"
	name="chartSorting"
	descr="Sorting"
	defaultvalue="bestatbottom"
/>
disagree Opcjonalny znacznik typu checkboxParam określający, czy na wykresie wyświetlane są rozbieżności. Ten znacznik dotyczy wyłącznie skumulowanych wykresów słupkowych. Wartością domyślną jest false (brak indykatora rozbieżności).    
prefix Opcjonalny znacznik typu checkboxParam określający, czy na wykresie wyświetlane są przedrostki. Wartością domyślną jest true.    
title Opcjonalny znacznik typu checkboxParam określający, czy na wykresie wyświetlane są tytuły. Wartością domyślną jest 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

Komponent fp:prioritylist wyświetla priorytety w tabeli zamiast na wykresie. Lista priorytetów zawiera wszystkie kryteria powiązane z widokiem.

W komponencie listy fp:priority używane są wspólne atrybuty i wspólne znaczniki, a także obowiązkowy znacznik viewId. Znacznik viewId ma typ viewParam i zawiera identyfikator widoku.

<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>

Opinia