Property name Description Editable Formula Control Data Type General ClassType Display class type: GroupPanel. N N _ BreakBy Display the group name. N N _ GroupLayout KeepGroupTogether* If set true, the whole group will try to keep together. Y N Boolean RepeatWhileGF* When the Group Header is set to be repeated, specify whether the Group Header is still repeated if the page break happens exactly on Group Footer. Y Y Boolean TOC GroupMask* Customize the group name in TOC view. Y Y String Underline If true, the group name in the TOC view will be underlined. It's used for viewing a report in DHTML format on the server side. Y Y Boolean Security Grant* Specify the GroupBy field to set page level security Y N String Cascade* If set true, the detail section as well as the group header and footer will display. If set false, only the group header and footer display. Y N Boolean Others TOCAnchor* Specifies whether this object is shown as a node in DHTML TOC.
Y Y Boolean
KeepGroupTogether property is commonly used. Let us see an example:
Obviously, the Group I in the above example will start on the next page due to the lack of space. But it does not look nice, so we will set the KeepGroupTogether property to true to see the result:
The remaining space could not hold Group I, so it is laid out on a new page.
By default, the group names in TOC view display the values of the field you are grouping on. For example, you group customer information in alphabetical order. When you view the report in DHTML format on the server side, you will obtain TOC as following:
However, you can customize the group names with the property "GroupMask". The format of the property value is like:
xxx% or xxx%xxx%xxx, where % indicates the value of the field grouped on, which can appear one more times, at any position in the defined group name, xxx is the string to define the group name.
For example: Customize the group name as Group %: with the first letter % in Customer_Name, then the TOC view will be:
Note: If you want use the sign % in text " xxx" not as the value of field, you should add escape operator -- \ before the sign %. For example, if the default name inn TOC view is "Percent =70", customize the name as "Group - %\%", then the group name will be "Group-70%".
Page Level Security is implemented with two security properties on the group level: Grant and Cascade. By utilizing these two properties, you can specify which group contents should be displayed in your reports. This feature also applies to the nested group. Note: You can export the report with page level security to PDF, HTML, TXT etc., but the RST format is not supported in this instance.
For example, we create a report of customer information, which is grouped by the Customers_Country field. In Report Inspector, set the Grant property to Customer_Country, Cascade to true.
Then view the report. You will be prompted to input the SID ( Security Indentifier). Type USA to view the USA group.
Now the USA group displays.
Notes:
- The first page and last page are empty.
- If the Cascade property is set to be false, the specified group will display only its group header and footer.
After setting Cascade to be false, view the report. Only the group header displys without details.
- For further usage of Page Level Security, refer to User's Guide | Page Level Security.
Suppose the property Repeat is set to be True in the GroupHeader panel.
When Group Footer crosses the page and the property RepeatWhileGF is true, Group Header will be displayed as it is set to repeat.
But if you set RepeatWhileGF to be false, only Group Footer displays without Group Header.
When you view your report in DHTML format on server, you can use TOC to browse the report data. By default, the nodes in TOC window includes the following objects: group panels, summaries, sub-reports, and data objects. Besides, you are allowed add your own nodes to the TOC Browser. Most objects in JReport Designer have a property called TOCAnchor, which holds a Boolean value. If the TOCAnchor property is true, a node for this object will be added to the TOC tree. When you click such a node, the page that contains this object will be displayed in the report area. For more information about DHTML TOC, please refer to the topics on DHTML in JREntServer's manual.
