Skip to main content
Excel is the most widely used spreadsheet format for tabular business data, from account lists to product catalogs. With BonData, you can upload an Excel workbook directly to create data entities that integrate seamlessly with your Agent workflows - no external system required.

Uploading a File

BonData reads your workbook, discovers every sheet, and turns each one into its own entity.

Step 1: Prepare Your Workbook

  1. Header Row: The first populated row of each sheet is used as the column names
  2. One table per sheet: Each worksheet becomes a separate entity, named after the sheet
  3. Consistent rows: Keep the same columns across all rows in a sheet

Step 2: Upload in BonData

  1. Navigate to Integrations and click Add Data Source
  2. Select Excel as the source type
  3. Drag and drop your .xlsx or .xls file, or click to browse and select it
  4. BonData scans the workbook and lists each sheet with its detected columns and row count

Step 3: Select Sheets and Confirm

  1. Choose which sheets to import as entities
  2. Review the detected columns for each sheet
  3. Confirm to create the entities
Each sheet is read using its header row to determine columns, and rows below the header become records. Empty leading rows are skipped when locating the header.

Primary Key Detection

BonData automatically detects a primary key by finding a column whose value is unique and present across every row in the sheet. If no single column is unique on its own, BonData supports composite keys - a combination of columns that together uniquely identify each row. You can override the detected key when confirming the entity.

Required Fields

Available Data

  • Sheets as entities - Every worksheet in the workbook becomes its own entity
  • Columns from the header row - Column names and data types inferred from the sheet header and values
Supported formats: .xlsx and .xls. To refresh the data, re-upload an updated workbook - BonData re-reads the sheets and applies changes by primary key.