Skip to main content
Pentaho Documentation


The below attributes belong to the common property:
Attribute Name Purpose Possible Values
type Defines the type of element. Predefined and locked as an element type.
field-name Defines the existing field to use. String; there is no default, you must define a value manually.
value Defines a hard coded value instead of a field. String or integer; no default value.
group-fields Defines the field to group by. String or integer; no default value.
resource-value A resource string found within the resource bundle. String; no default value.
resource-identifier Defines the file that contains resource strings. String; no default. This is a properties file, including the path.
name The name you want to assign to this element. String; no default value.
output-format Sets preferred output type for the report. String; no default value. Possible values are: html, pdf, xls, rtf, csv, xml.
lock-output-format Locks the output type specified in the output-format attribute so that no other output type can be chosen. Boolean; default is false.
auto-submit If selected, your parameterized reports will automatically update based on the current selection in your parameter lists. If un-checked, parameter selections will not automatically change the report data; report users will have to select a new parameter value and then click View Report to update the report. Boolean; default is false.
format Sets the Java format string. String; there is no default. Must be in the Java number or date format.
if-null If the defined field or value returns null, show the value defined here. Boolean; default value is false.
message-null-value If the message returns null, then return the value defined here. String; no default value.
arc-height Defines the arc (corner) height of a rectangle. Integer; default value is 0.
arc-width Defines the arc (corner) width of a rectangle. Integer; default value is 0.
data-cache Determines whether parameter result sets are cached, which would reduce the amount of reload time when switching parameters in a rendered report. This option can be further configured through the org.pentaho.reporting.engine.classic. core.cache.InMemoryCache.CachableRowLimit and org.pentaho.reporting.engine.classic. core.cache.InMemoryCache.MaxEntries engine settings. Boolean; default is True (cache is turned on).