For the complete documentation index, see /llms.txt. The full corpus is available at /llms-full.txt. Most pages have a raw markdown variant; append .md to the URL or send Accept: text/markdown.
PricingComplianceCareersTry Assist freeBook a demo

Docs  |  User Guides

Import

The Import page is your gateway for bringing data into the app. It is organized into two tabs: File for uploading data from local files, and Integrations for viewing hardware and software connections that push data into Invert automatically. The History button in the top right corner opens the import history for the tab you are on.

File Tab

This is the primary method for uploading bioprocess data from files. Pick a file, choose a mapping, and press Start import to initiate ingestion.

  • Step 1: File Picker

    Select one or more files from your computer using the file picker. Supported file extensions are .csv, .xls, .xlsx, .xlsm, .json, .parquet, .lcd, and .dino. Not every mapping supports every file type; if the selected mapping cannot read the file, the page reports it before the import starts. You can upload multiple files at once, as long as they use the same mapping. It is recommended to carefully review files before ingestion to avoid importing faulty data.

  • Step 2: Mapping Picker

    Select the mapping that best fits your data structure. Mappings are available for run data, timeseries data, run events, and Invert export files; your organization can also have custom mappings. Custom mappings can be added to the list upon request. When a mapping has an example, the page shows Example (partial) data below the picker, with Download template to get a blank file in the expected structure. Refer to the Mapping Guide below for more information on a particular mapping.

    When you upload a file, Invert will automatically suggest a mapping if it can infer the format from your file's structure. Accept the suggestion with Apply mapping or dismiss it to choose manually.

  • Step 3: Settings (Timeseries Data Only)

    When importing timeseries data, set Timeseries Import Mode to either Merge or Replace. Choose Merge to update an existing dataset by either overwriting or appending data. Alternatively, select Replace to discard the existing timeseries data for the imported metrics on the selected runs and replace it entirely with the imported data.

    Mappings that use relative time convert the time column into absolute time at ingestion, based on the current run start time. If you change the run start time later, re-import the data.

  • Step 4: Start Import

    Click Start import to initiate file ingestion. This will direct you to the Importing page where you can review Import details for more information on ingestion status. Depending on the file size, file ingestion may take up to several minutes to complete.

  • Step 5: Ingestion Evaluation

    • Step 5.1: Successful File Uploads

      Upon file ingestion, ensure data imported into Invert meet your expectations. The page has a tab per data type created by the import — for example Runs, Metrics, Events, or Material Streams — for a comprehensive overview of the imported data. The Import details sidebar gives who initiated the import (with Via Assist when Assist staged it), the mapping used, the timeseries mode, the status, the counts per data type, and a download link for the source file. Use Analyze in the top right corner to start a new report from the imported data. Consider editing and re-uploading files to update or replace data inside the app as needed.

    • Step 5.2: Failed ingestion attempts

      Failed file ingestions may occur if the source file contains unexpected or incomplete data, or if the file structure is not supported by the selected mapping. Consult the error log on the Importing page for details and verify the file meets the mapping criteria. For organizations with Assist enabled, use Fix with Assist on the failed import to diagnose the failure and stage a corrected ingestion for your review. Contact Invert support via Help & Support if you need further assistance.

Ingestion Preview

Ingestion Preview lets you see exactly what will be imported before any data is committed. Use the Preview before import toggle to turn it on or off; it is on by default. Preview applies to single-file uploads only — if you select more than one file, the import starts without a preview.

Invert processes the file and shows a structured summary of what would be created, organized into tabs (Runs, Library, Timeseries, Events, and, where the file contains them, Lineage, Samples, and Measurements) so you can catch mapping issues or unexpected data before they land in your workspace. Each tab name shows a count of items, and tabs with zero items are grayed out and non-clickable. The Library tab lists the unique metrics and properties detected in the file so you can verify nomenclature before approval. Click Complete import to proceed with the actual import, Dismiss to discard the preview without importing anything, or go back to adjust the file or mapping.

The preview is based on the previewed file only. If other files are processed at the same time, the final result can differ.

Mapping Guide

  • Run Data
    • Description: Metadata associated with a run
    • Example: LOT#, Reactor ID, Site, Operator
    • Mapping: 'Run Data'
      • Required Columns:
        • Run
        • Metric A (unit)
      • Recommended Columns:
        • Experiment
  • Timeseries Data
    • Description: Time-based metrics
    • Example: Time (h) versus Temperature (**°**C)
    • Mapping:
      • Timeseries Data (absolute time)
        • Required Columns:
          • Run
          • Timestamp
          • Metric A (unit)
      • Timeseries Data (relative time)
        • Required Columns:
          • Run
          • Time (h) or Time (min)
          • Metric A (unit)
  • Run Events
    • Description: Notes associated with a run.
    • Example: Reactor Foaming @ 24h EFT
    • Mapping:
      • Run Events (absolute time)
        • Required Columns:
          • Run
          • Timestamp
          • Event Type
      • Run Events (relative time)
        • Required Columns:
          • Run
          • Time (h) or Time (min)
          • Event Type
  • Invert Data
    • Description: Import data from an Invert export file
    • Example: Time (h) versus Temperature (**°**C)
    • Mapping:
      • Invert Data
        • Required Columns:
          • Export file structure generated by Invert

Integrations Tab

The Integrations tab lists all configured data sources for your organization — hardware agents, ELN connections, and other automated data streams. Each card gives the data source name, the date of the latest import, a Live pill while an ingestion is in progress, a Failed badge when the last ingestion failed, and a Manual badge for sources that are fed by file upload. Clicking a data source opens its detail page where you can review the connection configuration and its ingestion activity. Connectors opens the connector overview for your organization.

Import History

Navigate to the Import History page for an overview of all historical file ingestions. Use the Manual and Integrations toggle to switch between file uploads and integration ingestions. The list gives the source data file, the mapping used, when the import was created, who created it, and its status; imports staged by Assist are marked Via Assist and imports created by an Automation are marked Via Automation. Select View on an entry to open the import, where you can see the runs and metrics created and download the original source file.

Use the filters above the list to narrow it down by mapping, source data file name, who created the import, creation date, or status.

ExperimentsRuns