Report settings

You can use tags in the template to change your report settings. The tags can be used either once in a template or not at all. All tags are prefixed by fp:. The content of fp: tags is not translated. To create a report template in a different language, enter the information in the template in that language.
Table 1. Report setting tags
Tag Description Default value Example
Table margins
fp:margins Determines the page margins. The fp:margins tag has the following optional attributes:
  • top: Determines the top margin of the page.
  • bottom: Determines the bottom margin of the page.
  • left: Determines the left margin of the page.
  • right: Determines the right margin of the page.
The default value for all the attributes is 66.
<fp:margins
top="72"
bottom="72"
/>
Border thickness
fp:tableborder Determines the thickness of the outside border of the tables. 1
<fp:tableborder>true</fp:tableborder> <fp:cellborder>0.5</fp:cellborder>
<fp:headertableborder>false</fp:headertableborder> <fp:headercellborder>0.75</fp:headercellborder>
In the example, the table and cell borders use the default values. The table header does not have a border and the cell header border is thicker than the default value.
fp:cellborder Determines the thickness of the borders of cells in the tables. 0.5
fp:headertableborder Determines the thickness of the borders of the header and footer of a table. 1
fp:headercellborder Determines the thickness of the borders of headers and footers of cells in the tables. 0.5
Indication of calculated values
fp:indicatecalculatedvalues Determines whether the values that are calculated by using expressions must be indicated. If the value is true, all the calculated values are indicated with a (*). If the value is false or if the tag is not used, no values are indicated. false
<fp:indicatecalculatedvalues>true</indicatecalculatedvalues>
Text before links
fp:textbeforelinks

fp:textbeforeincominglinks

Specifies the text that is inserted before all link attribute values.

The fp:textbeforeincominglinks tag is used for incoming links attributes, and the fp:textbeforelinks tag is used for all other links. If the value for fp:textbeforeincominglinks is not specified, the fp:textbeforelinks value is used.

Empty string
<fp:textbeforelinks>Link to:</fp:textbeforelinks>
<fp:textbeforeincominglinks>Link from:</fp:textbeforeincominglinks>
In this example, the values for each attribute are as follows:

Link attribute value:

  • Link to: Element 1

Link list attribute values:

  • Link to: Element 1
  • Link to: Element 2

Incoming Links attribute values:

  • Link from: Element 1
  • Link from: Element 2
Formatting style
fp:defaultattrnamestyle Determines the default formatting style of the attribute names in trees. The available formats are bold, italic, underline, strikethrough, and hide.
The fp:defaultattrnamestyle tag is the default value for all the trees (fp:tree) in the report. For each of the trees, you can override the default value by using the attrnamestyle="xxx" attribute of the fp:tree tag.
Note: For quick reports, the default value (fp:defaultattrnamestyle) is always used, even if the report template contains fp:tree tags that have different attrnametyle values.
Empty string
<fp:defaultattrnamestyle>bold,underline</fp:defaultattrnamestyle>
Nodes and folders in trees
fp:defaultnodesbeforefolders Determines whether the nodes or folders are displayed first in a tree. This setting is applicable if a folder in a tree contains both nodes and folders.

If the value is true, nodes are placed first; if the value is false, folders are placed first. The fp:defaultnodesbeforefolders tag is the default tag for all the trees in the report. For each of the trees, you can override the default value by using the nodesbeforefolders="true/false" attribute of the fp:tree tag.

Note: For quick reports, the default tag fp:defaultnodesbeforefolders is used even if the report template contains fp:tree tags that have different nodesbeforefolders values.
false
<fp:defaultnodesbeforefolders>true</fp:defaultnodesbeforefolders>
In this example, the nodes are placed before the folders.
Folder width
fp:defaulttablepercentwidth Determines the default width of the tables. 100
<fp:defaulttablepercentwidth>120</fp:defaulttablepercentwidth>
The tables in the report are 20% wider than the normal width.
Width of first and last columns
fp:defaultattrstat2dfirstcolumnwidth

