For the complete documentation index, see llms.txt. This page is also available as Markdown.

AirWatch Export & Reports

Options on how to export data from your AirWatch or how to create an air quality report.

The History tab of an AirWatch device offers two ways to take its data with you:

Action
Output
Best for

Export

CSV or Excel data file

Raw data, spreadsheets, custom analysis

PDF Report

Print-ready PDF document

Compliance, sharing, stakeholder reviews

Both are reached from the History tab of a single device and always operate on that one device only. For a site-wide PDF that aggregates all licensed AirWatch devices, use the Air Quality Reports tab instead.

Accessing Export & Reports

  1. Open the device (sidebar Sites → select a site → Assets → open an AirWatch device).

  2. Select the History tab.

  3. Use the buttons on the right of the controls row:

    • PDF Report — opens the report configuration dialog.

    • Export — opens the data-export dialog.

Both buttons are disabled while data is loading or when the current view has no data.

URL pattern: /sites/[id]/assets/[deviceId] → tab "History".

Data Export (CSV / Excel)

The Export button opens a dialog that turns the chart's underlying data into a downloadable file. The current chart selection (range and resolution) is pre-filled, but everything can be overridden before download.

Export options

Setting
Choices
Default
Effect

Format

CSV (.csv) / Excel (.xls)

Excel

File type and delimiter

Time range

Current view / Custom range

Current view

Which window to export

Resolution

Auto / 5 min / 15 min / 1 hour / 1 day

Auto

Averaging interval per row

Include statistics summary

Toggle

on

Adds avg/min/max/median header block

Include time distribution

Toggle

on

Adds time-in-range breakdown to the header

Include comparison period

Toggle

follows chart

Adds previous-period columns

Apply working-hours filter

Toggle

follows chart

Filter rows vs. add marker columns

Before downloading, an estimate (Estimated: N rows, ~size) is shown so you know roughly how large the file will be.

Format details

  • CSV — comma-separated, universally importable.

  • Excel — tab-separated values saved with a .xls extension and a UTF-8 BOM, so Excel opens it cleanly with correct µ characters. (No .xlsx binary is produced.)

File contents

Each file begins with a #-prefixed metadata header, then the data rows:

  • Header block — device label, variant, period, resolution, working-hours configuration, generation timestamp, and (optionally) the statistics summary and time-distribution breakdown.

  • Column headerTimestamp, Time, PM2.5 (µg/m³), PM10 (µg/m³).

  • Optional marker columnsis_working_hours, is_weekend are added when the working-hours filter is not applied, so you can filter in your own tool instead.

  • Optional comparison columnsPM2.5_previous, PM10_previous when Include comparison period is on.

Working-hours behaviour

Apply working-hours filter
Result

On

Rows outside the working window are removed; statistics match the filtered rows.

Off

All rows are kept and is_working_hours / is_weekend marker columns are added.

Caching

If the chosen range and resolution match what the chart already loaded, the export reuses that cached data instead of re-fetching. Changing the range or resolution triggers a fresh fetch on download.

Filename

Example: airwatch-history_Hall-3-Sensor_20260625-0000_to_20260626-0000.xls


PDF Report

The PDF Report button opens a dialog containing a configuration card and, after the first preview, a live preview of the document. The PDF is generated through the browser's print-to-PDF — no separate file is downloaded from a server.

The report is single-device: it summarises one AirWatch device, with a built-in executive summary and methodology section so it is self-explanatory when shared.

Report configuration

Before generating a preview, you can define custom report metadata and settings.

Setting
Type
Default
Effect

Time Period

Day / Week toggle

Day

Reporting window and chart resolution

Period navigation

Prev / Next arrows

Current

Step through past periods

Chart Size

Compact / Normal / Large

Normal

Pixel height of the Historical chart

Customer / Company

Free text

empty

Printed on the cover page

Project / Location

Free text

empty

Printed on the cover page

Additional Notes

Free text

empty

Printed on the cover page

Compare with Previous Period

Toggle

off

Adds previous-period overlay and trend deltas

Working Hours Filter

Toggle (+ sub-settings)

off

Restricts statistics to working hours only

Time Period

Time Period
Window
Chart resolution
Comparison range (when enabled)

Day

Calendar day (00:00–24:00)

