> For the complete documentation index, see [llms.txt](https://docs.kemperconnect.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kemperconnect.de/asset-types/airwatch/airwatch-export-and-reports.md). # AirWatch Export & Reports 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 header** — `Timestamp`, `Time`, `PM2.5 (µg/m³)`, `PM10 (µg/m³)`. * **Optional marker columns** — `is_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 columns** — `PM2.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 ``` airwatch-history_{device}_{start}_to_{end}.{csv|xls} ``` 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. {% hint style="warning" %} All settings are applied when you click **Generate Preview**. Changing a setting afterwards does not auto-refresh — re-click **Generate Preview**. {% endhint %}
| 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). #### Print dialog tips
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. #### Print format | 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 {% hint style="warning" %} Both outputs are based on **ambient air monitoring** data from KEMPER AirWatch sensors. They are intended for facility-level monitoring and trend analysis, and are **not** a substitute for personal exposure measurement, a regulatory compliance determination, or an Occupational Exposure Limit (OEL) measurement. PM range labels are health-oriented references derived from WHO 24-hour guideline values, not statutory limits. {% endhint %} ### Related Documentation * 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.kemperconnect.de/asset-types/airwatch/airwatch-export-and-reports.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.