Changes

Jump to: navigation, search

Summarize iReport Template Data

8,460 bytes removed, 15:04, 13 November 2015
no edit summary
__FORCETOC__
{{TOC right}}
{{HowTo's
|[[Start and Configure i-Report|Start and Configure i-Report]]
|[[Create a Basic i-Report Template|Create a Basic i-Report Template]]
|[[Modify an iReport Template|Modify an iReport Template]]
|[[Format an iReport Template|Format an iReport Template]]
|[[Create i-Report Templates with Subreports|Create i-Report Templates with Subreports]]
|[[Summarize i-Report Template Data|Summarize i-Report Template Data]]
}}
==Summarizing Summarising Report Data==__NOEDITSECTION__In addition to displaying report details in an iReport template, the iReport Designer allows you create creating summaries or calculations of data returned in the report. These can take the form of totals, sums, and counts (stored in Variablesvariables), or more complicated data summaries such as Crosstabs crosstabs or Chartscharts. Because summarizing data necessarily depends on multiple records, data summaries must exist in bands ''after'' the Detail band such as the Summary band, Footer badband, or Group Footer bands.
===Adding a Footer or Summary Section to the Report===__NOEDITSECTION__
Totals, averages, and other summary data are typically found at the end of a grouping or at the end of a report. If a desired band is not visible on the iReport Designer canvas:
# Select the desired band in the '''Report Inspector'''
# In the '''Properties''' pane, change the '''Band Height''' property to something more than 0 (e.g. 50).
===Displaying Counts===__NOEDITSECTION__
iReport has a built-in variable for calculating the number of records in a report and the number of records in each group if the report contains groups. The number of records in the report is stored in the REPORT_COUNT variable. The number of records in each group is stored in the <''GroupField''>_COUNT where GroupField is the name of the field on which the group is created.
</ol>
[[Image:iRep22.png|center|500px|''Figure 22. REPORT_COUNT element in summary section'']]
<div align="center">
''Figure 22. REPORT_COUNT element in summary section''
</div>
{{note|If the REPORT_COUNT element is dragged to a section of the report other than the summary, the value returned by the REPORT_COUNT variable will be determined by where it is placed. For example, if the REPORT_COUNT is placed in the pageFooter section, the value returned will be the number of records displayed so far.}}
<olstart="4">
<li>To display the number of records in each group, drag the <GroupName>_COUNT variable to the <''GroupName''>Footer section.</li>
</ol>
{{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. }}
===Displaying Totals===__NOEDITSECTION__
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]]).
To create a custom variable:
# Follow the steps to [[Modify an iReport Template#Adding a Variable to an iReport Template| add a variable to an iReport]].
# From the '''Calculation Type''' list in the '''Properties''' pane, select the calculation that you would like to perform.
{| class="wikitable" width="600"
|-
| align="center" colspan="2" | '''Table 4. Calculation types'''
|-
| width="150pt" | '''Calculation type'''
|-
| System || No calculation is made. Instead the last value is stored.
|-
| First || No calculation is made. Instead the first value is stored.
|}
</center>
{| class="wikitable" width="600"
|-
| align="center" colspan="2" | '''Table 5. Reset Types'''
|-
| width="150pt" | '''Reset Type'''
<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 edit the '''Variable Expression''' field.
[[Image:IReport VariableAdd5.png|center|500px|''Variable Expression Editor'']]<div align="center">''Variable Expression Editor''</div></li>
</ol>
In addition to the summary functions available on the variable, specific expressions can be used in the Expression Editor to define values. For example:
{| class="wikitable" width="600" align="center"
|-
| align="center" colspan="2" | '''Table 5. Reset TypesExpression Operations'''
|-
| width="150pt" | '''Operation'''
| Concatenation (string only)|| $F{localId} + $P{LocationName}
|}
</center>
==Crosstabs==__NOEDITSECTION__
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'']]</oldiv align="center">''Example Crosstab Preview''</oldiv>
==Crosstabs==???==Charts==__NOEDITSECTION__
Charts provide a visual representation of the report data. Before you add a chart to your report, you should ensure that your report contains the following:
*#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]].
===Pie Chart===__NOEDITSECTION__
{{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__
To add a pie chart to the report:
<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.
<ol start="7">
<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>The Section Value tab should be selected by default. If it is not, select it.</li>
<li>The '''Key Expression''' defines the various slices of the pie chart. This will typically be each unique value for an attribute. For example, if the chart were to contain the total area size of land with a particular priority, the Key Expression would return the unique values for priority (e.g., Low, Medium, or High). To enter the key expression value:</li>
<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 attribute that contains the data that you would like to include in the chart.</li>
:The expression to represent the attribute displays in the top pane.
<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 name of the attribute that you selected in step b above.</li>
:$F{''attribute''} '''!= null ? $F{''attribute''} : "Unknown"'''
<li>Click the '''Apply''' button.</li>
</ol>
<li>The '''Value Expression''' field contains the expression that returns the numeric value for the key. For example, it may be the total land size of high priority land.</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 was created to store the total.</li>
<li>Click the '''Apply''' button.</li>
</ol>
<li>The '''Label Expression''' field contains the expression that is used to determine the label for the segment of the pie chart. Because this expression will most likely be the same as the one used in the '''Key Expression''', you can copy the expression from the Key Expression field and paste it into the '''Label Expression''' field.</li>
<li>The following figure is an example of the Chart Properties window for a report that contains a pie chart which graphs the total area size of land based on their priority.</li>
 
</ol>
 
[[Image:iRep27.png|center|500px|''Figure 27. Chart Properties'']]
<div align="center">
''Figure 27. Chart Properties''
</div>
 
<ol start="17">
<li>Click the '''Close''' button</li>
:The Chart Properties window closes.
<li>Save the report by either clicking the icon, or by selecting the '''Save''' option from the '''File''' menu.</li>
</ol>
 
Below is an example of a report template that totals the area size of land by priority.
 
[[Image:iRep28.png|center|500px|''Figure 28. Sample report template with pie chart'']]
<div align="center">
''Figure 28. Sample report template with pie chart''
</div>
 
The resulting report pages are shown below.
[[Image:iRep29.png|center|500px|''Figure 29. Sample report with pie chart'']]
<div align="center">
''Figure 29. Sample report with pie chart''
</div>
===Bar Charts===__NOEDITSECTION__
Bar charts, unlike Pie Charts, have a third variable option that can be included in the report. In addition to the category and value expressions, bar charts add the option of a '''''series'''''. The series choice adds an additional possibility of grouping data though is not required.
{{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__
To add a bar chart to the report:
<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 the group that will subsequently values to be used displayed in the pie chart(e.g. ''SUM_areaSize_byStatus''). To add This variable should be based on a group footer:</li><ol type="a"><li>From the numeric field (e.g. '''ViewareaSize'') and should have the ' menu, select ''Reset type'Bands'''.</li>:The <FileName> bands… window displays. <li>Select <set to '''GroupAttributeGroup'''>Footer from and the left pane where group selected set to the field you wish to create the chart from'' (e.g. ''GroupAttributestatus'' is ).#Select the name of '''Chart''' option from the attribute on which '''Palette''' pane and drag it to the '''Summary Band''' of the results will be grouped. For example, if you are creating a report on land and group template to start the results by the priority, the name of the band would be ''priorityFooter'Chart Wizard'''.</li><li>In #Select one of the right pane, enter a numeric value in the Band Height fieldbar chart options. You may adjust the height of the summary</li><li>Click the '''Apply#:[[Image:IReport BarChart.png|center|500px|''Chart options' button.']]</lidiv align="center"></ol''Chart options''</div><li>Add a summary section to the #Choose Main reportdataset.</li><li>Click the #:[[Image:iRepBarChartIReport BarChart_Step1.png]] icon.<|center|500px|''Chart options'']]<div align="center">''Chart options''</lidiv><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# Provide a '''Series Expression''' (''optional'').</li> #:[[Image:A window of the various chart options displaysiReport Chart Bar1.<li>Select one of the bar chart options.</li><li>Click the png|center|500px|''Series Expression'OK''' button.]]</lidiv align="center"><li>Right-click anywhere on the chart.''Series Expression''</lidiv><li>Select # The Series Expression allows you to define an added level of detail to your bar chart (if desired). To select the '''Chart PropertiesSeries''' option.</li><li>From choose the '''Expression editor''' button and '''choose one of the Chart Properties window, select ''fields'' the Chart Data tabreport is grouped by''' (e.</li><li>From the Chart Data tab, select the Details tabg.</li><li>Click ''status''). Note that charts in iReport will fail if the '''AddSeries''' buttonvalue is null.</li>:The Chart Properties window displays. By defaultIn order to account for null values, the Data tab should be selected. <li>The Series Expression allows you will need to define an added level of detail to your bar chart. To enter modify the series expression value:</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 the field the name of the Key Expression fieldthat you selected above.<#: '''$F{status} == null ? "N/li>A" : $F{status}'''#:The Expression editor window displays[[Image:iReport Charts5.png|center|500px|''Set Series Value'']]<li>From the bottom pane, double-click div align="center">''Set Series Value''</div>#: The expression that you enter in the name of Series Expression field will vary based on how you want the attribute that contains the data that horizontal axis to appear:#*If you would like to include in the horizontal axis of the bar chart.</li>:The expression to represent the reflect a single attribute displays in such as the top pane.<li>In order to account for null valueschart displayed below, you the Series Expression will need to modify be the same as the Category 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 #:[[Image:iRep30.png|center|500px|''Bar chart –Single attribute with the name of the attribute that you selected in step b above.y-axis'']]</lidiv align="center">$F{''Bar chart –Single attributey-axis''} '''!= null ? $F{attribute} : "Unknown"'''<li/div>Click the '''Apply''' button.</li></ol>The expression that #*If you enter in would like the Series Expression field will vary based on how you want the horizontal axis to appear:*If you would like the horizontal horizontal axis of the bar chart to reflect a single the values of an additional attribute such as the chart displayed below, the Series Expression will would be the same as expression for the Category expressionsecondary level of detail.</ol> [[Image:iRep30In the example shown below, the x-axis reflects the land priorities (e.g.png|center|500px|''Figure 30, Low, Medium, or High). Bar chart –Single attribute y-axis'']]<div align="center">''Figure 30. Bar In addition to displaying the priority, the bars of the chart –Single attribute y-axis''</div>use a different colour to reflect those land which block water access (red) vs. those that do not block the water (blue). <ol>*If you would like the horizontal axis of the bar #:[[Image:iRep31.png|center|500px|''Bar chart to reflect the values of an additional attribute, the Series with different series expression'']]<div align="center">''Bar chart with different series Expression would ''</div>#* '''Finally, the Series value can be the expression for the secondary level of detailleft blank if desired. In '''# The next step is to provide the example shown below, correct data for the x-axis reflects the land priorities (e.g., Low, Medium, or High). In addition chart to use. Bar charts require a '''category expression''' and a '''value expression''' where the value expression is a field to displaying group the priority, the bars data by (i.e. the names of the chart use a different colour X axis) and value expression is the value to reflect those land which block water access (red) vs. those that do not block the water (blue)sum. </ol> #:[[Image:iRep31iReport Chart Bar2.png|center|500px|''Figure 31. Bar chart with different series expressionCategory and Values'']]<div align="center">''Figure 31. Bar chart with different series expressionCategory and Values''</div> <ol>The Chart Properties window for this bar chart is shown below. Notice that the series expression and # To select the '''category expression differ.</ol> [[Image:iRep32.png|center|500px|''Figure 32. Chart Properties – Different series ' choose the '''Expression editor''' button and category expressions'']]<div align="center">'choose one of the ''Figure 32. Chart Properties – Different series and category expressionsfields''</div> <ol>*If you selected one of the stacked bar chart options, the series report is grouped by''' (e.g. ''status''). Note that charts in iReport will fail if the '''category expression will be used to determine the segments of each bar''' is null. In the following figureorder to account for null values, you will need to modify the series expression creates red and blue segments in each bar to indicate whether or not water access is blockedso that null values are grouped into their own group.</ol> [[ImageThe expression should be modified to include the bolded text below. You should replace field with the field that you selected above.#:iRep33.png|center|500px|''Figure 33. Stacked bar chart'']]<div align$F{status} ==null ? "centerN/A">: $F{status}'''Figure 33. Stacked bar chart#:[[Image:iReport Charts5.png|center|500px|''Set Category Expression'']]</div> <ol start=align="14center">''Set Category Expression''<li/div>The Category Expression is #Next, select the major grouping of the horizontal axis'''value expression''' that contains the desired numeric data for the chart. To enter the category expression'''Note:</li><ol type="a"><li>Click This should always be one of the [[Image:iRepEditorvariables created in step 3 above''' (e.g.png]] icon that is displayed beside the Category expression field''SUM_status_byAreaSize'').</li>#:The Expression editor window displays[[Image:iReport Charts6.<li>From png|center|500px|''Select the bottom pane, double-click desired value expression'']]<div align="center">''Select the name of the attribute that contains the data that you would like to include in the chart.desired value expression''</lidiv>:The expression to represent # Choose '''Finish''' and the attribute iReport template displays in with the top paneChart.#:[[Image:iReport Chart Bar3.png|center|500px|''iReport displays with Chart'']]<li>In order div align="center">''iReport displays with Chart''</div># The report can now be previewed to account for null values, you will need to modify the expression so that null values are grouped into their own groupensure it is functioning as expected.#:[[Image:iReport Chart BarPreview. The expression should be modified to include the bolded text below. You should replace attribute png|center|500px|''Preview with the name of the attribute that you selected in step b above.Chart'']]</lidiv align="center">$F{''attribute''} '''!= null ? $F{attribute} : "Unknown"'''<li>Click the '''Apply''' button.</li></ol><li>The '''Value Expression''' field contains the expression that returns the numeric value for the key.</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 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 Preview with chart comparing values of a single variable''</div>
In this section, you will learn how to create ====Modify a Bar Chart====__NOEDITSECTION__Once a grouped bar chart. A grouped bar chart compares the values of a single variable in one group to the same variables has been created in another group. In the example below, the grouped bar chart still compares the number of activity types. HoweveriReport Designer, 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 its properties can be edited by selecting the different bar colours as indicated in the legend. The coloured bars are clustered together based '''Chart Data''' option on their district. The first cluster of bars shows the number of activity in right click menu and adjusting the Bolikon district. The second cluster of bars shows the number of activities in the Waltern districtvalues and properties.
[[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 modify a grouped bar chart to the report:<ol><li>Create a report which groups the results by the fields that will be represented # Right click 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 iReport Designer and select '''ViewChart Data''' from the menu, select '''Bands'''.</li>:# The <FileName> bands… window displaysChart Data properties display. <li>Select <''GroupFieldName''>Footer from # To edit the left pane where ''GroupFieldNameis'' the name main properties 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 prioritychart, select 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 '''ApplyDetails tab''' 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 reportAdditionally, hold down the mouse button and drag the cursor this screen can be used to form edit the rectangle which will contain the chart.</li>:A window reset type of the various chart options displays.<li>Select one of which is relevant if 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 is displayed on a band other than the chartsummary band.</li><li>select the '''Chart Properties# The ''' 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:iRep37IReport Chart Bar ChartData1.png|center|500px|''Figure 37. Bar chart series expressionChart Data Properties'']]<div align="center">''Figure 37. Bar chart series expressionChart Data Properties''</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 # For Bar Charts this presents the series expression is grouped together.</li></ol> [[Image:iRep38.png|center|500px|''Figure 38. Bar chart category expression'']]<div align="center">''Figure 38. Bar chart category expression''</div> To enter the category expression:<ol start="16"><ol type="a"><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 chart.</li>:The expression to represent the field displays in the top pane.<li>Click the '''ApplySeries''' buttonchooser.</li></ol><li>The '''Value Expression''' field contains the variable that returns the numeric value that Typically there will 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''' only one or two series to choose from the left panehere though more can be added at this point.</li><li>From Select the middle pane at the bottom of the Expression editor window, double-click the name of the variable that you would like series to represent on the chart.</li><li>Click the '''Apply''' button.</li></ol><li>Click the modify and choose '''OKModify''' button.</li>:# The Chart Properties Data properties window closes.<li>Click the '''Close''' button.</li>will display#: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> {{note|iReport requires you to save the report after adding or changing a chart.}} <ol start="20"><li>Click the [[Image:iRepCompile.png]] button to compile the report.</li><li>Click the [[Image:iRepRun.png]] button to execute the report.</li></ol> ===Stacked IReport Chart Bar Chart===__NOEDITSECTION__A stacked bar chart is similar to a grouped bar in that it allows you to represent two different fields on the chart. The key difference is that the stacked bar chart layers the values of the series expression (the field represented in the legend) allowing you to easily compare the categories to one another.  [[Image:iRep39ChartData2.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 # In this window, the report:<ol><li>Create a report which groups the results by the fields that will be represented on the horizontal axis basic properties 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 were established in 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 Chart Wizard can be groupededited. This footer will be used to display the variable for the group that will subsequently be used in the chart. To add a group footerThese include:</li><ol type="a"><li>From the #*'''View''' menu, select '''BandsSeries Expression'''.</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 will be grouped. For example, if you are creating a report on land and used to first group the results by the priority, the name of the band would be ''priorityFooter''data for charting purposes.</li> <li>In To change the right panefield, enter a numeric value in the '''Band Height''' simply select another field. You may adjust the height of the summary</li><li>Click the '''ApplyNote:''' button.</li></ol><li>Add while this field is required it can be made blank or fixed by being set to 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 will contain the chart.</li>:A window of the various chart options displays.<li>Select one of the stacked bar chart options.</li></ol> [[Imageconstant such as:iRep40.png|center|500px|''Figure 40. Stacked bar chart options'']]<div align="center">''Figure 40. Stacked bar chart options''</div> <ol start=or "8Blank"><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 Category Expression'''Add''' 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 chartgroup data for charting purposes. To enter the series expression:</li><ol type="a"><li>Click change the [[Image:iRepEditor.png]] icon that is displayed beside the Key Expression field.:The Expression editor window displays.</li><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 simply select another field displays in the top pane.<li>Click the '''ApplyNote:''' button.</li></ol><li>The Category Expression is the field by which the series expression is grouped together. To enter the category expression:</li><ol type="a"><li>Click the [[Image:iRepEditor.png]] icon that is displayed beside must be used in the Category expression field.</vli>:The Expression editor window displays.<li>From the bottom pane, double-click the name creation of the field that contains the data that you would like to include variable used in the chart.</li>The value expression to represent or the field displays in the top paneresults will be incorrect.<li>Click the Apply button.</li></ol><li>The #* '''Value Expression''' field contains : the variable that returns used to store the numeric value that will data to be represented on displayed in the chart.</li><ol type="a"><li>Click the [[Image:iRepEditor.png]] icon that If changes are made this value it is displayed beside recommended to edit the Value Expression fieldvariable properties as well.</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 Label Expression editor window, double-click the name of the variable that you would like to represent on the chart.</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 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 reportfor more details.</li><li>Click the [[Image:iRepRun.png]] button to execute the report.</li></ol>
{{NavBox HowTo use iReportStandardizing Data Analysis and Information Reporting}}[[Category:VIE]]
4,913
edits

Navigation menu