How to use ActiveReports band list component? You will understand after reading this!

ActiveReports v14.0 official version download

The Grape City report control ActiveReports V14.0  was officially released, fully supporting the .NET Core platform. At the same time, in this update, the ActiveReports desktop report designer UI has been fully enhanced, the report preview method has been fully optimized, and the report design capabilities have been greatly improved.

For the online report designer, ActiveReports V14.0 adds the connection function of the data source and data set, the strip list control, and localization support. This article will introduce in detail the characteristics and main functions of the ribbon list control.

Overview

The banded list control is a new feature in the ActiveReports V14.0 online report designer. This is a very powerful data control, divided into three data areas: header, detailed data row (used to load data fields), and footer . Each area can be used as a container control, that is, multiple controls can be embedded in each area at the same time to create complex format reports, such as master-detail reports, dynamic and unfixed lists, etc. Among them, the control embedded in the detailed data row will be rendered repeatedly according to the number of rows, while the header and footer are rendered only once to display the title and total respectively.

Select the entire control or click an area to set the properties of the entire control or a single area respectively.

The following is the property list of the entire control:

SpreadJS tutorial

Using the ribbon list control, you can add group headers and group tails, or nested groups. Among them, the grouping basis can be an expression, and the grouping data can be sorted. Note: The detail area of ​​the strip list does not support sorting, and the sorting of the detail data must be done during query.

The following is a list of attributes for a single zone (Band):

SpreadJS tutorial

Properties dialog box for strip list

Select the ribbon list and click [Properties dialog box...] below the properties pane to open the properties dialog box options.

The properties dialog contains multiple option pages: general, visibility, navigation, grouping, filtering, and data output.

conventional

  • Name: Represents the name of the control, and must be unique within the scope of the same report.
  • Tool tip: Enter a paragraph of text, which will be displayed when the user views the report and enters the control area with the mouse.
  • Data set name: select a data set bound to this control.
  • Page number in the area: whether this control is numbered separately.
  • Delete the blank area in the container control: whether to automatically reduce the blank area in the control range.
  • Page feed: You can choose to insert a page feed before or after the Banded List, or display all contents on the same page as much as possible to avoid page breaks.
  • Column head and footer: You can choose to repeat the content of the head or tail area on each page, prohibit the head or tail area from being displayed on a single page, and print the tail area at the bottom of the page (the default area is followed by the content of the detailed area) ).

Visibility

By default, the control is visible when viewing the report. However, it can be set to decide whether to hide the control based on the result of the expression, or it can be set to decide whether to hide the control based on the visibility of another control in the report.

navigation

  • Document structure map label: input text or expression to be used as the item name of this control in the document structure map (ie directory).
  • Bookmark ID: Enter text or expression to be used as the bookmark location ID for jumping to this control. Set [Jump to Bookmark] to this ID in other controls, and you can click other controls to jump to this control when viewing reports.

Grouping

Grouping can be used to organize and count data according to specific categories. For example, in a product list report, the list is displayed by product ID by default, but by setting grouping, product information of the same category can be displayed together according to product category . Click the plus icon to add a new group, and group properties can be set in multiple tabs.

Grouping-General

  • Name: Enter a group name.
  • Grouping: Select a field or edit an expression as the basis for grouping. Typical fields are category nature, such as product category ID, year, month, business area, etc.
  • Document structure map label: Enter a text expression as the name of the directory item.
  • Parent group: Specify a parent group to achieve multi-level grouping.

Grouping-filtering

Filter conditions can be set to display part of the grouped data.

A filter condition consists of three parts: expression, operator, and value.

Expression: The check object of the filter condition, generally a certain field.

Operator: the comparison operator, including:

  • Equal: Equal, that is, to filter out the data where the calculation result of the expression on the left (or a field value) is equal to a specified value (the value on the right of the operator).
  • Like: contains, that is, the filter condition is that the expression on the left contains the value on the right. The value on the right will generally contain an asterisk wildcard (*), you can refer to the Microsoft documentation: https://msdn.microsoft.com/en-us/library/swf8kaxw(v=vs.100).aspx
  • NotEqual: Not equal.
  • GreaterThan: Greater than.
  • GreaterThanOrEqual: Not less than, that is, greater than or equal to.
  • LessThan: Less than.
  • LessThanOrEqual: Not greater than, that is, less than or equal to.
  • TopN: Only display the first few data of the data set, the specific ones are determined by the [value] specified below.
  • BottomN: Only display the last few data of the data set, the specific ones are determined by the [value] specified below.
  • TopPercent: Only display the first few percent of the data in the data set. The specific display percentage is determined by the [value] specified below.
  • BottomPercent: Only display the last few percent of the data set. The specific display percentage is determined by the [value] specified below.
  • In: Only display the data whose expression result is equal to several specific values. The specific value is determined by the [value] specified below.
  • Between: Only display the data whose expression result falls between two specific values. The two specific values ​​are determined by the [value] specified below.

