MiroxMirox
  • Platform

    • Philosophy
    • Platform Overview
    • Platform Resources
    • Availability and Maintenance Windows
    • Releases and Versions
  • Mirox-Cloud

    • Cloud Overview
    • Connected Microservices
  • Mirox-Agent

    • Agent Overview
    • Deployment Options
    • Data Scraper
    • Digital Twin
  • Technical Details

    • Metric Collection
  • Information

    • Supported Plants
  • Plant Types

    • Solar Plants
    • Solar Trackers and Park Controllers
    • Transformer Stations
    • Wind Plants
    • Battery Storage
    • Alarm System
  • Monitoring & Visualization

    • Real-time Monitoring
    • Digital Twin
    • Component States
    • Inverter Status Codes
    • Inverter Events
    • Loss Detection
    • Power Limits & Curtailment
    • Efficiency Detection
    • KPI Dashboard
  • Data Management

    • Events
    • Alarm Levels
    • Tickets
    • Forecasts
    • Reports
    • Metrics
  • Alert Manager

    • Overview
    • Alert Rules
    • Alerts & Notifications
    • Examples
  • Integration & Sharing

    • Cooperations
    • API Tokens
    • VPN
    • VPN Address Conflicts
    • Proxy
  • AI

    • AI Assistant & Wizards
    • Agentic Access (MCP)
  • Billing

    • Market & Tariffs
    • How Revenue Is Calculated
    • Accounting & Billing
    • Contracts
    • Service Certificates & Invoices
  • Collaboration

    • Invitations
  • Security

    • Authentication
    • Account Lockout
    • Organization Security Policy
    • Permission System
    • Network Segmentation
    • Cooperation Restrictions
    • Access Audit Logging
    • Activity & Audit Trail
    • Data Isolation
  • Getting Started

    • Onboarding
    • Setup
  • Personal

    • Using the VPN
    • Using the Proxy
    • Two-Factor Authentication
    • Sessions
    • API Tokens
    • Notifications
    • Connect Microsoft Teams
  • Per Park

    • Contacts
    • Network Devices
    • Data Loggers
    • Generic Modbus Reader
    • Components
    • Direct VPN (per Agent)
    • Data Volume
    • History Import
  • Organization

    • Member Permissions
    • Security Policy
    • Cooperations
    • File Storage
    • VPN Services
    • Working with Reports
  • Data Export

    • Metric Export
    • Metric Export API
    • Migrating to the Metric Export
    • Legacy Export API
    • External Report Generation
    • Grafana
    • Grafana Dashboards
    • API Overview
    • MiroxQL Formulas (API)
  • Support

    • Request an Integration
  • Reporting

    • External Report Generator
    • Metric Export for Excel
  • Remote Access
  • Account Security
  • AI in Mirox
  • History Import
  • Reports
  • Data Export
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Platform

    • Philosophy
    • Platform Overview
    • Platform Resources
    • Availability and Maintenance Windows
    • Releases and Versions
  • Mirox-Cloud

    • Cloud Overview
    • Connected Microservices
  • Mirox-Agent

    • Agent Overview
    • Deployment Options
    • Data Scraper
    • Digital Twin
  • Technical Details

    • Metric Collection
  • Information

    • Supported Plants
  • Plant Types

    • Solar Plants
    • Solar Trackers and Park Controllers
    • Transformer Stations
    • Wind Plants
    • Battery Storage
    • Alarm System
  • Monitoring & Visualization

    • Real-time Monitoring
    • Digital Twin
    • Component States
    • Inverter Status Codes
    • Inverter Events
    • Loss Detection
    • Power Limits & Curtailment
    • Efficiency Detection
    • KPI Dashboard
  • Data Management

    • Events
    • Alarm Levels
    • Tickets
    • Forecasts
    • Reports
    • Metrics
  • Alert Manager

    • Overview
    • Alert Rules
    • Alerts & Notifications
    • Examples
  • Integration & Sharing

    • Cooperations
    • API Tokens
    • VPN
    • VPN Address Conflicts
    • Proxy
  • AI

    • AI Assistant & Wizards
    • Agentic Access (MCP)
  • Billing

    • Market & Tariffs
    • How Revenue Is Calculated
    • Accounting & Billing
    • Contracts
    • Service Certificates & Invoices
  • Collaboration

    • Invitations
  • Security

    • Authentication
    • Account Lockout
    • Organization Security Policy
    • Permission System
    • Network Segmentation
    • Cooperation Restrictions
    • Access Audit Logging
    • Activity & Audit Trail
    • Data Isolation
  • Getting Started

    • Onboarding
    • Setup
  • Personal

    • Using the VPN
    • Using the Proxy
    • Two-Factor Authentication
    • Sessions
    • API Tokens
    • Notifications
    • Connect Microsoft Teams
  • Per Park

    • Contacts
    • Network Devices
    • Data Loggers
    • Generic Modbus Reader
    • Components
    • Direct VPN (per Agent)
    • Data Volume
    • History Import
  • Organization

    • Member Permissions
    • Security Policy
    • Cooperations
    • File Storage
    • VPN Services
    • Working with Reports
  • Data Export

    • Metric Export
    • Metric Export API
    • Migrating to the Metric Export
    • Legacy Export API
    • External Report Generation
    • Grafana
    • Grafana Dashboards
    • API Overview
    • MiroxQL Formulas (API)
  • Support

    • Request an Integration
  • Reporting

    • External Report Generator
    • Metric Export for Excel
  • Remote Access
  • Account Security
  • AI in Mirox
  • History Import
  • Reports
  • Data Export
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Getting Started

    • Onboarding
    • Setup
  • Personal

    • Using the VPN
    • Using the Proxy
    • Setting Up Two-Factor Authentication
    • Managing Your Sessions
    • API Tokens
    • Notifications
    • Connect Microsoft Teams
  • Per Park

    • Managing Plant Contacts
    • Managing Network Devices
    • Configuring Data Loggers
    • Generic Modbus Reader
    • Configuring Components
    • Configuring VPN Servers per Agent (Direct VPN)
    • Data Volume per Plant
    • Importing a Plant's History
  • Organization

    • Managing Member Permissions
    • Setting Your Organization's Security Policy
    • Creating Cooperations
    • Using File Storage
    • Organization VPN Services
    • Working with Reports
  • Data Export

    • Metric Export
    • Metric Export API
    • Migrating to the Metric Export
    • Legacy Export API
    • External Report Generation
    • Using Grafana as an External Read Platform
    • Building Your Own Grafana Dashboards
    • API Overview
    • MiroxQL Formulas (API Reference)
  • Support

    • Request an Integration

