All Downloads are FREE. Search and download functionalities are using the official Maven repository.

net.sf.jasperreports.engine.dtds.jasperreport.xsd Maven / Gradle / Ivy

There is a newer version: 6.21.2
Show newest version




 
  
   Root element representing the definition of a report.
  
  
   
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
   
   
   	
   		Name of the report.
   	
   
   
   	
   		Specifies the language used for the report expressions.
   	
   
   
   	
   		Number of columns on the report.
   	
   
   
   	
   		Columns filling order.
   	
    
     
      
	   	
	   		Columns on the report are filled vertically.
	   	
      
      
	   	
	   		Columns on the report are filled horizontally.
	   	
      
     
    
   
   
   	
   		Columns filling direction.
   	
    
     
      
	   	
	   		Columns on the report are filled from left to right.
	   	
      
      
	   	
	   		Columns on the report are filled from right to left.
	   	
      
     
    
   
   
   	
   		Page width.
   	
   
   
   	
   		Page height.
   	
   
   
   	
   		Page printing orientation.
   	
    
     
      
	   	
	   		Portrait page layout.
	   	
      
      
	   	
	   		Landscape page layout.
	   	
      
     
    
   
   
   	
   		Allows users to customize the behavior of the reporting engine when there are now rows in the data source.
   	
    
     
      
	   	
	   		The generated document contains zero pages.
	   	
	        
      
	   	
	   		The generated document contains one blank page.
	   	
      
      
	   	
	   		All the report sections except the detail section will get printed.
	   	
	  
      
	   	
	   		The generated document contains only the noData section.
	   	
	  
     
    
   
   
   	
   		Specifies if the report design is made of sections containing bands or containing parts.
   	
    
     
      
	   	
	   		The report template is made of sections containing bands.
	   	
	        
      
	   	
	   		The report template is made of sections containing parts.
	   	
      
     
    
   
   
   	
   		Column width.
   	
   
   
   	
   		Space between columns.
   	
   
   
   	
   		Left margin.
   	
   
   
   	
   		Right margin.
   	
   
   
   	
   		Top margin.
   	
   
   
   	
   		Bottom margin.
   	
   
   
   	
   		Flag used to specify if the title section should be printed on a separate initial page.
   	
    
     
      
	   	
	   		Title section will be printed on a separate initial page
	   	
      
      
	   	
	   		Title section will be printed on the first page of the report, along with the other sections.
	   	
	  
     
    
   
   
   	
   		Flag used to specify if the summary section should be printed on a separate last page.
   	
    
     
      
	   	
	   		Summary section will be printed on a separate last page.
	   	
      
      
	   	
	   		Summary section will be printed on the last page of the report, along with the other sections, if there is enough space.
	   	
	  
     
    
   
   
   	
   		Flag used to specify if the summary section should be accompanied by the page header and footer.
   	
    
     
      
	   	
	   		Summary section will be printed along with the page header and footer.
	   	
      
      
	   	
	   		Summary section will be printed without page header and footer.
	   	
	  
     
    
   
   
   	
   		Flag used to specify if the column footer section should be printed at the bottom of the column or if it should immediately follow the last detail or group footer printed on the current column.
   	
    
     
      
	   	
	   		The column footer section is printed immediately after the last detail or group footer printed on the current column.
	   	
      
      
	   	
	   		The column footer section is printed at the bottom of the current column.
	   	
	  
     
    
   
   
   	
   		Indicates which class implements the scriptlets functionality for this report. The specified class must be a subclass of JRAbstractScriptlet class. If omitted, an instance of JRDefaultScriptlet will be created.
   	
   
   
   	
   		The base name of the report associated resource bundle.
   	
   
   
   	
   		Allows customizing the way the engine deals with missing resources in the resource bundle.
   	
    
     
      
	   	
	   		Null is returned for the missing resource.
	   	
	  
      
	   	
	   		An empty string is returned for the missing resource.
	   	
	  
      
	   	
	   		The key is returned for the missing resources.
	   	
	  
      
	   	
	   		An exception is thrown when the resource with the specified key is missing.
	   	
	  
     
    
   
   
   	
   		Flag used to specify whether to use pagination.
	  

This attribute can be overridden at fill time by the IS_IGNORE_PAGINATION parameter. The report will be generated on one long page. The specified page height will still be used for report design. The report will be paginated according to the pageHeight attribute. Specifies the name of the class implementing the net.sf.jasperreports.engine.util.FormatFactory interface to use with this report. If omitted, an instance of net.sf.jasperreports.engine.util.DefaultFormatFactory will be created. This attribute is auto-generated and is used to uniquely identify JRXMLs. Allows the creation of a name-value pair property for a report object (e.g. the report itself, a field, a parameter, etc). Name of the object property. Value of the object property. Name of the object property. Specifies the type of expression. Expression is written in the report expression language. Expression is a simple text expression where parameter, field, variable references have their values converted to string and expanded in-place in the resulting text. Allows the creation of a dynamic name-value pair property for a report element. The contents of this element is interpreted as a java.lang.String expression, which will be evaluated at fill time, the result being used as property value. Specifies when the default value expression of a parameter is evaluated. Evaluate the property expression before parameter contributors. Evaluate the property expression after parameter contributors. Evaluate the property expression at the end of the report. Translates into an import statement inside the expression class order to eliminate the need to use complete class names in the report expressions. Class name or package to import. A style template (*.jrtx file/JRTemplate instance) included in a report. The contents of this element is interpreted as an expression which is resolved to a style template at fill time. Class for the style template source expression. Represents the definition of a report font. Report fonts are used as default or base font settings in other font definitions throughout the report. Name of the report font definition. The default report font is used as base font for all the font definitions that do not explicitly reference a report font definition. Name of the font. Size of the font. Flag indicating if the font weight is bold Flag indicating if the font is italic Flag indicating if the font is underlined Flag indicating if the font is strikethrough Name of the PDF font. Encoding type to use with the PDF font. Specifies if the PDF font should be embedded in the document. Definition of a report style. Name of the report style definition. The default report style is used as base style for all the elements that do not explicitly reference a report style definition. Parent style reference. Deprecated. Replaced by tag pen. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by tag box. Deprecated. Replaced by attribute markup. Groups the properties of the pen used to draw lines or borders. The line width of the pen. The line style of the pen. Solid line. Dashed line. Dotted line. Double line. The line color of the pen. Paragraph properties for text elements. Type of line spacing for the text object. Normal line spacing Medium line spacing. Double line spacing Line spacing is at least the amount specified by lineSpacingSize. Line spacing is exactly as specified by lineSpacingSize. Line spacing is normal line spacing multiplied by lineSpacingSize. The line spacing size to be used in combination with the line spacing type. The indent of the first line of text. The left indent of text. The right indent of text. The spacing before text. The spacing after text. The tab stop width of the text. Custom tab stop definition. The alignment of the custom tab stop. Left aligned tab stop. Center aligned tab stop. Right aligned tab stop. The position of the custom tab stop. Used for adding conditions to a current style, to create dynamic styles.

