Collect
Operation Conversion
Collect is a widget flow node that allows you to collect data.
Description
During execution, the Collect widget flow node creates a collected record, which can later be viewed in the Results tab in Studio.
Configuration
The configuration consists of a key-value list of entries to be included in the collected record.
Fields
Fields – a list of key-value pairs to collect. Each field has:
- Key – the name of the field in the collected record
- Value – the value to collect. You can use context values to make the value dynamic
Partition
Partition acts as a logical label for your data. Physically, all collected records are stored together. However, this may be inconvenient—for example, if you have multiple Collect flow nodes in one widget flow. Displaying their records in a single table often results in sparse and fragmented data. To address this, we provide filtering by partition. You can assign the same partition name to multiple Collect flow nodes, allowing their data to appear in a single, cohesive table. Partitions are scoped to the widget. A default partition name is automatically generated when a widget flow node is created, but you can change it at any time. Please note that previously saved records will retain the old partition name.
TIP
It may also be a good idea to change the partition
value if you significantly modify the data format in an existing Collect flow node. This helps prevent mixing data in different formats and ensures that you can always return to your historical records.
Sync
Sync enables synchronous collection. By default, Collect does not block the flow or require the user to wait. However, if you need the ID of the created record for subsequent steps in the flow, you can enable this option to make the node wait for the record creation to complete.
WARNING
By default, errors in the Collect flow node are ignored. However, if Sync is enabled, the flow execution will be halted, an error message will be shown to the user, and an error event will be recorded.
Limitations
Name | Value |
---|---|
Max data keys | 50 |
Max partition length | 256 characters |
Max field key length | 64 characters |
Max field value length | 1024 characters |
Inputs | Exactly one |
Outputs | Exactly one |
Context values
A record_id
is added only if sync
is enabled. Otherwise, no value is added.