Skip to main content

Spreadsheet For Each Row

Category: Spreadsheets Spreadsheet For Each Row block screenshot

Reads rows or columns from delimited spreadsheet data. Supported explicit file suffixes are `.csv`, `.tsv`, and `.tab`. If the provided path has no suffix, the runtime reads from `<path>.csv`. If the provided path has an unsupported explicit suffix such as `.xlsx`, the block fails clearly instead of guessing a format. Prefer this block over manual line splitting for `.csv`, `.tsv`, and `.tab` interchange. Empty cells are exposed as empty strings; missing cells for declared `cellVars` become empty strings, and extra cells beyond `cellVars` are ignored.

Inputs

InputRequiredValue KindTypesEnum Values
pathyesexpressionfile-path-string
axisnoenumenum-stringROW, COLUMN
fromnoexpression
tonoexpression
skipEmptynoexpression
cellVarsyesarrayarray

Notes

  • Reads delimited spreadsheet input, not native Excel workbook content.
  • Supported explicit file suffixes are .csv, .tsv, and .tab.
  • If the provided path has no suffix, the runtime reads from <path>.csv.
  • If the provided path has an unsupported explicit suffix such as .xlsx, the block fails clearly instead of guessing a format.
  • Prefer this block over forEachTextLine plus textSplit for .csv, .tsv, and .tab interchange.
  • Empty cells are exposed as empty strings.
  • If a row has fewer cells than cellVars, the remaining named variables are set to empty strings.
  • If a row has more cells than cellVars, the extra cells are ignored.
  • skipEmpty controls whether empty rows are skipped; it does not strip empty cells from non-empty rows.