Modifies the properties of the parent style, based on various conditions evaluated at fill time. It must be placed inside a top level style. A boolean expression which indicates if the style properties associated with it should be applied to the parent style. Definition of a dataset. A dataset can be used to feed data not present in the report to charts and crosstabs without using subreports. Name of the dataset. Indicates which class implements the scriptlets functionality for this dataset. The specified class must be a subclass of JRAbstractScriptlet class. If omitted, an instance of JRDefaultScriptlet will be created. The base name of the dataset associated resource bundle. Allows customizing the way the engine deals with missing resources in the resource bundle. Null is returned for the missing resource. An empty string is returned for the missing resource. The key is returned for the missing resources. An exception is thrown when the resource with the specified key is missing. This attribute is auto-generated and is used to uniquely identify subdatasets. Represents the definition of a report parameter. Parameters are very useful for passing data to the report engine and can be used in the expressions or in the query string of the report. Name of the parameter. Class of the parameter values. Type of the nested elements, if the parameter's value is a collection Optional flag that might be used by the parent application to prompt the user for the parameter value. Specifies when the default value expression of a parameter is evaluated. Evaluate the parameter default value expression before parameter contributors. Evaluate the parameter default value expression after parameter contributors. Can be used to specify a short text description for the parameter and is useful especially when prompting for the user to supply a value for this parameter at runtime. Specifies the parameter default value to use when not supplied by the parent application at runtime. Contains the SQL query that will be used to retrieve the data needed to fill the report. Specifies the query language.

Based on the query language, a corresponding net.sf.jasperreports.engine.query.QueryExecuterFactory is used to create net.sf.jasperreports.engine.query.JRQueryExecuter instance. The query executer is responsible for executing the query and creating a JRDataSource from the result.

A executer for a query language is registered using a JR propery named net.sf.jasperreports.query.executer.factory.<language> Represents the definition of a data field that will store values retrieved from the data source of the report. Name of the field. Class of the field values. Can be used to specify a short text description for the field and is useful especially when creating special designed data sources and an extra information is needed in order to extract the value of the field. Introduces a field to use for sorting the data source. Name of the report field to use for sorting. The sort order for the field. The type of the sort field. Represents the definition of a report variable. Variables are objects that store the values of their associated expressions or perform various calculations on those expression values. Expressions are java expressions build on top of fields and variables declared in the report. They are evaluated at runtime, when filling the report. Name of the variable. Class of the variable values. Reset level for variables that perform calculations. Variable is never initialized using the initial value expression and only holds the values obtained by evaluating its main expression. Variable is initialized only once, at the beginning of the report. Variable is initialized at the beginning of each page. Variable is initialized at the beginning of each column. Variable is initialized when the group specified by the resetGroup attribute changes. Used internally for certain built-in variables. Name of the group at which the variable is reinitialized, when resetType is "Group". Increment level for variables that perform calculations. Variable is incremented with every record in the data source. Variable is incremented only once, at the end of the report. Variable is incremented at the end of each page. Variable is incremented at the end of each column. Variable is incremented when the group specified by the incrementGroup attribute changes. Name of the group at which the variable is incremented, when incrementType is "Group". Calculation to perform on the variable expression when filling the report. No calculations are performed. Variable stores the number of the not null values encountered for the variable expression. Variable stores the number of distinct not null values encountered for the variable expression. Variable stores the sum of the not null values encountered for the variable expression. Numeric variables only. Variable stores the average of the not null values encountered for the variable expression. Numeric variables only. Variable stores the lowest value encountered for the variable expression. Variable stores the highest value encountered for the variable expression. Variable stores the standard deviation of the not null values encountered for the variable expression. Numeric variables only. Variable stores the variance of the not null values encountered for the variable expression. Numeric variables only. Variable stores a system (custom) calculated value. Variable stores the first value encountered and ignores subsequent values. The name of a class that implements the net.sf.jasperreports.engine.fill.JRIncrementerFactory interface to use when creating the incrementer instance for this variable. Incrementers are objects that implement the net.sf.jasperreports.engine.fill.JRIncrementer interface and handle the incremental calculation performed on the variable's current value with every iteration in the data source. Can be used to specify a short text description for the variable. Definition of the expression associated with the variable. The value of this expression will be calculated at runtime and will represent the value of the corresponding variable or it will be used in calculation to obtain the value of the calculated variable. Definition of the expression that will be used to calculate the initial value of the variable, before any calculations are made. Boolean expression used to filter the rows of a data source.

This expression is used to filter the rows of the data source that this dataset will iterate on.

Boolean.TRUE the row gets processed by the report filling engine. When the result is null or Boolean.FALSE, the current row will be skipped and the datasource will be asked for the next row. ]]>