fp:defaultattrstat2dlastcolumnwidth

Determines the width of the first column and the last column of Attribute Statistics 2D tables.

For each of the Attribute Statistics tables, you can override the default value by using the firstcolumnwidth="xxx" and lastcolumnwidth="xxx" attributes of the attrstat2d tag.

Note: For quick reports, the default values (fp:defaultattrstat2dfirstcolumnwidth and fp:defaultattrstat2dlastcolumnwidth) are always used, even if the report template contains fp:attrstat2d tags that have different firstcolumnwidth and lastcolumnwidth values.
fp:defaultattrstat2dfirstcolumnwidth and fp:defaultattrstat2dlastcolumnwidth
<fp:defaultattrstat2dfirstcolumnwidth>200</fp:defaultattrstat2dfirstcolumnwidth>

<fp:defaultattrstat2dlastcolumnwidth>50</fp:defaultattrstat2dlastcolumnwidth>
The first column is twice as wide as a normal column. The last column is half the width of a normal column.
Matrix attribute
fp:alwaysdisplaymatrixcells Determines how the matrix attribute is displayed: either as cells or as a chart. By default, the attribute is presented the same way in reports. However, if you set fp:alwaysdisplaymatrixcells to true the attribute is presented both as a chart and as cells in the reports. If the attribute is displayed as cells in the tool, fp:alwaysdisplaymatrixcells has no effect.  
<fp:alwaysdisplaymatrixcells>true</fp:alwaysdisplaymatrixcells>
Number of columns
fp:maxnumberofcolumns Determines the maximum number of columns in tables of A4 portrait reports. If a different report size is used, a different value for the maximum number of columns can be used. For example, for an A3 portrait report, the tables might have twice the number of columns. The fp:maxnumberofcolumns tag has these attribute values:
  • AttributeStatistics2D: Maximum number of columns for fp:attrstat2d. The default value is 8.
  • PlanWorkLoad: Maximum number of columns for fp:planworkloads. The default value is 5.
  • Priority: Maximum number of columns for fp:prioritylist. The default value is 5.
  • Table: Maximum number of columns for fp:table. The default value is 5.
  • Traceability: Maximum number of columns for fp:traceability. The default value is 8.
 
<fp:maxnumberofcolumns
Table="5"
AttributeStatistics2D="10"    />
The maximum number of columns for fp:table is 5 and for fp:attrstat2d is 10.
New lines
fp:defaultnlbeforetreefolders Specifies whether a new line must be added before the headers in fp:tree components.

A new line is added if the value is true.

The fp:defaultnlbeforetreefolders tag is the default value for all the trees in the report. For each of the trees, you can override the default value by using the nlbeforetreefolders="true/false" attribute of the fp:tree tag.
Note: For quick reports, the default value of fp:defaultnlbeforetreefolders is used even if the report template contains fp:tree tags that have different nlbeforetreefolders values.
false
<fp:defaultnlbeforetreefolders>true</defaultnlbeforetreefolders>
Space
fp:attributespacerintreereports Adds an extra paragraph between the attributes in fp:tree components.  
<fp:attributespacerintreereports>smallFont</fp:attributespacerintreereports>
Text length
fp:attrstatmaxtextlength Determines the maximum length of text in a cell in the fp:attrstat1d and fp:attrstat2d components. 150
<fp:attrstatmaxtextlength>250</fp:attrstatmaxtextlength>
The maximum length of text is set to 250.
View name and definition
fp:defaultshowviewname

fp:defaultshowviewdef

Determines whether the view name and definition are presented before view contents for most of the report items.
The fp:defaultshowviewname and fp:defaultshowviewdef tags are the default values for the report items. Each report item can override the default values by using the showviewname="xxx" and showviewdef="xxx" tags.
Note: For quick reports, the default values are used even if the report template contains report items that have different attrnametyle values.
false
<fp:defaultshowviewname>true</fp:defaultshowviewname>
<fp:defaultshowviewdef>false</fp:defaultshowviewdef>
The view name, but not the view definition, is displayed.

Feedback