How does imported data become visible in dashboard charts?

The journey from raw data to visible charts follows this pipeline:

Step 1 — Data Source Configuration

You configure a data source in Analytics → Data Import. This can be:

• Manual file upload (CSV, Excel or JSON — one-time or repeated)
• Email CSV import (forward automated vendor reports)
• API connection (connect to a vendor's API using Swagger/OpenAPI specs)
• Webhook (receive real-time pushes from BMS or IoT platforms)

Step 2 — Data Processing

The analytics engine receives the raw data, validates it, and stores it as meter readings. Each reading has a timestamp, value, and is linked to a specific meter.

Step 3 — Consumption Calculation

Raw readings are converted to consumption figures:

• For "cumulative" meters (like utility meters that count up): consumption = current reading minus previous reading
• For "period" meters (already reporting consumption per interval): the value is used directly

Step 4 — Chart Display

The Analytics dashboard queries the processed consumption data for the selected building, time range, and meter types, then renders it in the charts.

Common reasons data doesn't appear after import

1. The import status shows "failed" or "processing" — check Analytics → Data Import for errors
2. The meter isn't linked — the imported data needs to be mapped to an existing meter in your building
3. The building isn't linked to the analytics engine yet — see "What is the building facility link and why does my building need it?"
4. The date range in the dashboard doesn't cover the imported data period
5. The meter is inactive — only active meters show in charts