Skip to main content

Extract Values

This node creates a simple array of values from an array of objects.

The Extract Values node (also known as Pluck) isolates a single property from a list of objects.

The Extract Values node iterates through an array of objects and extracts the value of a specific property (defined by Key Path) from each one. The result is a flat array of those values.

Inputs​

Input​

DataDescription
ArrayThe source array of objects.

Extract Options​

DataDescription
Key PathThe property path to extract (e.g., "id", "user.email").

Actions​

SignalDescription
DoTriggers the extraction.

Outputs​

Data​

DataDescription
Extracted ArrayThe resulting array of values.

Signals​

SignalDescription
DoneTriggered when complete.

Usage​

Use this to simplify data for charts, dropdowns, or calculations.

Example Use Cases​

  1. Dropdown Values: Convert a list of User objects into a list of names for a dropdown menu.
    • Input: [{id:1, name:"Alice"}, {id:2, name:"Bob"}]
    • Key Path: name
    • Result: ["Alice", "Bob"]
  2. Chart Data: Extract sales from a list of DailyReport objects to feed into a Line Chart.
  3. ID List: Get a list of IDs to send to an API for bulk deletion.

Detailed Behavior​

  1. Deep Access: Supports dot notation (e.g., address.city).
  2. Preserves Order: The output array matches the order of the input array.
  3. Length Matching: The output array has the same length as the input array.

Troubleshooting​

  • Undefined Values: If a key path doesn't exist on an object, the extraction fails for that item.