Definition of a group on the report. Name of the group. Flag that signals if the group header should be printed always on a new column. Group header section is printed always on a new column. Group header section is printed on the current column, if there is enough space. Flag that signals if the group header should be printed always on a new page. Group header section is printed always on a new page. Group header section is printed on the current page, if there is enough space. Flag that signals if the group header should be printed always on a new page, along with the re-initialization of the page number. Group header section is printed always on a new page and the page number is reinitialized. Group header section is printed accordingly with the isStartNewPage attribute and the page number is not affected. Flag that signals if the group header should be reprinted at the beginning of each page. Group header section is reprinted always at the beginning of a new page. Group header section is not reprinted at the beginning of a new page. Flag that signals if the group header should be reprinted at the beginning of each column, in vertically filled reports only. Group header section is reprinted always at the beginning of a new column. Group header section is not reprinted at the beginning of a new column. Minimum amount of vertically space needed at the bottom of the column in order to place the group header on the current column. Minimum number of details to be rendered on the current column, to avoid starting the group on a new column. Specifies how the group footer section behaves with regards to its position on the current page. The group footer section is rendered at normal position, just right after the last detail or right after the nested group footer section. The group footer section is rendered at bottom of the current page, provided that an inner group having this value would force outer group footers to stack at the bottom of the current page, regardless of the outer group footer setting. The group footer section is rendered at bottom of the current page, provided that an inner group having this value would render its footer right at the bottom of the page, forcing the outer group footers to render on the next page. The group footer section is rendered at bottom of the current page, provided that the outer footers have a similar footer display option to render at the page bottom as well, because otherwise, they cannot be forced to change their behavior in any way. Flag that prevents the group from splitting on two separate pages/columns, but only on the first break attempt. Group can split across two separate pages/column at any moment. Group is moved onto a new new page/column, before being split. Flag that prevents the group from appearing alone at the top of a new page/column. The last detail section is moved onto the new page/column so that the group footer does not appear alone. The group footer can appear alone at the top of a new page/column, without a detail section. Specifies the expression that will be evaluated at runtime to determine the group ruptures. Contains the definition of the header section for this group. Contains the definition of the footer section for this group. Definition of the page background section for this report. The background section is displayed on every page and cannot overflow to the next page. Elements placed on this section are evaluated at page initialization time and are displayed in the back. All other page elements are displayed on top of the background elements. This section allows creating watermark or other similar effects in documents. Definition of the title section for this report. The title section appears only once at the beginning of the report. Definition of the page header section for this report. The page header is printed at the beginning of each page on the report. Definition of the column header section for this report. The column header is printed at the beginning of each column on the report. If the report's column count is 1, column header and footer sections are ignored. Definition of a detail band for this report. A detail band is repeated for each line of data supplied by the report's data source. There can be multiple detail bands in a report. Definition of the column footer section for this report. The column footer is printed at the bottom of each column on the report. If the report's column count is 1, column header and footer sections are ignored. Definition of the page footer section for this report. The page footer is printed at the bottom of each page on the report. The page footer section to use on the last page instead of the normal page footer. This might not be the very last page of the document in case the summary section is also present. This section is sometimes useful when summary information has to be displayed at the bottom of the last page. Definition of the summary section for this report. The summary section is printed only once at the end of the report. Definition of the noData section for this report. The noData section is printed only if whenNoDataType attribute is set to "NoDataSection". Generic definition of a report section. Height of the band. Deprecated. Replaced by attribute splitType. Flag that indicates if the band is allowed to split when it stretches. Page breaks are accepted within this band. When the band stretches and it does not fit on the current page, the content of the band will be transferred on the next new page. On this new page the flag will be ignored since the band has to be displayed even there is not enough space to acquire the stretch. Specifies the band split behavior. The band is allowed to split, but never within its declared height. This means the band splits only when its content stretches. Prevents the band from splitting on first break attempt. On subsequent pages/columns, the band is allowed to split, to avoid infinite loops. The band is allowed to split anywhere, as early as needed, but not before at least one element being printed on the current page/column. Generic definition of a report part. This attribute is auto-generated and is used to uniquely identify parts. Determines the time at which the part is to be evaluated. The part is to be evaluated immediately. The part is to be evaluated when the report ends. The part is to be evaluated when a group breaks. Specifies the group at which to evaluate the part when evaluationTime is Group. An expression that will provide a name for a report part. Introduces a page break or column break Specifies the type of the break element. Page break. Column break. Definition of a line object. Lines are drawn as diagonals of the rectangle defined by the report element properties. This attribute specifies which of the two diagonals should be drawn. The diagonal that starts in the top-left corner of the rectangle will be drawn. The diagonal that starts in the bottom-left corner of the rectangle will be drawn. Element used to specify the common properties of an object on the report. This attribute is auto-generated and is used to uniquely identify elements across multiple report templates. This attribute is used to identify band elements by their "key" when wanting to alter their settings at runtime. The key value must be unique for elements within report band. Name of the report level style to use as base style (see style element). Specifies the object position when the report section is affected by stretch. The element moves relative to the size of the surrounding elements. The element maintains its position relative to the top of the band. The element maintains its position relative to the bottom of the band. Specifies the element stretch behavior relative to its element group siblings or element container stretch. The element won't stretch vertically beyond its natural stretch height, when the container stretches to display other elements. Deprecated. Replaced by ElementGroupHeight value. Deprecated. Replaced by ContainerHeight value. The element will stretch to accommodate the overall natural growth of its group, but also taking into account the shifting Y position of the element within its group. See the elementGroup element, to see how to group elements. The element will stretch to accommodate the overall natural growth of its group, without taking into account the shifting Y position of the element within its group. See the elementGroup element, to see how to group elements. The element will stretch to fit the container height, while taking into account its new Y position. This results in the element preserving its distance to the container's bottom edge. The element will stretch to fit the container height, but without taking into account its new Y position. This might results in the element being shifted up (due to collapsing elements above) or down (due to stretching elements above that push it downards) relative to the container bottom edge. In case the element its already pushed downwards, the additional stretch imposed by the container might actually throw it beyond the container's bottom edge, in which case the element will not render at all. This flag allows suppressing the repeating values for the dynamic elements such as text fields and image fields and to fully customize the behavior of the static elements like rectangles, lines, ellipses and static texts. Dynamic elements will print even if their values repeat. Static elements will appear every time the band that contains them is started. Suppresses the repeated values for the dynamic elements. The static elements will print only according to the other 3 attributes: isPrintInFirstWholeBand, isPrintWhenDetailOverflows, printWhenGroupChanges. Specifies whether the background of an object is transparent or opaque. Specifies the x coordinate for the object within the band. Specifies the y coordinate for the object within the band. Width of the object. Height of the object. Collapses the band if the element is not printing and no other element is occupying the same horizontal space. The element gets printed in the first band of a new page or column that is not an overflow from a previous page or column. The element will be printed when the band overflows to a new page or a new column. The element will be printed when the specified group changes. Fore color to use when drawing the object. Hexadecimal formatted values preceded by the # character or decimal values are accepted along with the following predefined color values: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, yellow, white. Back color to use when drawing the object. Hexadecimal formatted values preceded by the # character or decimal values are accepted along with the following predefined color values: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, yellow, white. Definition of a Boolean expression that will determine if the element or the band should be printed or not. Element used to specify the common properties of a graphic object on the report (line, rectangle, ellipse or image). Deprecated. Replaced by attribute with the same name in tag reportElement. Deprecated. Replaced by tag pen. No line. Thin line. Normal line. Medium line. Thick line. Dotted line. Type of the fill pattern used to fill objects. Solid fill. Definition of a rectangle object. The radius of the arc corner. Definition of an ellipse object. Definition of an image object. Image displaying type. Only the portion of the image that fits the specified object width and height will be printed. Image is not stretched. Image will be stretched to adapt to the specified object width and height. Image will adapt to the specified object width or height keeping its original shape. A scale image type that instructs the engine to stretch the image height to fit the actual height of the image.

Several restrictions apply to the image stretching mechanism:

  • It only works when the image renderer implements JRRenderable.getDimension().
  • If the actual image width exceeds the declared image element width, the image is proportionally stretched to fit the declared width.
  • Images with delayed evaluation (see the evaluationTime attribute) do not stretch and is proportionally shrunk to fit the declared height/width.
  • An image overflows (to the next page/column) only once, after this the image gets rendered on the available space by proportionally shrinking its size.

A scale image type that stretches the images height in the same way as RealHeight, and in addition it changes the image width to the actual with of the image. This can be useful when, for instance, a border has to be drawn around the image, respecting its actual size.
Type of rotation for the image object. Image is not rotated. Image is rotated 90 degrees counter clockwise. Image is rotated 90 degrees clockwise. Image is rotated 180 degrees. Horizontal image alignment. Vertical image alignment. If true, tells the report engine to cache the images that are loaded from the same location. Gives control over when the images are retrieved from their specified location. The image is loaded from the specified location only when the document is viewed or exported to other formats. The image is loaded during the report filling process and stored in the resulting document. Controls the behavior of the engine in case the image is not available. An exception is raised when loading the image. The exception is ignored and the image displays as blank. The exception is ignored and an image replacement icon is displayed. The image to be printed is supplied by the associated expression. This expression can be evaluated at a specified moment. This could be useful, for example, when we want to have on the first page a chart that will be generated only after fetching all the data source rows. Used to specify the group at which to evaluate the image expression value, when evaluationTime is "Group". Indicates the type of the hyperlink element.

The type can be:

  • One of the built-in types:
    None
    The current element doesn't represent a hyperlink.
    Reference
    The current hyperlink points to an external resource specified by the corresponding hyperlinkReferenceExpression element, usually an URL.
    LocalAnchor
    The current hyperlink points to a local anchor specified by the corresponding hyperlinkAnchorExpression element.
    LocalPage
    The current hyperlink points to a 1 based page index within the current document specified by the corresponding hyperlinkPageExpression element.
    RemoteAnchor
    The current hyperlink points to an anchor specified by the hyperlinkAnchorExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
    RemotePage
    The current hyperlink points to a 1 based page index specified by the hyperlinkPageExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
  • A custom (arbitrary) type.

Indicates the target of the hyperlink. The level of the bookmark corresponding to the anchor.

