Skip to main content

Split

Category: Transform
Node id: split

Splits data by string delimiter, array chunking, or batch partitioning

What it does​

  • Three split modes: string delimiter, array chunking, batch partitioning
  • Whitespace trimming for string splits
  • Even distribution across batch partitions
  • Configurable chunk sizes for array splitting

Use cases​

  • Split CSV lines into individual fields
  • Chunk large FHIR bundles into smaller batches for parallel processing
  • Partition patient lists for distributed workload assignment

Runtime​

  • Performance tier: fast

Input ports​

NameTypeRequiredDescription
valuetextNoString to split (for string split type)
datajsonNoArray to split (for array and batch split types)

Output ports​

NameTypeRequiredDescription
resultjsonNoSplit result containing parts/chunks/batches and metadata
countnumberNoNumber of parts/chunks/batches produced
successbooleanNoWhether the split operation succeeded

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Split Typesplit_typeenumYesstringstring, array, batchHow to split the data
DelimiterdelimiterstringNo,Delimiter for string splitting
Chunk Sizechunk_sizenumberNo10min 1Number of items per chunk (for array split)
Batch Countbatch_countnumberNo2min 1Number of batches to split into (for batch split)

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Trim WhitespacetrimbooleanNotrueTrim whitespace from split string parts

Errors​

CodeDescription
UNSUPPORTED_SPLIT_TYPEThe specified split_type is not recognized
MISSING_INPUTRequired input (value or data) is missing for the selected split type

Runtime notes​

  • The result shape differs by split_type: string has parts[], array has chunks[], batch has batches[]
  • String split trims whitespace by default; set trim=false in config to preserve it
  • Batch split distributes remainder items across the first N batches for even distribution
  • Wire the value input for string splitting or the data input for array/batch splitting

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Something unclear? Send documentation feedback by email.