Adding report scriptlets

AwareIM offers a powerful tool called the Report Designer that allows users to configure their own reports. Most reports can be configured without any programming as the Report Designer offers quite a rich set of versatile tools. Sometimes though it may be necessary to add the programming components to a particular report to perform some non-standard tasks – for example, calculate an image representing a chart of the report data.

AwareIM allows plugging in such programming components (scriptlets) into a particular report. To add a scriptlet to a report follow the steps below:

1. Write the code for the scriptlet (see Implementing code for the scriptlet)
2. Compile the source code of your scriptlet and package it in a jar file(s). Make sure that the jar file resides in the AwareIM/CustomJars directory (see General Guidelines)
3. Specify the fully qualified name of the scriptlet in the Report Designer in the Configuration Tool. A scriptlet can either be attached to a text element of the report or to an image element. Select the element that will be implemented by the scriptlet and in the Properties dialog for this element tick Calculated by System box. Press the Settings button and specify the fully qualified name of the component – see also Working with Report Designer.