Difference between revisions of "Format an iReport Template"

From IMSMA Wiki
Jump to: navigation, search
(Conditional Display)
Line 17: Line 17:
  
 
==Conditional Display==
 
==Conditional Display==
* Null checks
+
Sometimes it is important to change the display of some data extracted from IMSMA for the resulting report. For example, you want to change:
 +
* the value “null” to “no”
 +
* the value “Male” to “Men”
 +
To do this, you use conditional statements in the element on the iReport.
  
 +
# Select the desired in the iReport template ('''note:''' this is '''NOT''' the field value, but rather the text element on the report displaying the field value)
 +
# On the '''Properties''' pane select the '''Text Expression''' and open the '''Text Expression Editor''''.
 +
#: [[Image:IReport Charts5.png|center|500px|''Text Expression Editor'']]<div align="center">''Text Expression Editor''</div>
 +
# To change the way a particular field is displayed you can use basic "ïf-then-else" logic as in other [[Summarize i-Report Template Data#Variable Expressions|Variable Expressions]]. This follows the pattern:
 +
$F{field} == null ? “Something" : $F{field}
 +
 +
Or nested:
 +
$F{field} == null ? “Something" : $F{field} == “SomethingElse” ? “Something Else“ : $F{field}
 +
 +
{{note| The type of field is important (string, float, double, int, date). Stick with strings if you can.}}
 +
 +
Example:
 +
$F{blockWater} == null ? “No value" : $F{blockWater}
  
 
==Adding Formatting Elements==
 
==Adding Formatting Elements==

Revision as of 00:38, 22 September 2013

iReport Designer provides many ways to format the appearance of an iReport template. These include the ability to:

  • add formatting elements to the iReport such as lines, rectangles, circles, etc
  • edit the position and size of elements on the iReport template relative to one another
  • change colors, fonts, and other properties
  • perform conditional displays based on data in the report

Conditional Display

Sometimes it is important to change the display of some data extracted from IMSMA for the resulting report. For example, you want to change:

  • the value “null” to “no”
  • the value “Male” to “Men”

To do this, you use conditional statements in the element on the iReport.

  1. Select the desired in the iReport template (note: this is NOT the field value, but rather the text element on the report displaying the field value)
  2. On the Properties pane select the Text Expression and open the Text Expression Editor'.
    Text Expression Editor
    Text Expression Editor
  3. To change the way a particular field is displayed you can use basic "ïf-then-else" logic as in other Variable Expressions. This follows the pattern:
$F{field} == null ? “Something" : $F{field}

Or nested:

$F{field} == null ? “Something" : $F{field} == “SomethingElse” ? “Something Else“ : $F{field}
Note.jpg The type of field is important (string, float, double, int, date). Stick with strings if you can.

Example:

$F{blockWater} == null ? “No value" : $F{blockWater}

Adding Formatting Elements

  • Adding lines

Formatting Tools

  • float vs fix relative

Working with Bands

Formatting Subreports, Charts, and Crosstabs

Template:NavBox HowTo use iReport