15-minute buckets

Previous calendar day

Week

Calendar week (Mon–Sun)

1-hour buckets

Previous calendar week

The period label (e.g. "May 5, 2026" or "Apr 28 – May 4, 2026") appears between the navigation arrows. The "next" arrow is disabled on the current period.

Chart Size

Controls the pixel height of the Historical chart on its dedicated page.

Option
Chart height

Compact

420 px

Normal

520 px

Large

600 px

Report Information (custom metadata)

Three optional free-text fields printed on the cover page: Customer / Company, Project / Location, Additional Notes. Empty fields are omitted. The device serial number is always printed in the header notes line.

Report Options

Compare with Previous Period

When enabled, the report fetches the previous period (yesterday for Day, last calendar week for Week) and:

  • overlays a dashed previous-period line on the Historical chart for PM2.5 and PM10,

  • adds previous-period values and trend arrows to the Statistics section.

Trend classification uses a 5% deadband: changes smaller than ±5% are reported as Stable.

Working Hours Filter

When enabled, all statistics, time distributions, exceedance counts, and trends use only data points inside the configured working hours. The Historical chart shows vertical boundary markers at the start/end times.

Sub-setting
Default
Effect

Start Time

06:00

Beginning of the working window

End Time

16:00

End of the working window

Exclude weekends

on

Skip Saturday and Sunday entirely

The working-hours configuration is also printed on the cover page.

Generating the report

  1. Pick the Time Period and navigate to the desired window.

  2. Optionally fill in Customer, Project, and Notes.

  3. Toggle Compare and/or Working Hours as needed.

  4. Click Generate Preview — data is fetched and the preview renders.

  5. Click Print / Save PDF — opens the browser print dialog.

  6. Choose Save as PDF as the destination (or print directly).

The PDF is hardcoded to A4 landscape with 10 mm margins. For best results:

  • Enable Background graphics so coloured badges and chart zones print correctly.

  • Set margins to Default or None (margins are controlled by the report's CSS).

  • If a section looks tight, lower the Chart Size to Compact and re-generate.

Report structure

The single-device PDF has a deterministic layout:

Page
Section

1

Header + Executive Summary

2

Historical Air Quality (full-page chart)

3

Statistics & Distribution

4

Methodology

Footer

Data-coverage note (points received vs. expected)

Page 1 — Header + Executive Summary

Report title (AirWatch Device Report), device name (and site name if available), reporting period, generation timestamp, optional Customer/Project/Notes, working-hours configuration (if enabled), comparison range (if enabled), and a narrative Executive Summary of top-line trends.

Page 2 — Historical Air Quality

A full-page time-series chart for the single device, titled Historical Air Quality — {device} with a Single-device readings (SN: …) scope label. Includes PM10 quality-range background bands, PM2.5 (orange) and PM10 (blue) lines, period-average reference lines, optional previous-period overlay, and working-hours boundary markers.

Page 3 — Statistics & Distribution

  1. Period Statistics — average, min, max, median for PM2.5 and PM10 (with previous-period values and trend deltas when comparison is on).

  2. Time Distribution — percentage of time spent in each air-quality range.

  3. Exceedance Summary — minutes and number of events above each elevated threshold.

  4. Peak Events — the five highest PM2.5 and PM10 readings (deduplicated within 30 minutes), with timestamps.

All blocks use the working-hours-filtered dataset when the filter is on.

Page 4 — Methodology

A short, always-included section explaining how averages, peaks, 4-hour averages, and air-quality classifications are derived, so the report is interpretable out of context.

Property
Value

Page size

A4 landscape (297 × 210 mm)

Margins

10 mm on all sides

Page-break behaviour

Each major section starts on a fresh page


Export vs. PDF Report — which to use?

Need
Use

Open the numbers in Excel / a BI tool

Export (CSV / Excel)

Custom calculations or charts

Export

A polished document to share or archive

PDF Report

Compliance / audit evidence for one device

PDF Report

A single document covering all devices on a site

Site Air Quality Reports

Report disclaimer

  • History — The tab these features live in

  • Dashboard — Current measurements

  • Site Air Quality Reports — Site-wide, multi-device PDF

  • Air Quality Levels — PM range definitions and WHO reference values

Last updated