Working with Reports

This guide walks through the everyday tasks on the Reports page: generating a report and publishing it, downloading it, and shaping what reports contain with templates, chapters and metrics. For how these things work and why, see Reports and Metrics; common questions are answered in the Reports FAQ.

Where it lives

Open in Mirox: Reports — main navigation ▸ Reports. The page has two tabs: Reports and Templates. Your organization's metrics are edited in the glossary on the Data Export page — see Create a Metric.

Before You Start

  • Generating and publishing a plant's reports is open to the job roles Operator, Technical Manager, Asset Manager and Viewer on that plant. Regenerate needs Operator, Technical Manager or Asset Manager; deleting a report needs Operator.
  • A template with money chapters (revenue, compensation, settlement) additionally needs the accounting permission on the plant: Operator or Asset Manager.
  • Templates, chapters and metrics are created, duplicated and changed by the organization roles Admin, Moderator, Asset Manager (Technical) and Asset Manager (Commercial); every other member uses them. One marked Private is changed only by its creator, an Admin or a Moderator — see Private.
  • Your organization role gives you a job role on the organization's plants — see Permission System.

Generate a Report

Open in Mirox: Reports ▸ Reports

  1. Click Generate report at the top of the page. As a shortcut, click an ended month, quarter or year on the Data readiness timeline. The dialog opens with that period filled in — and with the template, when only one template is in play. How the timeline works: Readiness timeline.
  2. Pick the Plant. The dialog now offers only the templates that apply to this plant.
  3. Pick the Report language. It starts at the language of your interface.
  4. Choose the Period — month, quarter or year — and which one, then the Template.
  5. Read the lines under your choice:
    • whether the period's data is final — if not yet, the report will be marked Preliminary (you can still generate it);
    • which chapters this plant will not get, and what they need.
  6. Click Generate to build the report straight from the template, or Customize first to change the chapters of this one report in the editor before generating — the template stays as it is.

After a few seconds the report opens in the preview as a Draft.

Nothing to generate?

