Managing products and portfolios : Setting up and generating reports workflow : Report templates : Chart components : fp:chart
  
fp:chart
The fp:chart component presents a chart that displays the priorities for one or more criteria and one or more members. This component has the common attributes. The fp:chart component uses the common tags and the tags in the following table.
chartType
A mandatory tag of type chartType that determines the chart type, such as a bar chart or an XY chart.
 
Attribute
Description
changeable
A mandatory attribute that determines when the value can be changed. This attribute works the same way as the changeable attribute for fp:*Param tags.
id
A mandatory attribute that specifies the ID of the tag.
name
A mandatory attribute that specifies the name of the tag. The name must be "chartSorting".
descr
An optional attribute that describes the chartSize tag. The description is displayed when the report type is created or edited, or when the report is generated. The default value is "" (no description).
defaultvalue
An optional attribute; set to one of these values:
▪ bar: A bar chart (the default value)
▪ stackedbar: A stacked bar chart
▪ xy: An XY chart
▪ stackedxy: A stacked XY chart
▪ pie: A pie chart
▪ radar: A radar chart
Example
<fp:chartType changeable="template" id="2"
name="chartType" descr="Type of chart" defaultvalue="bar" />
pwcDomain
The pwcDomain tags specify the criterion-member tuples that are displayed in a chart. These tags are of type pwcDomain. You must use at least one pwcDomain tag. The set of pwcDomain tags needed is determined by the chart type:
 
Tag
Chart type
Descriptopm
X
bar
Specifies the criterion-member tuple on the X axis
no name
stackedbar
You can use any number of pwcDomain tags.
X Y
xy
X represents the criterion-member tuple on the X axis. Y represents the criterion-member tuple on the Y axis.
not applicable
stackedxy
The pwcDomains are not used.
X [Y]
pie
X represents the criterion-member tuple that uses the circle sector. [Y] represents the criterion-member tuple that uses the height. If [Y] is not set, the height is same for all elements.
no name
radar
Any number of pwcDomain tags can be used, and their names do not matter.
Attribute
Description
changeable
Mandatory
Determines when the value can be changed. This attribute works the same way as the changeable attribute for fp:*Param tags.
charttypeid
Mandatory
Specifies the ID of the chartType tag. The user interface uses the chartType tag value to determine whether the chartSorting tag is displayed.
id
Mandatory
Specifies the ID of the tag.
masterid
Mandatory
Specifies the ID for the viewParam that controls this parameter. In the user interface, you must set the master viewParam first, or you cannot know which criteria are available.
name
Mandatory
Specifies the name of the tag. The name must be "chartSorting".
allmembersid
Optional
Specifies the ID of the allMembers checkboxParam tag.
descr
Optional
Describes the pwcDomain tag. The description is displayed when the report type is created or edited or when the report is generated. The default value is "" (no description)
Example
<fp:pwcDomain changeable="template" charttypeid="2" id="9"
masterid="1" name="x" descr="The X axis" allmembersid="99" />
viewId
A mandatory tag of type viewParam that contains a view ID.
fp:chartfilter
Stacked XY charts and stacked bar charts that are generated as quick reports use the X, Y, and sector selections on screen. By default, the normal reports select all X, Y, and sector check boxes. By using fp:chartfilter tags, you can change the set of selected check boxes for normal reports. You can find the values of the tags in one of the following ways:
▪ Set the database loglevel to notice.
▪ Generate a quick report that has the set of selected check boxes that you want.
▪ Copy the fp:chartfilter values from log file.
Example
<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
An optional tag of type checkboxParam that determines which priorities are included: all members’ priorities or the currently logged in member's priorities.
The default value is “false” (that is, only the current member's priorities are included).
chartSize
An optional tag of type chartSize that determines the size of the chart.
 
Attribute
Description
changeable
Mandatory
Determines when the value can be changed. This attribute works the same way as the changeable attribute for fp:*Param tags.
id
Mandatory
Specifies the ID of the tag.
name
Mandatory
Specifies the name of the tag. The name of the tag must be "chartSize".
descr
Optional
Describes the chartSize tag. The description is displayed when the report type is created or edited or when the report is generated. The default value is "" (no description).
defaultvalue
Optional
Set to one of the following values:
▪ extra_small
▪ small
▪ normal (default value)
▪ large
▪ extra_large
Example
<fp:chartSize changeable="template" id="3" name="chartSize" descr="Size of chart" defaultvalue="small" />
chartSorting
An optional tag of type chartSorting that determines the sort order in the chart. This tag is applicable for bar charts and stacked bar charts only.
 
Attribute
Requirement
Description
changeable
Mandatory
Determines when the value can be changed.
This attribute works the same way as the changeable attribute for fp:*Param tags.
charttypeid
Mandatory
Specifies the ID of the chartType tag.
The user interface uses the chartType tag value to determine whether the chartSorting tag is displayed.
id
Mandatory
Specifies the ID of the tag.
name
Mandatory
Specifies the name of the tag.
This attribute must be set to "chartSorting".
descr
Optional
Describes the chartSorting tag. The description is displayed when the report type is created or edited or when the report is generated.
The default value is "" (no description).
defaultvalue
Optional
Set to one of the following values:
▪ original: The order of the elements in a tree
▪ bestattop: The best element first (default value)
▪ bestatbottom: The best element last
Example
<fp:chartSorting changeable="template" charttypeid="2" id="4" name="chartSorting" descr="Sorting" defaultvalue="bestatbottom" />
disagree
An optional tag of type checkboxParam that determines whether disagreement is presented in a chart. This tag is applicable to stacked bar charts only.
The default value is false (no disagreement indicator).
prefix
An optional tag of type checkboxParam that determines whether prefixes are presented in the chart.
The default value is true.
title
An optional tag of type checkboxParam that determines whether titles are presented in the chart.
The default value is true.
Example of the fp:chart component
<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>
See also
Chart components