The PDF exporter can create a bookmark tree using anchors defined in the report. This attribute specifies the level of the tree entry corresponding to this element's anchor. If set to "0" (the default), no bookmark will be created for the anchor. Definition of the expression that will be used to determine the image to be displayed. Class of the image source. Tag used to specify the border and padding properties of a report element. Deprecated. Replaced by tag pen No border. Thin border. Normal border. Medium border. Thick border. Dotted border. Deprecated. Replaced by tag pen The amount of empty space between the border and the element's content. Deprecated. Replaced by tag topPen No top border. Thin top border. Normal top border. Medium top border. Thick top border. Dotted top border. Deprecated. Replaced by tag topPen The amount of empty space between the top border and the element's content. Deprecated. Replaced by tag leftPen No left border. Thin left border. Normal left border. Medium left border. Thick left border. Dotted left border. Deprecated. Replaced by tag leftPen The amount of empty space between the left border and the element's content. Deprecated. Replaced by tag bottomPen No bottom border. Thin bottom border. Normal bottom border. Medium bottom border. Thick bottom border. Dotted bottom border. Deprecated. Replaced by tag bottomPen The amount of empty space between the bottom border and the element's content. Deprecated. Replaced by tag rightPen No right border. Thin right border. Normal right border. Medium right border. Thick right border. Dotted right border. Deprecated. Replaced by tag rightPen The amount of empty space between the right border and the element's content. Groups the properties of the pen used to draw top lines or borders. The line width of the pen. The line style of the pen. Solid line. Dashed line. Dotted line. Double line. Line color for the pen. Hexadecimal formatted values preceded by the # character or decimal values are accepted along with the following predefined color values: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, yellow, white. Groups the properties of the pen used to draw left lines or borders. The line width of the pen. The line style of the pen. Solid line. Dashed line. Dotted line. Double line. Line color for the pen. Hexadecimal formatted values preceded by the # character or decimal values are accepted along with the following predefined color values: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, yellow, white. Groups the properties of the pen used to draw bottom lines or borders. The line width of the pen. The line style of the pen. Solid line. Dashed line. Dotted line. Double line. Line color for the pen. Hexadecimal formatted values preceded by the # character or decimal values are accepted along with the following predefined color values: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, yellow, white. Groups the properties of the pen used to draw right lines or borders. The line width of the pen. The line style of the pen. Solid line. Dashed line. Dotted line. Double line. Line color for the pen. Hexadecimal formatted values preceded by the # character or decimal values are accepted along with the following predefined color values: black, blue, cyan, darkGray, gray, green, lightGray, magenta, orange, pink, red, yellow, white. If specified, it will supply the bookmark level for the corresponding element. This setting overrides the bookmarkLevel attribute of the element. If specified, it will supply the name of the local anchor that will mark to the corresponding element. Used in hyperlink elements to point to external documents and resources. Used in hyperlink elements to specify whether the hyperlink is to be displayed or not. Used in hyperlink elements to point to document anchors. Used in hyperlink elements to point to document pages. Used in hyperlink elements to generate a tooltip for the hyperlink. The type of the expression should be java.lang.String. Definition of a hyperlink parameter. Hyperlink parameters can be used to parametrize hyperlinks of custom types. The name of the hyperlink parameter. Expression that will produce the value for a hyperlink parameter. Type of the parameter value. Definition of a static text object. Specifies the text to print for a static text object. Element used to specify the common properties of a text object on the report (staticText or textField). Type of alignment for the text object. Text is aligned to the left. Text is centered. Text is aligned to the right. Text is justified. Type of vertical alignment for the text object. Text is aligned to the top. Text is vertically centered. Text is aligned to the bottom. Text is justified. Type of rotation for the text object. Text runs horizontally from left to right and from top to bottom. Text runs vertically from bottom to top and from left to right. Text runs vertically from top to bottom and from right to left. Text is rotated with 180 degrees. Type of line spacing for the text object. Normal line spacing Medium line spacing. Double line spacing Deprecated. Replaced by attribute markup.

When set to true, this attribute signals to the rendering engine that the text element contains preformatted text. Style information can be introduced in the text content using nested <style> tags that support the folowing attributes : fontName, size, isBold, isItalic, isUnderline, isStrikeThrough, pdfFontName, pdfEncoding, isPdfEmbedded, forecolor, backcolor. The text element contains text formatted using nested <style> tags. The text element has a pure text content, without style information. Specifies the name of the markup language used to embed style information into the text content. Supported values are none (plain text), styled (styled text), rtf (RTF format) and html (HTML format), but any custom made markup language can be used as long as there is a net.sf.jasperreports.engine.util.MarkupProcessorFactory implementation specified using a net.sf.jasperreports.markup.processor.factory.{markup} configuration property. Defines the font to use with the text element. Name of the report level font to use as base font (see reportFont element). Name of the font. Size of the font. Name of the PDF font. Encoding type to use with the PDF font. Specifies if the PDF font should be embedded in the document. Definition of a text field object. Deprecated. Replaced by attribute textAdjust.

Instructs the report engine to allow the text field to stretch downwards in order to display all its text when it doesn't fit in the defined text field height. Text adjust type. The text is cut, if it does not fit the text field element size. The text field element is stretched in height to accommodate the entire content.
Note: Text fields with delayed evaluation do not stretch to acquire all the expression's content. This is because the text element height is calculated when the report section is generated, and even if the engine comes back later with the text content of the text field, the element height will not adapt, because this would ruin the already created layout.
The font size of the text is scaled down so that the entire content fits the text field element size.

Font size is scaled down using decreasing font size increments/decrements, until the best fit is found. The minimum font size increment/decrement amount is configured using the net.sf.jasperreports.scale.font.step.limit property, which also serves as minimum acceptable font size. Text to be printed is supplied by the text field associated expression. This expression can be evaluated at a specified moment. This could be useful, for example, when we want to have on the first page the total number of pages. The total number of pages is known only after filling the entire report, so we can specify that the text filed that will represent the total number of pages placed at the beginning of the report should be evaluated only when reaching the end of the report. Used to specify the group at which to evaluate the text field value, when evaluationTime is "Group". Pattern to use when formatting the output of the text field expression. Specifies that the text field should display a blank character instead of "null" when the text field expression evaluates to null. Indicates the type of the hyperlink element.

The type can be:

  • One of the built-in types:
    None
    The current element doesn't represent a hyperlink.
    Reference
    The current hyperlink points to an external resource specified by the corresponding hyperlinkReferenceExpression element, usually an URL.
    LocalAnchor
    The current hyperlink points to a local anchor specified by the corresponding hyperlinkAnchorExpression element.
    LocalPage
    The current hyperlink points to a 1 based page index within the current document specified by the corresponding hyperlinkPageExpression element.
    RemoteAnchor
    The current hyperlink points to an anchor specified by the hyperlinkAnchorExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
    RemotePage
    The current hyperlink points to a 1 based page index specified by the hyperlinkPageExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
  • A custom (arbitrary) type.

Indicates the target of the hyperlink. The level of the bookmark corresponding to the anchor.