The dialog says why: no template applies to this plant (Open templates takes you to the Templates tab to build or adapt one), the period has not ended yet, or a permission is missing — then it names who can help.

Review and Publish

A draft is complete but not released. Publish it once you have checked it.

  1. Open the draft: it opens by itself after generating; later, click its row in the list or Review & publish in the Downloads column.
  2. Page through the preview.
  3. To add your own words, click Edit in editor. The editor shows the report's pages as they print. There you can write a note on the cover or print the plant picture on it (Plant picture), add a comment or text between blocks, add a footnote, rename a title, hide a block, or give this report its own header and footer. Numbers are computed and cannot be edited. Your changes are saved as you type; Pages shows the result paginated exactly like the PDF.
  4. Click Publish and confirm. The report is frozen as it looks, and its downloads become available to everyone in your organization who may read this plant's reports. In the editor, Published now stands where the button was, until you change something. The list shows under the date in the Published column who published the report.

To update a published report later — after a late settlement, a revised market value, or once preliminary data is final — choose Regenerate in the row's menu or in the report's Details. The report goes back to draft; its last published version stays downloadable until you publish again. Your written text is kept.

Download a Report

In the list, use the buttons in the Downloads column: PDF, Word, Excel, CSV (a ZIP archive with one file per table) or JSON. The same buttons are in the preview and in the report's Details.

Downloads always give the last published version, also while a newer draft waits. A report that was never published has no downloads yet — publish it first.

To export metrics as time series without a report — for any plants, any time range and as a link for Excel — use Data Export.

Build a Template

Open in Mirox: Reports ▸ Templates

  1. On the Templates tab, click New template — or Duplicate an existing one, such as the shipped Plant Overview, and change the copy.
  2. The report editor opens with a preview plant and period, on pages that look like the printed report. The preview plant is chosen at the top, under Preview plant next to the template's name — on a narrow screen on a line of its own: the pages show its data, and Generate report makes the report for this plant. Add chapters: take one From the chapter library, or write a new chapter right in the template.
  3. In a chapter, add blocks: pick the data, then choose next to the live preview how it prints — as a table, a graph or a list. Add text blocks for your own paragraphs.
  4. Drag chapters in the chapter list to reorder them; give a chapter its own title in this template if you like.
  5. Check the chapter list: a chapter the preview plant does not get is struck through, with what it needs. Switch the preview plant to see how the template reads on other plants.
  6. Click Save template, and give it a name and a description. Its plant types are shown read-only — they follow from the chapters. On a narrow screen, the template actions sit in the ⋯ menu next to the main button.

A template can have its own header and footer, its own design and your company logo — see Edit header and footer, Change the report design and Add your company logo. A report you customized can become a template too: in the report editor, Save as template turns the chapters on screen into a new template.

Edit Header and Footer

The header and footer print on every page but the cover, in the PDF and in the Word file. Set them on a template for every report generated from it, or on one report only. How they work: Header and footer.

  1. Open the pages:
    • for a template, open it from the Templates tab — changing a template needs the organization role Admin, Moderator, Asset Manager (Technical) or Asset Manager (Commercial);
    • for one report, open the report and click Edit in editor.
  2. Point at the header or the footer of any page and click it (Edit header / Edit footer). Its settings open next to it. The badge at the top says whose it is now: Platform default, From the template or This report’s own.
  3. Type into the places — Left, Centre and Right in the header; Left, Right and Second line, centred in the footer. A place marked default shows the platform text until you type; the arrow next to a place brings the default back, and a place you empty prints nothing. The line under each place shows what it prints.
  4. For a value that changes from report to report, put the cursor where it belongs and click a button under Insert at the cursor: Plant, Period, Template, Report title, Organization, Data as of, Year, Page number or Page count.
  5. Set the switches if needed: Print the header or Print the footer, Page numbers at the right end. Mirox logo at the right edge is shown locked: the Mirox logo always prints. To add your own logo, see Add your company logo.
  6. Click Done. The header and footer of every page already show the result.
  7. Keep it:
    • in a template, click Save template — every report generated from it from now on prints this header and footer;
    • in a report, it is saved as you type and the template stays as it is. Publish the report so that its downloads carry the new header and footer.

To undo a report's own header and footer, open the settings again and click Use the template’s — or Back to the platform default when the template has none. In a template, Back to the platform default removes its own. A report's own header and footer can be set by everyone who may generate and publish the plant's reports; with Customize first, the header and footer you set go into the new report when you click Generate report.

