Files

Files is the browser for the objects your Organization has stored outside the time-series database: CSV exports written by pipelines, uploaded utility bills, and anything else the platform has put away on your behalf. Open a folder, find the file, download it or chart it in place.

Overview

Open Data → Files in the sidebar, next to Explorer. The screen is two resizable panels: a folder tree on the left under the heading Folders, and the files inside the selected folder on the right.

The page is read-only. There is no upload button, no delete, and no way to create or rename a folder here. Everything listed was written by something else in the platform, and the two things you can do with a file are download it and, when it is a CSV, chart it without leaving the page.

Every authenticated member of the Organization can reach the page. Unlike Dashboards or Alarms it carries no permission of its own, so files are visible to anyone who can sign in to the Organization. Bear that in mind when a pipeline is deciding what to write.

Where Files Come From

Nothing arrives here by hand. The two producers worth knowing about are pipelines and energy management.

A pipeline with a Store File action writes its output here, and the folder the file lands in is the directory that the pipeline itself specifies. That is why the folder tree tends to read like a list of jobs rather than a filing system: it mirrors how your pipelines were set up. If you want a tidier tree, change the directories your pipelines write to.

Utility bills uploaded through Energy Management are stored the same way and appear under their own folder.

Not everything the platform stores shows up here. Logos, images and JCAHO report uploads are kept separately and are managed on the screens that own them.

Browsing Folders

The Folders panel is a tree. Each row shows a folder name and, on the right, the number of files it holds, counted through its subfolders as well as its own, so a parent tells you the size of the whole branch at a glance.

Click a folder to select it and load its contents. A folder with children expands when you select it, and the chevron on the left collapses it again. The tree is keyboard navigable: Enter or Space selects, Right Arrow expands, Left Arrow collapses.

If an Organization has no stored files at all, the panel reads No folders and there is nothing to select.

The File List

Selecting a folder fills the right panel. Until you do, the list shows No Files with the prompt Select a folder to view its files., and a folder that is genuinely empty reads No files in this folder. instead.

The list shows two columns: Name, with an icon that distinguishes CSVs from other file types, and Created, the date and time the file was stored. Newest first. Twenty rows to a page, adjustable from Rows per page at the bottom, where the counter reports which slice of the total you are looking at.

The search box above the list filters the current folder by file name and is not a search across the whole Organization: pick the folder first, then search inside it. Press / anywhere on the page to jump into it, and Escape to clear it.

Three icon buttons sit at the top right of the list. Columns hides the Created column when you only want names, Density switches between Comfortable and Compact rows, and Export writes the list itself (name, created date and file type) out as CSV or JSON. Export gives you the inventory, not the files.

Hovering a row reveals its actions. Download fetches the file through the platform, so it works the same way for everyone with access and needs no separate storage credentials. View chart appears only on .csv files.

Charting a CSV

View chart opens the file in a dialog rather than downloading it, which is the quicker way to answer "did this export capture what I expected" before pulling the file into a spreadsheet.

The dialog reads the CSV as a time series: a line chart across the top with a legend, a zoom slider and the usual chart toolbox, and the parsed rows underneath as a table with a Timestamp column and one column per series. Column headers sort ascending, then descending, then back to the file's own order. Numeric values are shown to three decimal places, and a gap in the data reads as -.

The preview only handles CSV, and only files it can find a chartable time column in. A file with no usable series reports No chartable data in this file. rather than an empty chart.

Related Workflow Stages

Files sits at the far end of the Store stage. Readings that were Connected and Collected are stored as time series and queried through the Data Explorer (Data Explorer); anything a pipeline turns into a document lands here instead.

Because the folder structure is decided by whatever wrote the file, the useful upstream reference is the pipeline configuration itself. Downstream, a stored CSV is usually on its way into a report or an outside system, which is the Report and Integrate territory covered by Reports and the API reference.