The PDF exporter can create a bookmark tree using anchors defined in the report. This attribute specifies the level of the tree entry corresponding to this element's anchor. If set to "0" (the default), no bookmark will be created for the anchor. Defines the expression to use for this textField. Class for the text field values. Defines the pattern expression to use for this textField. Definition of a subreport object. If true, tells the report engine to cache the report definition objects that are loaded from the same location. Flag to specify if the subreport should consume all the available space on the current page. When this flag is set, the subreport would consume the entire vertical space available on the master page, and its column and page footers will be printed at the bottom of this space. Determines what happens when the subreport contents overflows the element height. If not specified, the subreport will stretch to accomodate the contents. The subreport stretches to to accomodate the overflown contents. The contents do not stretch beyond the subreport element height. The band on which the subreport is placed overflows to a new page if allowed, and the subreport contents continues there. Allows bulk passing the parameters to the subreport/subdataset into a java.lang.Map object. There are cases when we want to pass to the subreport/subdataset the same parameters that the master report has received. This can be achieved by passing the system-defined parameter called REPORT_PARAMETERS_MAP and maybe adding to or overriding those parameters using additional subreportParameter elements. Definition of a subreport parameter. The name of the parameter that will be passed when filling the subreport. Definition of the expression associated with the subreport parameter. Maps a subreport variable to a master report variable in order to allow returning values from subreport to the master report. Name of the subreport variable whose value will be returned to the master report. Name of the master report variable to which the value is returned. This should be a variable with calculation="System" Calculation to perform on the master report variable when returning the value from the subreport. No calculations are performed. Variable stores the number of the not null values returned from the subreport. Variable stores the number of distinct not null values returned from the subreport. Variable stores the sum of the not null values returned from the subreport. Numeric variables only. Variable stores the average of the not null values returned from the subreport. Numeric variables only. Variable stores the lowest value returned from the subreport. Variable stores the highest value returned from the subreport. Variable stores the standard deviation of the not null values returned from the subreport. Numeric variables only. Variable stores the variance of the not null values returned from the subreport. Numeric variables only. Variable stores the first value encountered and ignores subsequent values. The name of a class that implements the net.sf.jasperreports.engine.fill.JRIncrementerFactory interface to use when creating the incrementer instance to handle the value returned from the subreport. If present, it is used to pass the java.sql.Connection object to the subreport filling or subdataset iteration routines. If present, it is used to pass the net.sf.jasperreports.engine.JRDataSource object to the subreport filling or subdataset iteration routines. Definition of the expression that will be used to determine the report object that will be loaded as a subreport. Class of the image source. Element for grouping objects on the report. Defines a chart report element Show legend flag The chart can be rendered at a specified moment. This could be useful, for example, when we want to have on the first page a chart that will be generated only after fetching all the data source rows. Used to specify the group at which to render the chart, when evaluationTime is "Group". Indicates the type of the hyperlink element.

The type can be:

  • One of the built-in types:
    None
    The current element doesn't represent a hyperlink.
    Reference
    The current hyperlink points to an external resource specified by the corresponding hyperlinkReferenceExpression element, usually an URL.
    LocalAnchor
    The current hyperlink points to a local anchor specified by the corresponding hyperlinkAnchorExpression element.
    LocalPage
    The current hyperlink points to a 1 based page index within the current document specified by the corresponding hyperlinkPageExpression element.
    RemoteAnchor
    The current hyperlink points to an anchor specified by the hyperlinkAnchorExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
    RemotePage
    The current hyperlink points to a 1 based page index specified by the hyperlinkPageExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
  • A custom (arbitrary) type.

Indicates the target of the hyperlink. The level of the bookmark corresponding to the anchor.

The PDF exporter can create a bookmark tree using anchors defined in the report. This attribute specifies the level of the tree entry corresponding to this element's anchor. If set to "0" (the default), no bookmark will be created for the anchor. The name of the chart customizer class.

A chart can have an associated customizer class to perform customizations that are not directly supported by JRXML. The customizer class should implement net.sf.jasperreports.engine.JRChartCustomizer. At fill time, the customize() method of this class will be called before the chart is rendered.

If values of report parameters, variables or fields are needed in the customization, the customizer implementation should extend net.sf.jasperreports.engine.JRAbstractChartCustomizer to gain access to such values. Represents the specified format used to render the chart. The chart theme used to draw the chart. Title text of the chart. Position of the title Color of the title text Title expression of the chart Subtitle of the chart Color of the subtitle text Defines the expression for the chart subtitle Specifies layout options for the legend of a chart. The color of the text in the legend. The color of the background of the legend. Position of the legend. Configures settings for item labels in a category plot. The color of the label's text. The background color of the label's text. Defines a pie type chart Defines a dataset to be used with pieChart Defines a key in a pieDataset or pieSeries Defines the expression for the value of a point in a chart. Defines a label in a pieDataset or pieSeries. Hyperlink specification for pie chart sections. This hyperlink definition will be evaluated for every chart section and a image map will be created for the chart. Indicates the type of the hyperlink element.

The type can be:

  • One of the built-in types:
    None
    The current element doesn't represent a hyperlink.
    Reference
    The current hyperlink points to an external resource specified by the corresponding hyperlinkReferenceExpression element, usually an URL.
    LocalAnchor
    The current hyperlink points to a local anchor specified by the corresponding hyperlinkAnchorExpression element.
    LocalPage
    The current hyperlink points to a 1 based page index within the current document specified by the corresponding hyperlinkPageExpression element.
    RemoteAnchor
    The current hyperlink points to an anchor specified by the hyperlinkAnchorExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
    RemotePage
    The current hyperlink points to a 1 based page index specified by the hyperlinkPageExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
  • A custom (arbitrary) type.

Indicates the target of the hyperlink.
Indicates the type of the hyperlink element.

The type can be:

  • One of the built-in types:
    None
    The current element doesn't represent a hyperlink.
    Reference
    The current hyperlink points to an external resource specified by the corresponding hyperlinkReferenceExpression element, usually an URL.
    LocalAnchor
    The current hyperlink points to a local anchor specified by the corresponding hyperlinkAnchorExpression element.
    LocalPage
    The current hyperlink points to a 1 based page index within the current document specified by the corresponding hyperlinkPageExpression element.
    RemoteAnchor
    The current hyperlink points to an anchor specified by the hyperlinkAnchorExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
    RemotePage
    The current hyperlink points to a 1 based page index specified by the hyperlinkPageExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
  • A custom (arbitrary) type.

Indicates the target of the hyperlink.
Plot options for a pieChart Show labels flag. Indicates whether the pie chart is circular, or stretched into an elliptical shape Dataset definition for a chart or crosstab. Reset type for the dataset Reset group name Increment type of the dataset. Increment group of the dataset Boolean expression that determines whether a chart or crosstab dataset will be incremented or not.

Boolean.TRUE; if the result is null or Boolean.FALSE, the dataset will not be incremented. ]]>

Subdataset instantiation information for a chart/crosstab dataset. The name of the subdataset to instantiate. This attribute is auto-generated and is used to uniquely identify dataset runs. Name of the variable to which the value is returned. This should be a variable withcalculation="System" Calculation to perform on the destination variable when returning the value. No calculations are performed. Variable stores the number of the not null returned values. Variable stores the number of distinct not null returned values. Variable stores the sum of the not null returned values. Numeric variables only. Variable stores the average of the not null returned values. Numeric variables only. Variable stores the lowest returned value. Variable stores the highest returned value. Variable stores the standard deviation of the not null values. Numeric variables only. Variable stores the variance of the not null values. Numeric variables only. Variable stores the first value encountered and ignores subsequent values. The name of a class that implements thenet.sf.jasperreports.engine.fill.JRIncrementerFactory interface to use when creating the incrementer instance to handle the returned value. Name of the source variable whose value will be returned. Allows bulk passing the parameters to the subreport/subdataset into a java.lang.Map object. There are cases when we want to pass to the subreport/subdataset the same parameters that the master report has received. This can be achieved by passing the system-defined parameter called REPORT_PARAMETERS_MAP and maybe adding to or overriding those parameters using additional subreportParameter elements. Definition of a subdataset parameter. The name of the parameter that will be passed when iterating the subdataset. Definition of the expression associated with the subdataset parameter. Defines generic plot options for charts Background color of the chart Orientation of the chart Alpha (transparency) parameter for the background. Alpha (transparency) parameter for the foreground. Deprecated. Replaced by attribute labelRotation of tag categoryAxisFormat. Degrees to rotate the text labels for the x axis of the chart. Positive values rotate the text clockwise and negative values rotate it counterclockwise. This attribute has no effect on charts where the x axis is either numeric or a date. Defines the color to use for a series in the report. If only one seriesColor is specified it becomes the color of the first series. If more than one seriesColor is specified the chart will cycle through the supplied colors. Meter and Thermometer charts do not have series and will ignore any seriesColor settings.

