Report Run Time

After designing the report layout in Report Designer and saving it to the Report Item, you can now generate the report at Run Time, retrieving up-to-date values from the Query Objects a populating the report with Realtime and History values. To do this the Lua script in the Report Item needs to be executed everytime the report needs to be generated. This can be done manually or by creating a triggering reference to another item that will execute the report generation periodically. This triggering reference could be to another data producing item that triggers the report generation everytime its value changes. For the purpose of this example we will create a Generic Item that will trigger the Report Item periodically. To do this, right-click on the Report Demo folder and select Admin > New > Data Processing > Generic Item from the context menu. In the Create Object Wizard, fill in the Object Name as "Trigger". Set the generation period to 10,000 ms and then click Create.

Create "Trigger" Generic Item
Figure 1. Create "Trigger" Generic Item

Now, Select the "Trigger" Object and drag and drop onto the Test Report Item to bring up the Set Object Reference dialog. Click Ok to set the reference.

Set Triggering Reference
Figure 2. Set Triggering Reference

The triggering reference now executes the script every 10 seconds to retrieve data from the Query Objects. To view the report, right click and select Add item to… > Dashboard (shortcut Alt+D).

The Report is added to one tile on the dashboard, to see it more clearly you may need reduce the number of rows and columns in the Dashboard.
Report in Dashboard
Figure 3. Report in Dashboard

The values for the Query Objects should be updated every 10 seconds as the report is triggered and a new report is generated.

If the Report does not appear in the Dashboard you may need to change to "Report View" in the Dashboard menu bar. If the report is still not visible try refreshing the dashbard tile by right clicking, selecting Report Template and clicking on the Report Design Data template name.

To save or a copy of the report, right-click on the report tile in Dashboard and select Save or Print from the context menu. The reports can be saved in a number of different formats.

Save or Print Report
Figure 4. Save or Print Report