{{tag>Programmers_Reference IReport_Environment}}
[<10>]
====== Adding report scriptlets ======

//**AwareIM**// offers a powerful tool called the Report Designer that allows users to configure their own reports and presentations of business objects and groups. Most reports and presentations 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 or presentation. To add a scriptlet to a report follow the steps below:

  - Write the code for the scriptlet (see [[docs:3500:0700:0710]])
  - 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 [[docs:3500:0200]])
  - 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 [[docs:2500_config_apps:4200_report_designer|Working with Report/Presentation Designer]].


{{simplenavi>:docs:3500:0700:}}