When used in a chart that part of a multi-axis chart series color is treated a bit differently. The default color series to cycle through is defined in the plot of the multi axis chart, and the color series for the nested charts define series colors for that chart only. This is useful when a multiple axis chart contains several line charts, each with one series. By default every line will be the first in its plot and will have the first color defined in the multi axis plot, so every line will be the same color. To solve this you can set a seriesColor for each nested chart to override the default colors.
The relative order of this color. All seriesColors are sorted by the value of this attribute, and appear in that order when coloring the series.

When the chart is nested inside a multiple axis chart the seriesOrder is the actual series number to apply the color to. Series use zero-based indexing.
The color to use for the series
Defines a pie chart with 3D effect Defines plot options for a pie3DChart Show labels flag. Depth factor for a pie chart plot. Indicates whether the pie chart is circular, or stretched into an elliptical shape Defines a bar chart. Dataset used with this chart is categoryDataset Creates a dataset with one or more series and values associated with categories Defines a series that will be mapped on the category axis. Defines a series expression in a dataset Defines a category expression in a dataset. Hyperlink specification for chart items. This hyperlink definition will be evaluated for every chart item and an image map will be created for the chart. Indicates the type of the hyperlink element.

The type can be:

  • One of the built-in types:
    None
    The current element doesn't represent a hyperlink.
    Reference
    The current hyperlink points to an external resource specified by the corresponding hyperlinkReferenceExpression element, usually an URL.
    LocalAnchor
    The current hyperlink points to a local anchor specified by the corresponding hyperlinkAnchorExpression element.
    LocalPage
    The current hyperlink points to a 1 based page index within the current document specified by the corresponding hyperlinkPageExpression element.
    RemoteAnchor
    The current hyperlink points to an anchor specified by the hyperlinkAnchorExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
    RemotePage
    The current hyperlink points to a 1 based page index specified by the hyperlinkPageExpression element, within an external document indicated by the corresponding hyperlinkReferenceExpression element.
  • A custom (arbitrary) type.

Indicates the target of the hyperlink.
Plot options for a barChart Show labels flag. Show tick marks on the value axis Show tick labels on the value axis Expression that will be displayed on category axis Defines the expression for the value axis of the chart Defines the expression for the minimum value on the domain axis. Defines the expression for the maximum value on the domain axis. Defines the expression for the minimum value on the range axis. Defines the expression for the maximum value on the range axis. Specifies the formatting of a category axis, including how to draw the axis line, its label and tick mark labels. Any tick label mask specified will be ignored. Degrees to rotate the text labels for the category axis of the chart. Positive values rotate the text clockwise and negative values rotate it counterclockwise. Specifies the formatting of a value axis, including how to draw the axis line, its label and tick mark labels. If a tick label mask is specified it will be treated as a numeric mask. Specifies the general formatting settings for an axis. The color to use for the caption of the axis. The color to use for the label of each tick mark on the axis. A formatting mask to use for the label of each tick mark on the axis. Only used if the axis is time based or numeric based. For numeric axes the format of the mask is described in documentation for java.text.DecimalFormat. For a date axis the format used is described in java.text.SimpleDateFormat. Finally, for date axes the values "SHORT", "MEDIUM", "LONG" and "FULL" can be used as described in java.text.DateFormat. Flag to force rendering the tick labels rotated 90 degrees. The color to use when drawing the line showing the axis. Specifies the font to use when drawing the label of an axis in a chart. The label of an axis is the text that describes the axis. Specifies the font to use when drawing the label for each tick mark on an axis in a chart. Defines a bar chart with 3D effect Defines plot options for a bar chart with 3D effect Show labels flag. Offset on the x axis. Offset on the y axis. Defines a bar chart that uses an xyDataset Defines a time period dataset Defines a time period series for a timePeriodDataset Defines a stacked bar chart Defines a stacked area chart Defines a stacked bar chart with 3D effect Defines a line chart Defines plot options for a lineChart Show lines flag. Show shapes flag. Defines a line chart that uses an xyzDataset Defines an XY type dataset Defines a series used in an xyDataset Auto sort values on x-axis. Defines the expression for the value of the X axis of the chart. Defines the value for the Y axis. Defines an area chart. Defines rendering options for an areaChart Defines a area chart that uses an xyDataset Defines a scatter chart Specifies the plot options for a scatterChart Show lines flag Show shapes flag Defines the expression for the label of the X axis of the chart Defines the expression for the Y axis label of the chart Specifies the formatting of an x axis, including how to draw the axis line, its label and tick mark labels. If a tick label mask is specified it will be treated as a numeric mask. Specifies the formatting of a y axis, including how to draw the axis line, its label and tick mark labels. If a tick label mask is specified it will be treated as a numeric mask. Creates a bubble chart Defines a dataaset used for bubbleChart Defines a series in an xyzDataset Plot options for a bubbleChart Scale options for the bubble chart items Expression that defines the value for the Z axis in an xyzSeries Defines a time series dataset Time period for the dataset. Defines a time series for timeSeriesDataset. Defines the expression used for a time period Defines a time series chart. Defines plot options for a timeSeriesChart Show lines flag. Show shapes flag. Defines the expression used for the time axis label Specifies the formatting of a time axis, including how to draw the axis line, its label and tick mark labels. If a tick label mask is specified it will be treated as a date mask. Defines a high-low type chart Defines a dataset that can be used with a highLowChart. Plot options for a highLowChart Show close tick flag. Show open tick flag. Represents a date expression used in timeSeriesChart High expresion in a highLowchart. Low expresion in a highLowchart. Open expression for a candlestickChart Expression for the close value for candlestickChart Defines the volumeExpression for a highLowDataset Creates a candlestick chart Plot options for a candlestickChart Flag that enables showing volume values for a candlestickChart. Defines a meter chart. A meter chart plots a single value on a dial. In addition to the value being plotted multiple ranges can be specified to help interpret the value. Defines a dataset that contains a single value. Plot options for a meterChart. Defines the shape of the meter. The final appearance is determined by the combination of this attribute and the angle attribute. This attribute only matters when the meter is using an angle over 180 degrees.

When a meter is over 180 degrees wide the space between the start and end of the meter can be filled in several different ways. The best way to visualize this is to think of a twelve hour clock. If the angle of the meter is 240 degrees the meter will start at 8, sweep up past 12 and down to 4. This attribute specifies how to fill the area between 4 o'clock and 8 o'clock.

A straight line is drawn between the start point and the end point, and the area bounded by the meter and this line is shaded with the background color. The unused portion of the circle that describes the meter is shaded with the background color. The unused portion of the circle that describes the meter is not shaded at all. The unused portion of the circle that describes the meter is shaded with the background color and handled with specific dial objects.
The extent of the meter in degrees. Use 180 for a semicircle. An optional string that describes the unit that the meter is displaying. This string will be appended to the value. The amount of space between values to mark as "ticks" on the face of the meter. If the meter has a data range of 0-100 and the tick interval is 20, there will be 4 ticks at 20, 40, 60 and 80. The color of meter. If meterIntervals are defined they may mask this color. The color used to draw the needle in the meter. The color of the meter ticks, if any. The number of major ticks on the meter scale.
Controls how the single data value is displayed in a meterChart or thermometerChart. The color to use when displaying the value. The formatting mask to use to display the value. This mask must follow the rules specified for a java.text.DecimalFormat pattern.

