WinForms and WPF Reporting - Report Gallery and Band Templates (v19.1)

Reporting Team Blog
26 April 2019

Report developers and users of the End-User Report Designer may already be familiar with the Report Gallery that allows you to store and reuse certain report parts, including visual styles, report controls, or entire reports and data sources.

So far, this functionality has been available in the WinForms Report Designer, but with v19.1 we are bringing it to WPF. At the same time we used your feedback to extend the functionality on both platforms: you can now store report bands together with their content.

Note that the HTML5/JS Report Designer does not support the Report Gallery at this time. Please see the survey at the end of this post to add your vote for this feature and help us define priorities.

Overview

The WPF Report Designer now ships with the Report Gallery panel that provides Import and Export commands in the toolbar and includes the node Bands for the new Band Templates.

Report Gallery Toolbar

To add a report item to the gallery, right-click it in Report Explorer or on the report design surface and select Add To Gallery:

Add To Gallery

Note that you can copy, paste, remove and rename gallery items as required.

Using the toolbar commands you can import and export gallery items to XML files as a backup or to share with others. You can implement your own database or file storage for end-user reporting applications and enable the property ReportGalleryExtension.EnableSynchronization. Application users can then click the Refresh button on the toolbar to synchronize gallery items. This makes it easy to share Report Gallery content between application users. There are even features included to handle cases of accidental deletion.

Synchronize Gallery Items

Band Template Specifics

As explained above, the Report Gallery can now store band templates. Use cases for this feature include standard report headers or footers, and default disclaimer text. Once you have stored a band, you can add it back into a report in two ways:

  1. Select a band in your new report, right-click a band template in the Report Gallery and select Apply Layout to Band. This action replaces the current content of the target band. Note that the type of the target band must be the same as that of the band used to save the template.

Apply Band Template Via Context Menu

  1. You can drag and drop band templates directly from the Report Gallery. When you hover the mouse over an appropriate target band, a green outline indicates compatibility and you can drop the template to apply it. If you drop a band template on a band delimiter, a new band is inserted based on the template.
Apply Band Template Using Drag&Drop

In the animated illustration above, you can see that drag&drop operations now provide new visual effects when a container is highlighted. We implemented similar effects for all drag&drop actions related to the Field List, the Report Explorer (styles, components) and the Toolbox.

Here is another animation that shows these new effects:

Drag&Drop Enhancements

Your Feedback Counts

We are interested to hear your thoughts about the new features. Please submit the survey below, and feel free to leave comments on this post or open Support Center tickets for further discussion.

Webinar

Please use the link below to register for our upcoming Dashboards and Reporting webinar, where all new features of the v19.1 release are demonstrated.

Register for the Dashboards and Reporting Webinar

3 comment(s)
Christopher Jay
Christopher Jay

Nice improvements, thanks  :)

27 April, 2019
Mohamed Al Zayani
Mohamed Al Zayani

where the gallery items are stored? how about XAF, will this be available in the reports stored in the DB?

27 April, 2019
Vasily (DevExpress Support)
Vasily (DevExpress Support)

@Mohamed Al Zayani: By default a local file located in the App Data folder is used to store the gallery's items. However, it is possible to implement a custom storage. Check our Report Gallery documentation for more information regarding this.

The Report Gallery panel is available in desktop XAF applications so you can use it along with your reports.

29 April, 2019

Please login or register to post comments.