v2.2.0
v2.2.0v2.1.0v2.0.0v1.2.0

Interactive features

ActiveReportsJS provides several types of interactive features to supply your reports with for a better user experience.

Action property

TextBox, Image and Chart Plots have the Action property that determines what happens if a report reader clicks a report item or chart plot's element at preview time.

Jump to Report

The Jump to Report action opens the specified report in the viewer. You could use this feature to create Drill-Through Reports. The configuration includes the following properties.

  • Jump to Report - the expression that specifies the report name to open when a reader clicks a report item
  • Parameters - the collection of parameter values to pass into the report above.

Jump to Bookmark

The Jump to Bookmark action brings the report item with the specified Bookmark into focus. The Bookmarks demo uses this feature to display the interactive summary table on the first page. If you click the month name, the viewer switches to the page that shows the detail table for the specified month.

Jump to URL

The Jump to URL action opens the specified URL in the new window or new tab, depending on the browser settings.

Report Map

All the report items and groups, such as a Table Group in ActiveReportsJS have the Label property. Also, a TextBox report has the HeadingLevel that takes integer values starting from 1.

Together labels and values of textboxes with HeadingLevel generate the Report Mapdisplayed on the report viewer sidebar. The hierarchy of items in the report map is defined by one of the following conditions.

  • TextBoxes with HeadingLevel is set 1 are on the root level of hierarchy. TextBoxes with HeadingLevel is set to 2 are on the next level and so on. The Catalog sample has the HeadingLevel = 1 for the textbox located in the Table Group Header. The generated labels are displayed in both of the report map and Table of Contents.
  • Parent and child groups that have a non-empty Label property organically generate the hierarchy. You can find an example of this approach in the Nested Lists demo.

The Source property in the Document Map section of Report properties determines which items are included in the report map:

  • Labels - only labels are included. This is the default value.
  • Headings - only textbox values with HeadingLevel >= 1 are included.
  • All - both labels and textbox values are included. This should be the last resort option for rare scenarios.
  • None - report map is not generated.

Also, the Numbering Style property of a report determines the marker of an item in the report map and Table of Contents.