Change the Report Design

A template's design sets the typeface, the text sizes, the accent colour, the margins and the lines on the page of every report generated from it — in the PDF and in the Word file. How it works: Report design. Changing a template needs the organization role Admin, Moderator, Asset Manager (Technical) or Asset Manager (Commercial).

  1. Open the template from the Templates tab. A shipped template cannot be changed: Duplicate it and change the copy.
  2. Click Design in the header, next to History — on a phone, the palette icon. The Report design panel opens beside the pages; its badge says whether the design is From the template or the Platform default.
  3. Under Font, choose Sans serif or Serif. The line below names the typeface the PDF and Word print.
  4. Under Text sizes, make the Title, Headings, Body text and Tables smaller or larger with − and +. default under a size marks the platform's value.
  5. Under Accent colour, click one of the colours, pick one, or type it as #RRGGBB. A colour too light for the white text of the table header is not taken: the panel shows its contrast — choose a darker one.
  6. Under Page, choose Narrow, Normal or Wide margins, and switch Frame around every page, Line under the header and Line above the footer on or off.
  7. Every change shows on the pages at once. Click Done when it looks right — the amber dot on Design reminds you that the design is not saved yet.
  8. Click Save template. Every report generated from the template from now on prints this design.

Platform design in the panel goes back to the platform's design; save the template to keep that too. Reports generated before the change show Out of date: Regenerate a report to give it the new design, then publish it. In a report's editor, Design shows the design the report prints — Open the template takes you to the template to change it. With Customize first, click Save template before Generate report; otherwise the new report prints the template's saved design.

Add Your Company Logo

A template can print your organization's logo in the header, in the footer or on the title page of every report generated from it — in the PDF and in the Word file, next to the Mirox logo, which always prints. How it works: Company logo. Changing a template needs the organization role Admin, Moderator, Asset Manager (Technical) or Asset Manager (Commercial).

  1. Open the template from the Templates tab. A shipped template cannot be changed: Duplicate it and change the copy.

  2. Click Design in the header, next to History — on a phone, the palette icon. The Report design panel opens with the Logos section on top: Mirox logo at the right edge is marked Always shown, and Company logo below it takes your own.

  3. Add the image — a PNG or JPEG file of at most 2 MB and 4096 pixels per side:

    • Upload a file from your computer. It is stored in the Branding folder of your organization's file storage.
    • Or Choose from files: the panel lists the PNG and JPEG images in the file storage, newest first, and Search images narrows the list by name. Click the one you want.

    The tile shows the logo on white, as it prints, with its size in pixels. A file that is not a PNG or JPEG image, or that is too large, is refused with a note, and nothing is uploaded.

  4. Under Where it prints, choose Header, left, Header, right, Footer, left, Footer, right or Title page. The line below says where the logo appears.

  5. Under Size, choose Small, Medium or Large. The line below gives the box it fits into, in millimetres; the logo keeps its proportions.

  6. Check the pages: the logo shows in its printed place at its printed size, and the header or footer text moves aside. Click Done — the amber dot on Design reminds you that the change is not saved yet.

  7. Click Save template. Every report generated from the template from now on prints the logo.

To take the logo off again, click the × on its tile (Remove) and save the template. Reports generated before a change show Out of date: Regenerate a report to give it the new logo, then publish it — a published report keeps the logo it was published with. With Customize first, click Save template before Generate report; otherwise the new report prints the template's saved logo, and a note tells you so. If the panel says that the logo file is no longer in your organization's file storage, it was deleted there: nothing prints until you choose or upload another image and save the template.

Create a Chapter

A library chapter can be placed in any template, and a change to it shows in all of them.

  1. On the Templates tab, under Chapter templates, click New chapter.
  2. Give it a name, then add blocks: Pick data, and choose its form beside the preview.
  3. Decide what happens when a plant cannot deliver the data (If unavailable): the report says the data is missing, or leaves the chapter out.
  4. Watch Appears on: it shows the plant types the chapter needs as you add data. If the preview plant does not qualify, the sheet says "Not included for plant: needs …" — pick another plant to see the content.
  5. Click Create chapter. It is now in the chapter library, and any template can add it.

Picking data in several tabs

