Create report

Last modified by Hera Guo on 2025/09/16 14:41

Table of contants:

In ThingsEye, Reporting is a powerful and flexible tool for collecting, structuring, and automatically distributing data in the form of reports.

Reporting in ThingsEyeis built on two key components:

  • Configured report template – defines the structure, content, and format of the report. A template can be in PDF or CSV format and may include any supported components, such as tables, charts, text blocks, images, and more.
  • Scheduler event – automatically triggers report generation at the specified time and sends it to selected recipients via available delivery channels (such as emailSlack, and other integrations).

Key features:

  • Automated scheduling – preconfigured scheduler events can send reports on a set schedule without any user action.
  • Reusable templates – a single template can be used for different recipients by applying filters and parameters.
  • Event-based delivery – send reports when specific events occur (e.g., an active alarm on a device).
  • Rich content support – include text blocks, tables, charts, images, and more.
  • Notification integration – attach a generated report to system notifications (Email, Slack).

Where it's useful:

  • Regular monitoring of your device's metrics.
  • Sharing summary data with partners or management.
  • Archiving data in an easy-to-read format.
  • Automating communication during incidents.

Report format:

  • PDF – visually styled reports that may include charts, tables, images, and company branding.
  • CSV – data-oriented tabular reports that are easy to analyze in Excel or BI tools.

Demo:

1757901233737-956.png

1757901251979-243.png


How to generate a simple report

Creat report

  • Open the “Reporting” page from the left-hand sidebar. You'll automatically be taken to the “Templates” tab.

  • Click the “+ Add report template” button in the top-right corner.
  • Choose “Create new report template”.
  • In the popup, fill out the following:
    • Name – a descriptive name for the report template.
    • Format: Choose PDF or CSV report format.
    • Type:
      • Report - a complete standalone report template.
      • Subreport - a modular component that can be embedded inside another report.
    • Click “Add” to create the report template and open the Report Builder interface, where you can design the structure, layout, and content of your report.
    • Open the “Reporting” page from the left-hand sidebar. You'll automatically be taken to the “Templates” tab.
    • Click the “+ Add report template” button in the top-right corner.
    • Choose “Create new report template”.

1757899242101-256.png

  • In the popup, fill out the following:
    • Name – a descriptive name for the report template.
    • Format: Choose PDF or CSV report format.
    • Type:
      • Report - a complete standalone report template.
      • Subreport - a modular component that can be embedded inside another report.
    • Click “Add” to create the report template and open the Report Builder interface, where you can design the structure, layout, and content of your report.

1757899267136-753.png


Report Builder

The Report Builder is a drag-and-drop editor that lets you design your report template using visual and data components. You have full control over both the appearance and structure of the report.

Each component has two main configuration sections:

  • Data configuration — defines which data the component will display and how it will be filtered. Supports entity aliases and filters for dynamic data binding.
  • Layout configuration — controls the visual style and formatting in the final document.

Here's what the Report Builder looks like:

1757900905980-599.png


  • In the Report Builder, add a component (for example, Rich text) and, in the “Data” tab, specify its data source (target entity and data keys).

1757904337253-670.png

1757904522206-991.png

  • Next, in the component's text field, type the symbol where you want to insert a variable's value. This will open a list of all available variables in the current context.

1757904586368-737.png

  • Select variables (for example, ${humidity}), and its value will be inserted into the report during generation.

1757904657842-206.png

  • When finished, click the “Save” button in the top-right corner to apply your changes.

1757904729910-988.png

  • And so on, continue to add other components

1757904996853-139.png

1757905097135-701.png


Generate report

To verify the result, generate a test report sample by clicking the corresponding button in the top-right corner.

1757905171500-699.png

Demo:

1757905724919-410.png


Download Report

The “Reports” tab stores all your generated reports. Here you can:

  • Download reports.
  • Filter reports by report template or by the user whose credentials were used to generate the report.
  • Delete unnecessary reports.

1758004818035-415.png