Object - Pick

Type identifier: object:pick Category: Object Operations

Description

Extracts specific properties from an object or Record. Creates individual output handles for each selected property, allowing you to access nested fields without using expressions. Automatically adapts output handles based on the connected object's Schema.

Input Handles

Handle	Data Type	Required	Description
`object`	`object`	Yes	The object to extract values from

Input Handle Details

`object`

Type: object or Record
Notes:
- Supports plain objects, Schema-based Records, and arrays
- The connected source determines available pickable properties

Output Handles

Handle	Data Type	Description
`<propertyPath>`	Varies	One handle per selected property

Output Handle Details

Property Handles

Output handles are dynamically generated based on selectedProperties:

Handle ID: Dot-notation path to the property (for example, name, address.city)
Type: Inferred from the source object's Schema
Notes:
- Handles are created for each selected property
- Only connected output handles are evaluated
- File entries are augmented with Record context or Flow run context
- Content types (images, videos, files) receive appropriate context metadata

Configuration Options

Property	Type	Required	Default	Description
`label`	`string`	Yes	`"Object - Pick"`	Display label for the node
`selectedProperties`	`string[][]`	Yes	`[]`	Paths to properties to extract

Configuration Details

`selectedProperties`

Type: string[][] (array of path arrays)
Format: Each inner array represents a path (for example, ["address", "city"] for address.city)
Notes:
- Paths follow Schema property structure
- Only selected properties create output handles
- Invalid paths are pruned when the source Schema changes

Behaviour

Execution Flow

Resolves the object input handle
Validates object is not null or undefined
For each connected output handle:

Extracts the value at the specified path
Augments file entries with context (Record or run)
Augments content nodes (images, videos, etc.) with context

Produces the requested output values

Property Selection UI

The node provides an interactive property selector:

Schema properties are listed from connected source
User toggles checkboxes to select/deselect properties
Output handles update dynamically
Orphaned edges are pruned when the Schema changes

Context Augmentation

File and content values receive additional context:

Source Type	Added Context
Existing Record	`spaceId`, `schemaId`, `entityId`
New Record (from a Flow)	`spaceId`, `flowId`, `executionId`
File with existing context	No changes

Error Handling

Scenario	Behaviour
Object is undefined	Throws error
Object is null	Throws error
Object is not an object	Throws error
Property path not found	Returns `null`

Examples

Basic Property Extraction

{
  "type": "object:pick",
  "data": {
    "label": "Object - Pick - User",
    "selectedProperties": [["name"], ["email"], ["address", "city"]]
  }
}

Creates output handles: name, email, address.city

Picking From Object - Query Results

{
  "type": "object:pick",
  "data": {
    "label": "Object - Pick - Order",
    "selectedProperties": [["id"], ["total"], ["items"], ["customer", "name"]]
  }
}

When connected to an Object - Query result, extracts specific fields from the queried Record.

Extracting File Properties

{
  "type": "object:pick",
  "data": {
    "label": "Extract Document",
    "selectedProperties": [["document"], ["uploadedAt"]]
  }
}

File values are automatically augmented with context for proper resolution.

Data - Expression

Evaluates a mathematical or logical expression with variables. Supports arithmetic, string manipulation, date/time operations, similarity functions, and array operations. Use this node for calculations, transformations, and complex data logic.

Object - Create

Creates a new Record in a specified Schema. The created Record can be queried or modified by subsequent nodes in the Flow.

Object - Pack

Combines selected property values into a Schema-validated object, or validates a data input against a non-object Schema. The configured Schema can be inline or reference an existing Schema.

Object - Query

Queries Records based on filter criteria. Supports complex filtering, pagination, and ordering. Returns matching Records with metadata. Results can be processed, displayed, or passed to downstream nodes.