Pick data — or Change data on a block you already have — opens What should this block show? with a tab each for Time series, Events and Core data. A block shows one kind of data: it takes the picks of the tab you are on when you click Use 3 items. What you picked in the other tabs stays while the dialog is open — a number on each tab counts it, and Kept in other tabs: at the bottom takes you back there with one click.

Inside a tab, every category counts its picks too, and Change data opens the categories that hold the block's data, so its ticks are in view. An item you cannot add is greyed out: point at it for the reason — for example, it prints a table of its own. Data the block reads that the list does not offer is named under Also on this block: and stays on the block when you confirm.

To change a library chapter, click its row. To store a chapter you wrote inside a template in the library, use its badge in the report editor and choose Save as a new library chapter.

Create a Metric

Open in Mirox: Data Export ▸ Glossary

Metrics are no longer on the Reports page: the metric editor lives on the Glossary tab of the Data Export page.

  1. On the Glossary tab, click New metric — or open a shipped Example and Duplicate it.
  2. At the top, under Evaluate on, pick the plant to check the metric against. The check, yesterday's sample, the preview, the building blocks and the assistant all use this plant; the metric itself belongs to no plant.
  3. Fill in the name, the id, the unit and the description, and write the expression — or describe the figure to the Assistant and let it write the expression with you. Every change is saved as you type.
  4. Read the verdict. While the expression has a problem, the metric shows Not validated and cannot be used anywhere; fix what the editor lists.
  5. Check Works on: the plant types the metric needs. A chapter that uses it only appears on those plants.
  6. Click Run preview to see the values over a month, a quarter or a year.
  7. Use it: in a chapter's data picker your metric appears as my metric.

Restore a Version

Templates and library chapters keep a history of their versions. Everyone in the organization can read it; restoring needs the organization role Admin, Moderator, Asset Manager (Technical) or Asset Manager (Commercial) — on a private template or chapter, its creator, an Admin or a Moderator.

  1. Open the Version history: on the Templates tab, open the menu of the template's row — or of the chapter's row under Chapter templates — and choose Version history. In the report editor or the chapter editor, click History in the header.
  2. Read the list, newest first: each version shows its number, the date, who saved it and what changed. Current marks the version in use.
  3. Click a version to open it. You see its chapters or blocks as they were; a library chapter shows which of its versions it had then and whether a restore places its current content or brings this copy back as the template's own chapter. All versions takes you back to the list.
  4. Click Restore version 3 and confirm with Restore. If data the version reads no longer exists, the dialog names it first: Restore without them leaves it out, Cancel changes nothing.
  5. A note above the list confirms the new version number and names anything Mirox had to adjust — a name that was kept, a chapter that came back as the template's own, data that was left out.

The restore adds a new version; nothing is lost, and you can go back the same way. Restoring in an editor replaces what is on screen, so save your changes first. Restoring a library chapter changes every template that places it. Reports already generated keep their own chapters; the ones made from an older version show Out of date, and What changed in the template in their Details opens this history. A shipped template or chapter cannot be restored — Duplicate to edit gives you a copy to work on.

See Who Did What

  • Who published a report, and who generated it: in the list, under the date in the Published column; in the report's Details (Published, Last generated, Created, Draft last edited); and in the line under the description in the preview. A person shows with their initials and email address — point at them to see their name, organization, email address, phone number and roles. Dates and times follow your browser's regional settings.
  • Everything that happened to a plant's reports — generated, regenerated, published, deleted, exported: open the plant's Core Data page and its Activity tab, or the Activity page for all your plants, and filter by the category Report.
  • Every change to templates, chapters and metrics: Organization ▸ Activity. This tab is open to the organization roles Admin and Moderator.

What each entry records is described under Activity trail.

Clean Up

  • Retire a template or chapter you no longer need: it stays, but is no longer offered; Activate brings it back.
  • Delete is only possible while nothing depends on it. The dialog lists what still does — the reports made from a template, or the templates and chapters that use a chapter or a metric — each with a link to open it. Remove the use first, then delete.

Related Pages

  • Reports — templates, plant types, drafts, readiness, versions, title page, header and footer, report design, company logo, downloads, languages and the activity trail
  • Metrics — defining your organization's own figures
  • Reports FAQ — common questions
  • Permission System — roles and job roles
  • Activity & Audit Trail — who did what, and when
Prev
Organization VPN Services
© 2026 Mirox Verwaltungs GmbH. All rights reserved. | Privacy Policy