Skip to content

Data to Attribute

Data to Attribute takes a record with many fields and picks the ones you need, each through a separate output of the component. You decide which field goes to each output and what that output is called on the canvas.

This lets you connect, for example, the customer’s name to one component and their email to another, without passing the whole record to each.

When to use it

  • Split a contact’s name, email and phone so you can send them to different steps.
  • Take only an order’s amount to a condition that decides whether approval is needed.
  • Use a value that sits inside another, such as the city inside the customer’s address.
  • Keep the canvas clear, with outputs named after the value they carry.

Configuration

FieldWhat it does
Input DataThe record you want to pick fields from.
Number of MappingsHow many fields you want to pick, from 1 to 15. Default: 1. Each one adds a new output to the component.

For each field a group Mapping 1, Mapping 2, and so on appears, with two fields:

FieldWhat it does
Source Attribute (required)The name of the field you want to pick. For a field inside another one, separate the names with a dot, for example customer.address.city.
Output Name (required)The name of the output on the canvas. If you leave it empty, the output is called Mapping 1, Mapping 2, and so on.

Output

The component has one output for each configured field, named as you set in Output Name. Each output returns the value of that field as text.

Example

A contact form arrives as a record with the fields name, email and company. You set Number of Mappings to 2: in the first one, Source Attribute name and Output Name Customer name; in the second, email and Email. You connect Customer name to the welcome message template and Email to the component that sends it.

Good practices

  • Write the field name exactly as it appears in the data, including upper and lower case.
  • Run the previous step and check its result to see the exact field names.