Get Value By Key
Get Value By Key takes data with several fields and gives you only the one you care about. You enter the field name and the component returns its value, ready for the next step.
If the field sits inside another one, write the path with a dot between each level, for example customer.email. Upper or lower case doesn’t matter.
When to use it
- Keep only the customer’s email from a full form response.
- Pull the list of orders out of an online store’s response so you can go through it later.
- Get the total amount from an invoice another component has read.
- Pass an agent only the text of a received message, without the rest of the information.
Configuration
| Field | What it does |
|---|---|
| Input Data | The data or message you want to take the value from. Connect it from the previous component. |
| Key (required) | The field name. For nested fields, use dots: order.address.city. |
Output
The Value output returns the value it finds:
- If it’s a text, a number or a yes/no, you get it in the
textfield of a piece of data. - If it’s a group of fields, you get it as data with those fields.
- If it’s a list, you get one piece of data per item, ready to go through with a Loop.
Example
A flow receives orders from a store. Each order has many fields, but you only need the delivery city to assign the carrier. In Key you write shipping.city and connect Value to the component that picks the carrier.