This attribute is currently ignored for a meterChart. Defines a numeric range, such as the bounds of chart or a section of a chart. Describes a range of a meterChart to highlight. A typical use is to divide a meter up into sections such as "normal", "warning" and "critical" and color code them. The name of this region. The name will appear in the meter's legend if the legend is being displayed. The color used to shade the region in the meter. If not set the region will have no visual indicator. The alpha (transparency) of the shading for the region. The values range from 0.0 (completely transparent) to 1.0 (completely opaque). Defines a thermometer chart. A thermometer chart plots a single value on a thermometer. In addition to the value being plotted three ranges can be specified to help interpret the value. Plot options for a thermometerChart. Defines where to display the textual representation of the value being displayed, relative to the thermometer outline. The textual value is not displayed. The text value is displayed to the left of the thermometer outline. The text value is displayed to the right of the thermometer outline. The text value is displayed in the bulb at the bottom of the thermometer. Deprecated. No longer used. Defines whether or not lines are drawn showing values on the thermometer. Value lines are drawn. Value lines are not drawn. The color used to fill the thermometer.

If the value of the thermometer falls in one of the defined ranges the color specified in that range will be used instead of this color. Defines the low range in a thermometerChart. Defines the medium range in a thermometerChart. Defines the high range in a thermometerChart. Definition of chart with multiple range axis, all sharing a common domain axis. The domain is determined by the dataset of each nested report, and they must all use the same type of dataset. The time period datasets (highLowDataset, candlestickDataset and timeSeriesDataset) are considered the same and can be mixed.

Each nested chart has its own range, so you can combine charts with significantly different scales. Each chart will have its own axis showing its range, and it is highly recommended to color the data series and the axis to match.

The plot options of the nested reports are ignored - the plot is configured via the multiAxisPlot. The only exception to this is any seriesColors specified in the plot of a nested report, which will be used to color a specific series in that report. In this case the seriesOrder in the seriesColor is an absolute specification of a series to color, not a relative ordering.
Plot options for a multiAxisChart. The set plot options will be shared by all the charts inside this plot, and the nested charts are specified via the axis tags. All nested charts must share the same type of domain axis - a category, a numeric (xy) or a time based axis. Describes a range axis to use in a multiAxisChart. Each axis has its own range indicator and a data plot. Indicates where relative to the chart to display the range axis for this chart Display the axis to the left (for charts with a Vertical orientation) or top (for charts with a Horizontal orientation.) Display the axis to the right (for charts with a Vertical orientation) or bottom (for charts with a Horizontal orientation.) Crosstab definition.

To be noted that the crosstab will stretch downwards to fit the data but it will not exceed its report element width. Flag that indicates whether the column headers will be reprinted after a page break. The column headers will be reprinted after a page break. The column headers will be printed only on the page where the crosstab starts. Flag that indicates whether the row headers will be reprinted after a crosstab column break. The row headers will be reprinted after a crosstab column break. The column headers will be printed for all rows only for the first set of columns and not after a column break. Offset used when a column break occurs and the filling is continued on the same page.

When the crosstab columns do not fit the width, the crosstab breaks the columns and prints the ones that don't fit after printing the first set of columns for all rows. This attribute is the offset to be used when continuing the printing after a column break. The crosstab run direction.

Crosstabs can either be filled from left to right (the default) or from right to left (mainly for reports in RTL languages).

When a crosstab is filled from right to left, the crosstab contents will start from the right extremity of the crosstab element area and grow towards the left. Left to right run direction. Right to left run direction. This attribute determines whether the crosstab will break at the width set for the crosstab element, or whether the crosstab is to expand over this width (and over the page width as well).

If this attribute is set to true, the crosstab will expand towards the right (or towards the left if the crosstab direction is RTL) as long as it needs to. This would result in crosstab cells being rendered over the page boundary; such elements will be exported by certain grid-based exporters such as the HTML or XLS ones, but will not be visible in export formats that observe the page width, such as the PDF exporter.

The default value of this flag is given by the net.sf.jasperreports.crosstab.ignore.width property.

The position of the crosstab within its element box.

By default LTR crosstabs are positions at the left of the element box, and RTL crosstabs at the right of the box. The crosstab is positioned at the left of the element box. The crosstab is positioned at the right of the element box. The crosstab is centered withing the element box. Crosstab parameter definition and value. Values from the report can only be accessed inside crosstab elements by passing them as parameters. Name of the parameter. Class of the parameter values. Crosstab parameter value expression. Crosstab dataset definition. Flag that indicates whether the crosstab data is already sorted according to the row bucket expressions and group bucket expressions (in this order).

The crosstab calculation engine can optimize the calculations if the data is sorted by the row groups and column groups. For example, if there are two row groups R1 and R2 (subgroup of R1) and three column groups C1, C2 and C3 the data should be sorted by R1, R2, C1, C2, C3. The calculation engine will assume that the data is presorted. If the data is not presorted, the outcome is undefined. The crosstab dataset data is not presorted. Crosstab cell that will be rendered at the upper-left corner of the crosstab.

The cell size will be calculated based on the row/column header cell widths/heights. Crosstab row group definition.

Each group in the crosstab has a variable that can be used inside the group header or inside the crosstab cells as the current group value. The variable has the same name as the group and the same type as the bucket expression of the group. Group name. The width of the row group header. The position of the total row for this group.

A group can have a total row summing the values for all the entries in the group. E.g. if there is a Year group having Month as a subgroup, the total row for the Year group would sum the values for all the years and the total row for the Month group would sum the values for all the months of an year. The total row will be displayed before the group rows. The total row will be displayed after the group rows. The total row will not be displayed. The position of the header contents on header span.

The row group headers stretch vertically by spanning when there are multiple sub group entries. This attribute determines the way the header contents will be adjusted to the new height. The contents will be rendered at the top of the header The contents will be rendered on the center of the header The contents will be rendered at the bottom of the header The contents will be proportionally stretched to the new header height Determines whether the header cell of this group spans across all rows in the group, or whether the header cell repeats for each sub group entry.

If the header cell is set to repeat, the sub group should not have a total row.

By default the header cell spans across all rows that are part of the group.

Crosstab row header definition.

