Changes

{{TOC right}} ==Editing Summarizing Summarising Report Data==__NOEDITSECTION__In addition to displaying report details in an iReport template, the iReport Designer allows creating summaries or calculations of data returned in the report. These can take the form of totals, sums, and counts (stored in variables), or more complicated data summaries such as crosstabs or charts. Because summarizing data necessarily depends on multiple records, data summaries must exist in bands ''after'' the Detail band such as the Summary band, Footer band, or Group Footer bands.

Totals, averages, and other summary data are typically found at the end of a grouping or at the end of a report. You may add If a section—or ''desired band'' as it is referred to in iReport—by doing not visible on the followingiReport Designer canvas: <ol><li>From # Select the desired band in the '''View''Report Inspector' menu, select '''Bands'''.</li>:The <FileName> bands… window displays. <li>Do one of the following:</li>*If you would like to add a footer at the end of a grouping, select # In the <''GroupAttribute''>Footer from the left pane where ''GroupAttribute'' is the name of the attribute on which the results will be grouped. For example, if you are creating a report on land and group the results by the priority, the name of the band would be priorityFooter.*If you would like to add a summary section, select 'Properties'summary'' from the left pane. <li>In the right pane, enter a numeric value in change the '''Band Height''' fieldproperty to something more than 0 (e. The height of the section may also be adjusted later.</li><li>Click the '''Apply''' buttong.</li>:The section is added to the report50). </ol>

<li>From the '''ViewReport Inspector''' menu, select '''Variables'''.</li>

[[Image:iRep22.png|center|500px|''Figure 22. REPORT_COUNT element in summary section'']]

''Figure 22. REPORT_COUNT element in summary section''

<olstart="4">

{{note|It may be helpful to add a text label beside any counts that you add to the report to identify the value. To add a text label, click drag the static text element [[Image:iRepText.png]] iconfrom the '''Palette''' pane. }}