Value: Depending on the operator, the value on the right side of the operator in the filter condition may be a single constant value or multiple constant values ​​(for example, in operators such as Between and In).

In addition, the value may contain wildcard characters. For example, when the operator is Like, the value may represent "Shaanxi Province * City".

For the TopPercent and BottomPercent operators, the value should be the numeric part without the percent sign. If you want to filter half of the data, the value should be 50, not 50% or 0.5.

Grouping-Sorting

You can set multiple sort conditions to control the order of data output. In the sorting, the ascending and descending order of each condition can be different, such as descending order by year first, and ascending order by province.

  • Expression: It can be a single field or a combined expression of several fields.
  • Direction: Used to control ascending or descending order.

Grouping-visibility

Used to set whether the current group is hidden.

  • Visible: always displayed, that is, not hidden.
  • Hidden: It is always not displayed.
  • Expression: Decide whether to hide according to the calculation result of the expression. The expression should return True/False boolean type. Note: True means to hide, False means to show.

Visibility can be switched by other report elements: select another element in the current report, usually a text box, such as TextBox1. When the user views the report, a folding and unfolding icon represented by plus and minus signs will be displayed on the left of the text box. When the user clicks the icon, the current element will switch back and forth between showing and hiding.

The typical application scenario is: the content in the text box is set to "show or hide the detailed list", and then click the plus and minus signs on the left of this text box to control whether a table or list is displayed.

Grouping-data output

Set the element Tag when exporting report data to XML here.

  • Element name: Enter an XML element name, this name will be used as the tag when the report data is output as an XML file. For example "ProductType".
  • Collection: Enter an XML collection name, this name will be used as the superior Tag of the element name Tag of XML data output. For example "ProductTypes".
  • Output: Select [Yes] or [No] to indicate whether this data is included when outputting XML.

Grouping-layout

  • Start page feed: insert a hard page break before the content of this section.
  • End position change page: insert a hard page break after the content of this section.
  • Include packet header: display the header area. Uncheck to hide the head area.
  • Including group tail: display the tail area. Uncheck to hide the tail area.
  • Repeat packet header: whether to repeat the header area when changing pages.
  • Repeat group tail: whether to repeat the tail area when changing pages.
  • Page number in the area: Whether to arrange the page number separately, the default is to arrange the page number according to the entire report.
  • Print the grouped contents of the table on the same page: When there are many contents in this area and need to be displayed on one page, you can control the display on a single page (this may cause the lower part of the previous page to be blank).
  • Prohibit to display the header separately: Do not display the header at the bottom of a page, that is, there is no line of detail below.
  • Prohibit displaying the tail separately: Do not display the tail at the top of a page, that is, there is no detail on the top line.
  • Print the tail area at the bottom of the page: By default, the tail area follows the data, and it can be forced to be displayed at the bottom of the page when checked.

filter

If you need to display only part of the data set, you can set filter conditions here.

Click the plus icon in the upper right corner of the dialog box to create a new filter condition.

Data output

Set the element Tag when exporting report data to XML here.

  • Element name: Enter an XML element name, this name will be used as the tag when the report data is output as an XML file, such as "Product".
  • Output: automatic = let the system decide whether to export (the system will decide whether to export according to certain conditions, for example, when the string in the text box is a constant, do not export, or only export the field value content from the data set); yes = always Export; No=Do not export); Content only=Export data content only.

ActiveReports Report Control  |  Download Trial

ActiveReports  is a report control focused on the .NET platform, which fully meets the needs of report design and development under such platforms as HTML5 / WinForm / ASP.NET / ASP.NET MVC / WPF. As a professional report tool for more than 300,000 developers worldwide Provides comprehensive report development services.

This article is reproduced from Grape City


Huidu high-end UI interface development

Guess you like

Origin blog.csdn.net/AABBbaby/article/details/108483041