Projects

Projects and guests

The checkbox controls the project visibility. Disabled projects will be hidden where possible, resulting in a less cluttered and faster app.

A coordinate system and a unit of elevation can be assigned per project. Among other things, reporting and importing will make use of this.

Download a project

The download button retrieves all data of a project. Each line in the resulting JSONL file looks like this:

{

"vision42": "demo",

"device": "Indoor air quality",

"channel": "CO₂",

"key": 10428,

"time": "2024-06-23T16:06:06.369Z",

"epoch": 1719158766369,

"value": 2492,

"offset": null,

"unit": "ppm"

}

• Format: JavaScript Object Notation (JSON), implying UTF-8 character encoding

• Date/time: ISO 8601 with milliseconds in Coordinated Universal Time (UTC)

• Value: not invalid and relative to its instrument datum, if any

Restore a project

A downloaded project can be restored by uploading the JSONL file. This way, you can reduce the size of your database by deleting old values and have the option of restoring later. The upload will not overwrite existing data.

For large projects, it might be needed to split the file into smaller pieces, before upload. Free tools to do so can be found in the Microsoft Store. Linux example:

split --lines 2000000 Project.jsonl

Note: At the time of writing, browsers fail upwards of 2 million lines.

Periodic reports

In this table, you can add receivers, adjust the title, and set the period. The column last denotes when the report did last run. When empty, the past period will be reported on. Changing the period will clear last and thus resend the past period.

The subject of report messages will be prefixed with [report], to facilitate classification rules.

Currently, the available periods are:

• Daily, from midnight up to midnight.

• Weekly, from Monday up to Monday.

• Biweekly, from Monday up to the second Monday.

• Monthly, from the first day to the last day of the month.

No PDF file will be attached to report emails, because:

• It is often larger than the size limit of a typical email server, which would result in failed delivery.

• Sending large PDF files periodically, will sooner or later fill up the receivers mailbox. This would result in all email to the receiver being discarded, until space is freed up or added.

• A PDF file is not interactive.

• Correction of data after sending a report, would not be reflected in the PDF file.

Deleting old values

Old values of a project, be it measured or calculated, can easily be deleted in bulk up to a given date. This operation may take a while to complete, dependent on the size of your database. Closing or reloading the app window will break off the delete operation. Values marked invalid will be left behind, to aid future re-importing.