Creating custom report script
Last updated
Was this helpful?
Last updated
Was this helpful?
With our upcoming release scheduled for 22.05.2025, we will upgrade our reporting engine from DevExpress version 21.1.4 to 24.2.7. This upgrade brings improvements, but also changes to the scripting API that may cause your existing custom scripts to stop working if not updated.
📌 What you need to do To ensure your scripts continue to function correctly:
Review your custom report scripts.
Refer to the DevExpress API Reference to update property and method usage where needed. For example:
FieldByName
is no longer valid. Use GetFieldByName
, which now returns a PivotGridFieldBase
instance.
XRPivotGridField
is now XRPivotGridFieldBase
.
Script references like PivotTableStatusPriorityCounts.Fields.FieldByName
should be updated to PivotTableStatusPriorityCounts.Fields.GetFieldByName
.
🗂 Reference:
📅 What’s coming next? Later this year, we plan to roll out a second update that will further align aqua with the latest DevExpress reporting framework. This may require additional script adjustments, and we’ll keep you informed ahead of time.
Scripting plays a key role in extending the functionality of aqua reports. It allows you to extend the capabilities of the report beyond just using the data contained within aqua. Scripting gives you the ability to enrich the report by extracting data from external sources such as databases or files. You also have the flexibility to save copies of the report to specific network drives and control which items are excluded from printing during each event band iteration.
To run a script on a particular event, you need to add a script function to the element's event. You can do this by linking a script method to the Behaviour/Scripts property. This property lists all the events that the selected element will trigger. These can be different for different element types.
The appearance can be modified with the event “OnPrintPage”
The appearance doesn't necessarily have to be changed by the script. They can also be changed using formatting rules.
To change to the scripts view, click on . Here, you can add some functionality to your report:
The information on how to enable scripting mode for the On-Premise customers can be found in this .