Adding a Report

Adding a report to the system requires direct server access - you'll need to be able to create files and folders on the reporting server.

Once you've got access to the report folder, you add a report to the Report List by following the steps below…

In your reports directory, you can create a folder for every report. Note that while it's not required, we suggest avoiding spaces in your folder names.

For instance, if you wanted to create a “Daily Temperature” report, you would make a folder called daily_temperature.

Now, create a Python script file.

This can either be called report.py, or it can have the same name as the folder itself, plus the 'py' extension (even in Linux, please include the extension).

To continue the example above, you could create either /daily_temperature/daily_temperature.py or /daily_temperature/report.py.

NOTE: In some cases, you might want to copy an existing report instead of creating a new Python script.

The Info.txt file gives the system some details about the report - it's name, the time range it should cover etc.

Info files have four lines….

The included libraries assume that you will be using MatPlotLib to create your reports, but you are free to use whatever Python reporting toolkit you prefer (or can use Python to launch other processes to generate your report information as well).

For further details and examples, see Writing a Report in Python and MatPlotLib.