← Back to all posts

Type Convert

On this page

Purpose

Type Convert bridges Message, Data, and DataFrame values when connected components need different supported types.

When to use it

  • Convert a Message into Data or DataFrame.
  • Convert a DataFrame to a Data result.
  • Preserve text when a downstream component expects a Message.

How to use it

  1. Connect the source value to Input.
  2. Select Message, Data, or DataFrame as Output Type.
  3. Connect the matching output to the downstream component.

Configuration

SettingWhat it controlsRecommended starting point
Output TypeSelects Message, Data, or DataFrame. The default is Message.Match the next component's input.
Auto ParseParses Message text as JSON or CSV when converting to Data or DataFrame.Keep it off when text must remain unchanged.

Expected result

With Auto Parse off, text stays text. With it on, valid JSON or CSV can become structured data. A DataFrame converted to Data uses a results field, and a JSON array converted to Data uses records. The component exposes one output handle at a time, so recheck downstream wiring after changing Output Type. A list input uses its first item and an empty list fails.

Reference details

Auto Parse applies only to Message input. It falls back to the original text when it cannot parse the value.

← Back to all posts