iReport allows you to display the total of a particular attribute in the report. This is done by creating a variable to store the total value (see [[Modify an iReport Template#Adding a Variable to an iReport Template| Adding a Variable to an iReport]]).

<li>From the Library pane, click [[Image:iRepTotal.png]].</li></ol> {{note|If the Library pane is not displayed, display it by doing the following:<ol><li>From the '''ViewReport Inspector''' menupane, select choose '''Docking PanesVariables'''.</li><li>From the '''Docking Panes''' menu, select '''Library'''.</li></ol>}} <ol start="3"><li>Drag and drag the [[Image:iRepTotal.png]] variable to the footer or summary section of the report. If you drag it to the footer, the total for the values in the group will be calculated. If you drag it to the summary, the total for all values will be calculated.</li>:A window displays to allow you to select the object to sum.</ol> [[Image:iRep23.png|center|500px|''Figure 23. Window to select object to sum'']]<div align="center">''Figure 23. Window to select object to sum''</div> <ol><li>Double-click ''Fields''.</li><li>Click the name of the attribute that you would like to sum.</li><li>Click the '''OK''' button.</li>

===Creating Custom Variables===__NOEDITSECTION__In addition to the built-in functions to calculate the number of records and the sum of a field, iReport also allows you to define a other types of variablecalculations. A variable is a named object that stores the result of a calculation. iReport allows you to define new variables and how those variables should be calculated. For example, you may define a variable that calculates the average for a particular field such as the area size. Or, you may wish to display the maximum value of a field. In these situations, you may define a custom variable.

<ol><li>From # Follow the '''View''' menu, select '''Variables'''.</li><li>Click the '''New''' button.</li>:The Add/modify variable window displays.</ol> steps to [[Image:iRep24.pngModify an iReport Template#Adding a Variable to an iReport Template|center|500px|''Figure 24. Add/modify add a variable window''to an iReport]]<div align="center">''Figure 24. Add/modify variable window''</div> <ol start="3"><li>In the '''Variable Name''' field, enter a name for the variable. You should provide a name that is meaningful and indicative of what the value returns.</li><li># From the '''Variable Class Calculation Type''' list, select the data type of the resulting value. The variable class type will depend on the field that you are using in the calculation.</li></ol> {{note|To determine the class type of a field:<ol><li>Right-click the field element in the report pane.</li><li>Select '''Properties'''.</li><li>Select the '''Text Field''' tab.</li>:The class type will be displayed in the '''Text Field Expression Class''' field. </ol>}} <ol start="5"><li>From the '''Calculation Type''' listpane, select the calculation that you would like to perform.</li></ol>

| align="center" colspan="2" | '''Table 4. Calculation types'''

<ol start="63">

| align="center" colspan="2" | '''Table 5. Reset Types'''

<ol start="74">

<ol start="85"><li>From the '''Increment Type''' list, select the increment at which the value will need to be evaluated. It is useful when you want to calculate sub-totals.</li><li>From the '''Increment Group''' list, select the group at which the variable will be incremented.</li><li>The '''Variable Expression''' field specifies the expression that will be provided to the variable. Typically, this will be the value of a field in the report. To specify a field in the report:</li><ol type="a"><li>Click the [[Image:iRepEditor.png]] button that is displayed beside edit the '''Variable Expression''' field.</li>[[Image:The Expression editor window displaysIReport VariableAdd5.<li>From the Objects and expressions tab, select png|center|500px|''Variable Expression Editor'Fields''' from the left pane.]]</lidiv align="center"><li>From the middle pane at the bottom of the Expression editor window, double-click the name of the field that you would like to use in the calculation.</li><li>Click the '''Apply''' button.</li>:The Expression editor window closes. The Add/modify variable window displays the selected field in the Variable Expression field. <li>Click the '''OKEditor''' button.</lidiv>:The Add/modify variable window closes and the variable that you just added is listed as a variable in the Library pane.</olli>

{{note|If In addition to the summary functions available on the Library pane is not displayedvariable, display it by doing specific expressions can be used in the followingExpression Editor to define values. For example:<ol>{| class="wikitable" width="600" align="center"<li>From the |-| align="center" colspan="2" | '''ViewExpression Operations''' menu, select |-| width="150pt" | '''Docking PanesOperation'''.</li><li>From the | width="450pt" | '''Docking Panes''' menu, select '''LibraryExpression'''|-| Division || $F{areaSize}/$V{REPORT_COUNT}|-| Addition || $F{areaSize} + 500.</li>0|-| Subtraction || $F{areaSize} - $P{ClearedArea}|-| Multiplication || $F{areaSize} * $V{REPORT_COUNT}|-</ol>| Concatenation (string only)|| $F{localId} + $P{LocationName}|}

???In addition to summary variables, iReport provides the capability to build crosstab tables that display data in a grid for easy analysis and summary. Crosstabs allow you to choose data rows, columns, and the variable to be measured and then automatically produce a grid of results for display in a chart. As with other summary variables Crosstabs are generally used in the '''Summary Band''' in a report.  To create a Crosstab:# In the '''Palette''' pane, drag a '''Crosstab''' item to the Summary Band of the report.# The Crosstab wizard displays#: [[Image:IReport Crosstab1.png|center|500px|''Crosstab wizard'']]<div align="center">''Crosstab wizard''</div># Select the '''Field''' to use in the '''Row''' of the Crosstab grid.#: [[Image:IReport Crosstab2.png|center|500px|''Crosstab wizard'']]<div align="center">''Crosstab wizard''</div># Select the '''Field''' to use in the '''Column''' of the Crosstab grid.#: [[Image:IReport Crosstab3.png|center|500px|''Crosstab wizard'']]<div align="center">''Crosstab wizard''</div># Select the '''Field''' or '''Variable''' to use to represent the data in the grid. Typically this is a numeric field (e.g. areaSize) or if a count of the records is desired, the ''REPORT_COUNT'' variable.#: [[Image:IReport Crosstab4.png|center|500px|''Crosstab wizard'']]<div align="center">''Crosstab wizard''</div># Finalise the Crosstab display.#: [[Image:IReport Crosstab5.png|center|500px|''Crosstab wizard'']]<div align="center">''Crosstab wizard''</div># The Crosstab displays.#: [[Image:IReport Crosstab6.png|center|500px|''Crosstab wizard'']]<div align="center">''Crosstab wizard''</div> The report can now be run or additional adjustments to the report can be made including resizing columns and rows, number formatting, or display adjustments.[[Image:IReport Crosstab7.png|center|500px|''Crosstab Preview'']]<div align="center">''Example Crosstab Preview''</div> 

*#At least one grouping. The report groupings are used by iReport to determine what fields may be plotted. See [[Modify an iReport Template|Modify an iReport Template]] for more information on [[Modify an iReport Template#Grouping|grouping]].*#At least one variable that contains a calculation. This calculation may be a count, total, or other custom calculation. These calculated variables define the size of the chart segment. The '''Reset type''' of this calculation should be set to '''Group''' and use the report grouping defined in #1. See [[Modify_an_iReport_Template|Modify an iReport Template]] for more information on [[Modify_an_iReport_Template#To_add_a_variable_manually|adding variables]].

{{note|The sample report ''====Add a Pie Chart Sample.jrxm l''in the <''iReport Installation Directory''>\iReports_IMSMA\IMSMA reports directory provides an example of a report that includes a pie chart.}}====__NOEDITSECTION__

<ol><li>#Create a report which groups the results by the attribute on which you would like to base your chart(e.g. ''status'').</li><li>After creating #Ensure that the Summary Band is available on the report, you should add iReport template canvas.#[[Modify_an_iReport_Template#Adding a Variable to an iReport Template|Create a footer for Variable]] to contain the attribute on which values to be displayed in the results will be groupedchart (e.g. ''SUM_areaSize_byStatus''). This footer will variable should be used based on a numeric field (e.g. ''areaSize'') and should have the '''Reset type''' set to '''Group''' and the group selected set to the field you wish to display create the total for chart from'' (e.g. ''status'').#Select the '''Chart''' option from the '''Palette''' pane and drag it to the '''Summary Band''' of the report template to start the group that will subsequently be used in '''Chart Wizard'''.#Select one of the pie chartoptions. To add a group footer#:[[Image:iReport Charts1.png|center|500px|''Chart options'']]<div align="center">''Chart options''</lidiv>#Choose Main report dataset.#:[[Image:iReport Charts2.png|center|500px|''Chart options'']]<ol typediv align="acenter">''Chart options''<li/div>From # The next step is to provide the correct data for the chart to use. Pie Charts require a '''Viewunique identifier''' menu, select and a '''Bandsnumeric'''value where the unique identifier is the field to group the data by (i.e. the names of the wedges) and numeric value is the value to sum.</li>#:The <FileName> bands… window displays[[Image:iReport Charts3. png|center|500px|''Chart options'']]<lidiv align="center">Select <''GroupAttributeChart options''</div>Footer from # To select the left pane where ''GroupAttribute'unique value''' is choose the name of '''Expression editor''' button and '''choose the attribute on which ''field'' the results report is grouped by''' (e.g. ''status''). Note that charts in iReport will be groupedfail if the '''unique value''' is null. For exampleIn order to account for null values, if you will need to modify the expression so that null values are creating a report on land and grouped into their own group . The expression should be modified to include the results by the priority, the name of the band would be bolded text below.#: '''$F{status} == null ? "N/A" : $F{status}'priorityFooter''#:[[Image:iReport Charts5.png|center|500px|''Set Unique Value'']]<div align="center">''Set Unique Value''</lidiv><li>In #Next, select the right pane, enter a '''numeric value ''' that contains the desired numeric data for the chart. '''Note: This should always be the variable created in the Band Height fieldstep 3 above''' (e.g. ''SUM_areaSize_byStatus''). #:[[Image:iReport Charts6. You may adjust png|center|500px|''Select the height of desired numeric variable'']]<div align="center">''Select the summary.desired numeric variable''</lidiv><li>Click the #Choose '''ApplyNext''' button.#:[[Image:iReport Charts7.png|center|500px|''Chart Wizard Completed'']]</lidiv align="center">''Chart Wizard Completed''</oldiv><li>Add a summary section to # Choose '''Finish''' and the iReport template displays with the reportChart.</li><li>Click the #:[[Image:iRepBarChartiReport Charts8.png|center|500px|''iReport displays with Chart'']] icon.<div align="center">''iReport displays with Chart''</lidiv><li>In the summary section of the # The report, hold down the mouse button and drag the cursor can now be previewed to form the rectangle which will contain the chartensure it is functioning as expected.</li>#:[[Image:A window of the various chart options displaysiReport ChartsPreview.png|center|500px|''Preview with Chart'']]<lidiv align="center">Select one of the pie ''Preview with chart options.''</lidiv></ol>====Modify a Pie Chart====__NOEDITSECTION__Once a chart has been created in iReport Designer, its properties can be edited by selecting the '''Chart Data''' option on the right click menu and adjusting the values and properties.

To modify a chart:# Right click on the chart in iReport Designer and select '''Chart Data''' from the menu.# The Chart details window displays.#: [[Image:iRep26IReport ChartData1.png|center|500px|''Figure 26. Pie chart optionsChart Data Properties'']]<div align="center">''Chart Data Properties''</div># To edit the main properties of the chart, select the '''Details tab'''Figure 26. Pie Additionally, this screen can be used to edit the reset type of the chart which is relevant if the chart optionsis displayed on a band other than the summary band.# The '''Chart Details''' window displays.#: [[Image:IReport ChartData2.png|center|500px|''Chart Data Properties'']]<div align="center">''Chart Data Properties''</div># In this window, the basic properties of the chart that were established in the Chart Wizard can be edited. These include:#* '''Key Expression''': the field used to group data for charting purposes. To change the field, simply select another field. '''Note:''' The field must be used in the creation of the variable used in the value expression or the results will be incorrect.#* '''Value Expression''': the variable used to store the data to be displayed in the chart. If changes are made this value it is recommended to edit the variable properties as well.#* '''Label Expression''': the area used to define the labels for the chart. Any valid expression can be used here. See [[Summarize iReport Template Data#Variable Expressions|Variable Expressions]] for more details.

{{note|The sample report ''====Add a Bar Chart Sample.jrxm l''in the <iReport Installation Directory>\iReports_IMSMA\IMSMA reports directory provides an example of a report that includes a bar chart.}}====__NOEDITSECTION__

<ol><li>#Create a report which groups the results by the attribute on which you would like to base your chart(e.</li>g. ''status'')<li>After creating #Ensure that the report, you should add a footer for Summary Band is available on the attribute on which the results will be groupediReport template canvas. This footer will be used #[[Modify_an_iReport_Template#Adding a Variable to an iReport Template|Create a Variable]] to display contain the total for values to be displayed in the group that will subsequently be used in the pie chart(e.g. To add a group footer:</li><ol type="a"><li>From the ''SUM_areaSize_byStatus'View'). This variable should be based on a numeric field (e.g. ''areaSize'' menu, select ) and should have the '''BandsReset type'''.</li>:The <FileName> bands… window displays. <li>Select <set to '''GroupAttributeGroup'''>Footer from and the left pane where ''GroupAttribute'' is group selected set to the name of field you wish to create the attribute on which the results will be groupedchart from'' (e.g. For example, if you are creating a report on land and group ''status'').#Select the results by the priority, '''Chart''' option from the name of the band would be ''priorityFooter'Palette'''.</li><li>In the right pane, enter a numeric value in and drag it to the '''Summary Band Height field. You may adjust the height ''' of the summary</li><li>Click report template to start the '''ApplyChart Wizard''' button.</li></ol>#Select one of the bar chart options.<li>Add a summary section to the report.</li><li>Click the #:[[Image:iRepBarChartIReport BarChart.png|center|500px|''Chart options'']] icon.</li>div align="center">''Chart options''<li/div>In the summary section of the #Choose Main report, hold down the mouse button and drag the cursor to form the rectangle which will contain the chartdataset.#:[[Image:IReport BarChart_Step1.</li>:A window of the various chart png|center|500px|''Chart options displays.'']]<lidiv align="center">Select one of the bar chart ''Chart options.''</lidiv><li>Click the # Provide a '''OKSeries Expression''' button.</li><li>Right-click anywhere on the chart.</li><li>Select the '(''Chart Propertiesoptional''' option).</li><li>From the #:[[Image:iReport Chart Properties window, select the Chart Data tab.</li><li>From the Chart Data tab, select the Details tabBar1.png|center|500px|''Series Expression'']]</li><lidiv align="center">Click the ''Series Expression'Add''' button.</li</div>:The Chart Properties window displays. By default, the Data tab should be selected. <li># The Series Expression allows you to define an added level of detail to your bar chart(if desired). To enter select the series expression value:</li><ol type="a"><li>Click '''Series''' choose the [[Image:iRepEditor.png]] icon that is displayed beside '''Expression editor''' button and '''choose one of the Key Expression field.</li>:The Expression editor window displays''fields'' the report is grouped by''' (e.g.<li>From the bottom pane, double-click the name of the attribute ''status''). Note that contains the data that you would like to include charts in iReport will fail if the chart.</li>:The expression to represent the attribute displays in the top pane'''Series''' value is null.<li>In order to account for null values, you will need to modify the expression so that null values are grouped into their own group. The expression should be modified to include the bolded text below. You should replace attribute with the field the name of the attribute field that you selected in step b above.</li> #: '''$F{''attribute''status} '''!== null ? "N/A" : $F{attributestatus} : "Unknown"'''<li>Click the #:[[Image:iReport Charts5.png|center|500px|''Set Series Value'Apply']]<div align="center">''Set Series Value'' button.</li></oldiv>#: The expression that you enter in the Series Expression field will vary based on how you want the horizontal axis to appear:#*If you would like the horizontal axis of the bar chart to reflect a single attribute such as the chart displayed below, the Series Expression will be the same as the Category expression.</ol> #:[[Image:iRep30.png|center|500px|''Figure 30. Bar chart –Single attribute y-axis'']]<div align="center">''Figure 30. Bar chart –Single attribute y-axis''</div> <ol>#*If you would like the horizontal axis of the bar chart to reflect the values of an additional attribute, the Series Expression would be the expression for the secondary level of detail. In the example shown below, the x-axis reflects the land priorities (e.g., Low, Medium, or High). In addition to displaying the priority, the bars of the chart use a different colour to reflect those land which block water access (red) vs. those that do not block the water (blue). </ol> #:[[Image:iRep31.png|center|500px|''Figure 31. Bar chart with different series expression'']]<div align="center">''Figure 31. Bar chart with different series expressionExpression''</div>#* '''Finally, the Series value can be left blank if desired.'''<ol># The Chart Properties window for this bar chart next step is shown belowto provide the correct data for the chart to use. Notice that the series Bar charts require a '''category expression ''' and category a '''value expression differ.</ol> [[Image:iRep32.png|center|500px|''Figure 32. Chart Properties – Different series ' where the value expression is a field to group the data by (i.e. the names of the X axis) and category expressions'']]value expression is the value to sum. <div #:[[Image:iReport Chart Bar2.png|center|500px|''Category and Values'']]<div align="center">''Figure 32. Chart Properties – Different series Category and category expressionsValues''</div> <ol>*If you selected one of # To select the stacked bar chart options, the series '''category expression will be used to determine ''' choose the segments of each bar. In '''Expression editor''' button and '''choose one of the following figure, ''fields'' the series expression creates red and blue segments in each bar to indicate whether or not water access is blockedreport is grouped by''' (e.</ol> [[Image:iRep33g.png|center|500px|''Figure 33status''). Stacked bar chartNote that charts in iReport will fail if the '']]<div align="center">'category expression'Figure 33. Stacked bar chart''</div> <ol start="14"><li>The Category Expression is the major grouping of the horizontal axisnull. To enter In order to account for null values, you will need to modify the category expression:</li><ol type="a"><li>Click the [[Image:iRepEditorso that null values are grouped into their own group.png]] icon that is displayed beside The expression should be modified to include the bolded text below. You should replace field with the Category expression fieldthat you selected above.</li>#:The Expression editor window displays.'''$F{status} == null ? "N/A" : $F{status}'''<li>From the bottom pane, double-click the name of the attribute that contains the data that you would like to include in the chart.#:[[Image:iReport Charts5.png|center|500px|''Set Category Expression'']]<div align="center">''Set Category Expression''</lidiv>:The expression to represent #Next, select the attribute displays in '''value expression''' that contains the top pane.<li>In order to account desired numeric data for null values, you will need to modify the expression so that null values are grouped into their own groupchart. The expression '''Note: This should always be modified to include one of the bolded text below. You should replace attribute with the name of the attribute that you selected in variables created in step b 3 above.</li>$F{''attribute' (e.g. ''} 'SUM_status_byAreaSize''!= null ? $F{attribute} ). #:[[Image: "Unknown"iReport Charts6.png|center|500px|''Select the desired value expression'']]<lidiv align="center">Click the ''Select the desired value expression'Apply''' button.</lidiv></ol><li>The # Choose '''Finish'''Value Expression''' field contains and the expression that returns iReport template displays with the numeric value for the keyChart.</li><ol type="a"><li>Click the [[#:[[Image:iRepEditoriReport Chart Bar3.png|center|500px|''iReport displays with Chart'']] icon that is displayed beside the Value Expression field.<div align="center">''iReport displays with Chart''</lidiv>:# The Expression editor window displaysreport can now be previewed to ensure it is functioning as expected.<li>From the Objects and expressions tab, select #:[[Image:iReport Chart BarPreview.png|center|500px|''Preview with Chart'Variables''' from the left pane.]]</lidiv align="center"><li>From the middle pane at the bottom of the Expression editor window, double-click the name of the variable that was created to store the total.</li><li>Click the '''Apply''' button.</li></ol><li>Click the '''OK''' button.</li>:The Chart Properties window closes.<li>Click the '''Close''' button.</li>:The Chart Properties window closes.<li>Save the report by either clicking the [[Image:iRepSave.png]] icon, or by selecting the '''Save''' option from the '''File''' menu.</li></ol> ===Grouped Bar Chart===__NOEDITSECTION__The horizontal axis of the bar charts discussed in the previous section compared the values of a single variable. For example, the bar chart below compares the number of different activity types.  [[Image:iRep34.png|center|500px|''Figure 34. Bar chart comparing values of a single variable'']]<div align="center">''Figure 34. Bar chart comparing values of a single variable''</div> In this section, you will learn how to create a grouped bar chart. A grouped bar chart compares the values of a single variable in one group to the same variables in another group. In the example below, the grouped bar chart still compares the number of activity types. However, the chart also compares the number of activity types between the districts. The number of activity types (clearance, impact survey, technical survey, and road clearance) are represented by the different bar colours as indicated in the legend. The coloured bars are clustered together based on their district. The first cluster of bars shows the number of activity in the Bolikon district. The second cluster of bars shows the number of activities in the Waltern district. [[Image:iRep35.png|center|500px|''Figure 35. Grouped bar chart comparing values of a single variable'']]<div align="center">''Figure 35. Grouped bar chart comparing values of a single variable''</div> The two main differences between adding a bar chart and a grouped bar chart are:*The grouped bar chart requires that you specify at least two groupings for the report. *The key expression and the category expression will differ; whereas, for a bar chart, the value for these expressions is the same.  To add a grouped bar chart to the report:<ol><li>Create a report which groups the results by the fields that will be represented on the horizontal axis of the chart.</li></ol> {{note|For a grouped bar chart, you will need to specify at least two groupings.}} <ol start="2"><li>Add any variables that you may need to calculate the value that you would like to show on the chart.</li><li>If you would like to display the calculated variable for each group, you should add the footer for the field on which the results will be grouped. This footer will be used to display the variable for the group that will subsequently be used in the chart. To add a group footer:</li><ol type="a"><li>From the '''View''' menu, select '''Bands'''.</li>:The <FileName> bands… window displays. <li>Select <''GroupFieldName''>Footer from the left pane where ''GroupFieldNameis'' the name of the field on which the results will be grouped. For example, if you are creating a report on land and group the results by the priority, the name of the band would be ''priorityFooter''.</li><li>In the right pane, enter a numeric value in the Band Height field. You may adjust the height of the summary.</li><li>Click the '''Apply''' button.</li><li>Add a summary section to the report.</li></ol><li>Click the [[Image:iRepBarChart.png]] icon.</li><li>In the summary section of the report, hold down the mouse button and drag the cursor to form the rectangle which will contain the chart.</li>:A window of the various chart options displays.<li>Select one of the bar chart options.</li></ol> [[Image:iRep36.png|center|500px|''Figure 36. Bar chart options'']]<div align="center">''Figure 36. Bar chart options''</div> <ol start="8"><li>Click the '''OK''' button.</li><li>Right-click anywhere on the chart.</li><li>select the '''Chart Properties''' option.</li><li>From the Chart Properties window, select the Chart Data tab.</li><li>From the Chart Data tab, select the Details tab.</li><li>Click the '''Add''' button.</li>:The Chart Properties window displays. By default, the Data tab should be selected. <li>For a grouped bar chart, the series expression contains the field whose distinct values you would like to show via different colours on the bar chart.</li></ol> [[Image:iRep37.png|center|500px|''Figure 37. Bar chart series expression'']]<div align="center">''Figure 37. Bar chart series expression''</div> To enter the series expression:<ol start="15"><ol type="a"><li>Click the [[Image:iRepEditor.png]] icon that is displayed beside the Key Expression field.</li>:The Expression editor window displays.<li>From the bottom pane, double-click the name of the field that contains the data that you would like to include in the chart.</li>:The expression to represent the field displays in the top pane.<li>Click the '''Apply''' button.</li></ol><li>The Category Expression is the field by which the series expression is grouped together.</li></ol> [[Image:iRep38.png|center|500px|''Figure 38. Bar ''Preview with chart category expression'']]<div align="center">''Figure 38. Bar chart category expression''</div>

To enter the category expression:<ol start="16"><ol type="==Modify a">Bar Chart====__NOEDITSECTION__<li>Click the [[Image:iRepEditor.png]] icon that is displayed beside the Category expression field.</li>:The Expression editor window displays.<li>From the bottom pane, double-click the name of the field that contains the data that you would like to include in the Once a bar chart.</li>:The expression to represent the field displays has been created in the top pane.<li>Click the '''Apply''' button.</li></ol><li>The '''Value Expression''' field contains the variable that returns the numeric value that will iReport Designer, its properties can be represented on the chart.</li> <ol type="a"><li>Click the [[Image:iRepEditor.png]] icon that is displayed beside the Value Expression field.</li>:The Expression editor window displays.<li>From the Objects and expressions tab, select '''Variables''' from the left pane.</li><li>From the middle pane at the bottom of the Expression editor window, double-click the name of the variable that you would like to represent on the chart.</li><li>Click edited by selecting the '''Apply''' button.</li></ol><li>Click the '''OK''' button.</li>:The Chart Properties window closes.<li>Click the ''Data'Close''' button.</li>:The Chart Properties window closes.<li>Save the report by either clicking the [[Image:iRepSave.png]] icon, or by selecting the Save option from on the '''File''' right click menuand adjusting the values and properties.</li></ol>

{{note|iReport requires you to save the report after adding or changing To modify a bar chart.}} <ol start="20"><li>Click the [[Image:iRepCompile.png]] button to compile the report.</li><li>Click # Right click on the [[Image:iRepRun.png]] button to execute chart in iReport Designer and select '''Chart Data''' from the reportmenu.</li></ol> ===Stacked Bar # The Chart===__NOEDITSECTION__Data properties display.A stacked bar # To edit the main properties of the chart is similar , select the '''Details tab'''. Additionally, this screen can be used to a grouped bar in that it allows you to represent two different fields on edit the reset type of the chart. The key difference which is that relevant if the stacked bar chart layers is displayed on a band other than the values of the series expression (the field represented in the legend) allowing you to easily compare the categories to one anothersummary band. # The '''Chart Details''' window displays#: [[Image:iRep39IReport Chart Bar ChartData1.png|center|500px|''Figure 39. Stacked bar chartChart Data Properties'']]<div align="center">''Figure 39. Stacked bar chartChart Data Properties''</div> To add a grouped bar chart to the report:<ol><li>Create a report which groups the results by the fields that will be represented on the horizontal axis of the chart.</li></ol> {{note|# For a stacked bar chart, you will need to specify at least two groupings.}} <ol start="2"><li>Add any variables that you may need to calculate the value that you would like to show on the chart.</li><li>If you would like to display the calculated variable for each group, you should add the footer for the field on which the results will be grouped. This footer will be used to display the variable for the group that will subsequently be used in the chart. To add a group footer:</li><ol type="a"><li>From Bar Charts this presents the '''View''' menu, select '''BandsCategory Series'''chooser.</li>:The <FileName> bands… window displays. <li>Select <''GroupFieldName''>Footer from the left pane where ''GroupFieldName'' is the name of the field on which the results Typically there will be grouped. For example, if you are creating a report on land and group the results by the priority, the name of the band would only one or two series to choose from here though more can be ''priorityFooter''added at this point.</li> <li>In the right pane, enter a numeric value in Select the series to modify and choose '''Band HeightModify''' field. You may adjust the height of the summary</li><li>Click the '''Apply''' button.</li></ol><li>Add a summary section to the report.</li><li>Click the [[Image:iRepBarChart.png]] icon.</li><li>In the summary section of the report, hold down the mouse button and drag the cursor to form the rectangle which # The Chart Data properties window will contain the chart.</li>display#:A window of the various chart options displays.<li>Select one of the stacked bar chart options.</li></ol> [[Image:iRep40IReport Chart Bar ChartData2.png|center|500px|''Figure 40. Stacked bar chart optionsChart Data Properties'']]<div align="center">''Figure 40. Stacked bar chart options''</div> <ol start="8"><li>Click the '''OK''' button.</li><li>Right-click anywhere on the chart.</li><li>Select the '''Chart Data Properties''' option.</lidiv><li>From the Chart Properties # In this window, select the Chart Data tab.</li><li>From basic properties of the bar chart that were established in the Chart Data tab, select the Details tab.</liWizard can be edited.These include:<li>Click the #*'''AddSeries Expression''' button.</li>:The Chart Properties window displays. By default, the Data tab should be selected. <li>For a stacked bar chart, the series expression contains the fields whose distinct value.</li> <li>For a grouped bar chart, the series expression contains the field whose distinct values you would like used to show via different colours on the bar chartfirst group data for charting purposes. To enter the series expression:</li><ol type="a"><li>Click the [[Image:iRepEditor.png]] icon that is displayed beside change the Key Expression field.:The Expression editor window displays.</li><li>From the bottom pane, double-click the name of the simply select another field that contains the data that you would like to include in the chart.</li>:The expression to represent the field displays in the top pane.<li>Click the '''ApplyNote:''' button.</li></ol><li>The Category Expression while this field is the field required it can be made blank or fixed by which the series expression is grouped together. To enter the category expressionbeing set to a constant such as:</li><ol type="a">or "Blank".<li>Click the [[Image:iRepEditor.png]] icon that is displayed beside the #*'''Category expression field.</vli>Expression''':The Expression editor window displays.<li>From the bottom pane, double-click the name of the field that contains the used to group data that you would like to include in the chartfor charting purposes.</li>The expression to represent To change the field displays in the top pane, simply select another field.<li>Click the Apply button.</li></ol><li>The '''Value ExpressionNote:''' The field contains must be used in the creation of the variable that returns used in the numeric value that expression or the results will be represented on the chartincorrect.</li><ol type="a"><li>Click the [[Image:iRepEditor.png]] icon that is displayed beside the Value Expression field.</li>:The Expression editor window displays.<li>From the Objects and expressions tab, select #* '''VariablesValue Expression''' from : the left pane.</li><li>From variable used to store the middle pane at the bottom of the Expression editor window, double-click the name of the variable that you would like data to represent on be displayed in the chart.</li><li>Click If changes are made this value it is recommended to edit the '''Apply''' buttonvariable properties as well.</li></ol><li>Click the #* '''OKLabel Expression''' button.</li>:The Chart Properties window closes.<li>Click the '''Close''' button.</li>:The Chart Properties window closes.<li>Save area used to define the report by either clicking labels for the [[Image:iRepSavechart.png]] icon, or by selecting the '''Save''' option from the '''File''' menuAny valid expression can be used here.</li> <li>Click the See [[Image:iRepCompile.pngSummarize iReport Template Data#Variable Expressions|Variable Expressions]] button to compile the report.</li><li>Click the [[Image:iRepRunfor more details.png]] button to execute the report.</li></ol>

{{NavBox HowTo use iReportStandardizing Data Analysis and Information Reporting}}[[Category:VIE]]