The size of the row header cell is computed based on the following rules:

  • the width of the header is given by the width attribute of rowGroup
  • the height of the last row group header is given by the height of the base cell
  • the height of a non-last row group header is the sum of the next group header's height and the next group total header's height (0 if the next group doesn't have a total header)
Crosstab total row header definition.

The size of a row group total header is computed based on the following rules:

  • the width is the sum the widths of this and subsequent row groups
  • the height is the height of the base cell for this total row

The total row is only printed if the totalPosition attribute of the group is different than None. Crosstab column group definition.

Each group in the crosstab has a variable that can be used inside the group header or inside the crosstab cells as the current group value. The variable has the same name as the group and the same type as the bucket expression of the group. Group name. The height of the column group header. The position of the total column for this group.

A group can have a total column summing the values for all the entries in the group. E.g. if there is a Year group having Month as a subgroup, the total column for the Year group would sum the values for all the years and the total column for the Month group would sum the values for all the months of an year. The total column will be displayed before the group column. The total column will be displayed after the group column. The total column will not be displayed. The position of the header contents on header span.

The column group headers stretch horizontally by spanning when there are multiple sub group entries. This attribute determines the way the header contents will be adjusted to the new width. The contents will be rendered on the left side of the header The contents will be rendered on the center of the header The contents will be rendered on the right side of the header The contents will be proportionally stretched to the new header width Determines whether the header cell of this group spans across all columns in the group, or whether the header cell repeats for each sub group entry.

If the header cell is set to repeat, the sub group should not have a total column.

By default the header cell spans across all columns that are part of the group.

Crosstab column header definition.

The size of the column header cell is computed based on the following rules:

  • the height of the header is given by the height attribute of columnGroup
  • the width of the last column group header is given by the width of the base cell
  • the width of a non-last column group header is the sum of the next group header's width and the next group total header's width (0 if the next group doesn't have a total header)
Crosstab total column header definition.

The size of a column group total header is computed based on the following rules:

  • the height is the sum the heights of this and subsequent column groups
  • the width is the width of the base cell for this total column

The total column is only printed if the totalPosition attribute of the group is different than None. Per column group cell that will be rendered at the left of the corresponding row of column headers, potentially overlapping the crosstab header cell.

The width of the cell is the total width of row group headers, and the height is the height of the corresponding column header. Crosstab group bucketing information. Class of the bucket values. The bucket order type. The buckets will be sorted in ascending order by using the specified comparator or by the natural order if no comparator specified. The buckets will be sorted in descending order by using the specified comparator or by the natural order if no comparator specified. The buckets will preserve the order in which the data is fed to the crosstab. Crosstab group bucketing expression. Expression that provides order by values for group buckets. If not set, the bucket values as returned by bucketExpression are used to order the buckets.

The expression is evaluated in the context of the crosstab group and can reference measure variables, which evaluate to group totals.

Crosstab group bucket comparator expression.

The result of this expression is used to sort the buckets, in ascending or descending order. If the bucket has an order by expression, the comparator will be used to compare values as produced by that expression. If no comparator expression is specified, the natural order will be used.

Crosstab measure definition.

A measure is a value accumulated by the crosstab calculation engine and displayed in the crosstab data cells.

Each measure in the crosstab has a variable that can be used inside the data cells as the current measure value. The variable has the same name and type as the measure.

Variables representing totals at different levels are also available. The names of these variables are:

  • <Measure>_<Row/Column Group>_ALL - the total for the column/row group
  • <Measure>_<Row Group>_<Column Group>_ALL - the combined total for the column and row groups

For instance, if one defines "Year" and "Month" column groups, a "City" row group and a "Sales" measure, then:

  • Sales_Month_ALL will hold the total for all months (i.e. for one year)
  • Sales_City_Month_ALL will hold the total for all months (one year) and all cities
  • Sales_City_Year_ALL will hold the grand total
Measure name. The measure values class. The calculation type to be performed on the measure values. The name of a class that implements the net.sf.jasperreports.engine.fill.JRIncrementerFactory interface to use when creating the incrementer instance for this measure. Incrementers are objects that implement the net.sf.jasperreports.engine.fill.JRIncrementer interface and handle the incremental calculation performed on the measure's current value with every entry in the crosstab dataset. The percentage calculation type performed on this measure.

If percentage calculation is required, the value class should be one of the built-in supported percentage types or the percentage calculator class should be specified. The classes with built-in support are java.lang.Float, java.lang.Double, java.lang.Byte, java.lang.Short, java.lang.Integer, java.lang.Long, java.math.BigDecimal and java.math.BigInteger. The value will not be calculated as a percentage The value will be calculated as percentage of the grand total value The percentage calcualtor class name.

The class should implement the net.sf.jasperreports.crosstabs.fill.JRPercentageCalculator interface. No calculations are performed. The measure stores the number of the not null values. The measure stores the number of distinct not null values. The measure stores the sum of the not null values. Numeric measures only. The measure stores the average of the not null values. Numeric measures only. The measure stores the lowest value. The measure stores the highest value. The measure stores the standard deviation of the not null values. Numeric measures only. The measure stores the variance of the not null values. Numeric measures only. The measure stores the first value encountered and ignores subsequent values. Crosstab measure expression. Crosstab data cell definition.

A crosstab can have multiple data cells for row/groups totals. Attributes rowTotalGroup and columnTotalGroup are used to specify that the cell corresponds to a total row/column.

E.g. if the crosstab has Country and City (subgroup of Country) row groups and Year and Month column groups, one can specify the following cells:

  • no rowTotalGroup and columnTotalGroup - the crosstab base cell (total for a city and a year)
  • columnTotalGroup="Month" - total for a city and a year
  • columnTotalGroup="Year" - total for a city and all years
  • rowTotalGroup="City" - total for all cities of a country and a month
  • rowTotalGroup="City" columnTotalGroup="Month" - total for all cities of a country and a year
  • rowTotalGroup="City" columnTotalGroup="Year" - total for all cities of a country and all years
  • rowTotalGroup="Country" - total for all countries and a month
  • rowTotalGroup="Country" columnTotalGroup="Month" - total for all countries and a year
  • rowTotalGroup="Country" columnTotalGroup="Year" - grand total

If the data cell for a total row/column is not specified, the cell will be inherited from lower level cells, if possible. For example, if the "total for all countries and a year" cell is not specified, the "total for a country and a year" or "total for a city and a year" cell will be used (in this order).

The data cell sizes are calculated from the base data cell sizes, i.e. the height of all data cells for a row will be the height of the base cell of that row. The base cell sizes are also inherited, e.g. if the height of a total row is not specified the height of the base row will be used. Crosstab cell width.

The width should be specified only for the base cell of a column (the one with no rowTotalGroup). Crosstab cell height.

The height should be specified only for the base cell of a row (the one with no columnTotalGroup). If this cell corresponds to a total row, this attribute should specify the name of the corresponding row group. The attribute should not be specified if the cell corresponds to a base (not total) row. If this cell corresponds to a total column, this attribute should specify the name of the corresponding column group. The attribute should not be specified if the cell corresponds to a base (not total) column. Crosstab header or data cell contents.

There are some restrictions/rules regarding crosstab cells:

  • Subreports, crosstabs and charts are not allowed.
  • Delayed evaluation for text fields and images is not allowed.
  • Cells cannot split on multiple pages.
Crosstab cell background color.

The cell is filled with the background color only if the cell has opaque mode. Crosstab cell transparency mode. Name of the report level style to use (see style element).

The style is only used for cell background and borders and is not inherited by elements inside the cell. Crosstab cell that will be rendered when no data was fed to the crosstab.

If this cell is not specified for a crosstab, nothing will be rendered for an empty crosstab.

The cell size is the same as the crosstab element size. A frame is a report element that contains sub elements. It has a backgroud, a border and it stretches to accommodate its content.

For the Graphics2D and PDF exporters, a frame is equivalent to a rectangle placed behind a group of elements. The HTML exporter creates sub-tables for frames and the XLS exporter includes the frame sub elements into the grid.

For elements inside a frame, the coordinates, positionType and stretchType properties and relative to the frame instead of the band. Specifies the way the frame border is to be drawn when the frame element splits. When the frame splits, the bottom border of the first fragment and the top border of the second fragment are not drawn. When the frame splits, both fragments are drawn will borders and paddings on all sides. Defines a gantt chart Defines an gantt type dataset Defines a gantt series for a ganttDataset Specifies the expression used to determine tasks in a ganttSeries. Specifies the expression used to determine subtasks in a ganttSeries. Specifies the expression used to determine the percent in a ganttSeries. Indicates the specific <valueExpression> tag for generic element parameters. Unlike other <valueExpression> elements, it contains a class attribute. Class of the bucket values. The bucket order type. The buckets will be sorted in ascending order by using the specified comparator or by the natural order if no comparator specified. The buckets will be sorted in descending order by using the specified comparator or by the natural order if no comparator specified. No sorting of bucket values will be performed, the buckets will show in the order the values come from the dataset. Name of the bucket property.





© 2015 - 2024 Weber Informatics LLC | Privacy Policy