---
title: "How to: Cast to String Using the Convert Field Operator"
slug: "convert-field-operator-cast-to-string"
description: "Learn to set up a Convert Field operator to change data types in your module, ensuring account values are stored as strings for better processing."
updated: 2025-11-12T14:25:30Z
published: 2025-11-12T14:25:30Z
canonical: "docs.unqork.io/convert-field-operator-cast-to-string"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to: Cast to String Using the Convert Field Operator

UDesignerClassic Designer

In this how-to guide, you’ll learn how to set up a **Convert Field operator to convert (cast) data to a string data type**.

> [!NOTE]
> These instructions assume you have a new module open, saved, and with a title.

## Configuration

For example, let's say you have a data set with account information. For data processing purposes, you want your **Account Value** data to be in the string data type. Doing so lets your data hold alphanumeric characters.

### Configure the Data Table Component

First, let's set up your account data using a [Data Table](/v1/docs/data-table-component) component.

1. In the Module Builder, drag and drop a **Data Table** component onto your canvas.
2. In the **Property ID** field, enter `dtAccounts`.
3. In the data table, enter the following:

| # | A | B | C |
| --- | --- | --- | --- |
| 1 | firstName | certification | accountValue |
| 2 | Blair | aws solutions architect | $1000000 |
| 3 | JJ |  | $6789.00 |
| 4 | Jim |  | 1000000 |
| 5 | Evan | aws developer | null |
| 6 | Charlotte | aws security | 5000000 |
| 7 | Amy | aws database | $5439294 |
| 8 | Brian | aws machine learning | $178.90 |
| 9 | Rupert | null | 195.78 |
| 10 | Emily | aws networking specialty | nine hundred thousand |

![Data table displaying names, certifications, and account values for various individuals.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/CastToString dtAccounts.png?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)
4. Click **Save Component**.

### Configure the Data Workflow Component

Next, let's set up your [Data Workflow](/v1/docs/data-workflow-component). You'll use an Input operator to bring in your data and use a Convert Field operator with the **Cast To** field set to **String**. You'll also include two Console operators so you can see how your data looks before and after the conversion.

1. Drag and drop a **Data Workflow** component onto your canvas, placing it below your Data Table component.
2. In the **Property ID** field, enter `dwfConvertFieldString`.
3. In the **Canvas Label Text**, enter `dwfConvertFieldString`.

#### Configure the Input Operator

1. Drag and drop an **Input** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Input |
| Component | dtAccounts |
| Required | Yes |
| Source | Default |

#### Configure the First Console Operator

1. Drag and drop a **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | Before |
3. Connect the output port (right) of the `dtAccounts` **Input** operator to the input port (left) of the `Before` **Console** operator.

#### Configure the Convert Field Operator

1. Drag and drop a **Convert Field** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Convert To |
| Label | Convert accountValue to String |
| Cast To | String |
| Keys | accountValue |
3. Connect the output port (right) of the `dtAccounts` **Input** operator to the input port (left) of the `Convert accountValue to String` **Convert Field** operator.

#### Configure the Second Console Operator

1. Drag and drop another **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | After |
3. Connect the output port (right) of the `Convert accountValue to String` **Convert Field** operator to the input port (left) of the `After` **Console** operator. ![Data workflow canvas showing Input, Convert Field, and Console operators.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/CastToString dwfConvertString.png?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)
4. Click **Save Component**.

### Configure the Button Component

Now, let's add a [Button](/v1/docs/button-component) component to trigger the entire operation.

1. Drag and drop a **Button** component onto your canvas, placing it below your Data Workflow component.
2. In the **Property ID** field, enter `btnConvert`.
3. In the **Label Text**, enter `Convert to String`.
4. From the **Action Type** drop-down, select **Event**.
5. From the **On Click** drop-down, select **dwfConvertFieldString**.

![Button component configuration with Action Type set to Event and dwfConvertString selected in the On Click dropdown.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/CastToString btnConvert.png?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)
6. Click **Save Component**.
7. **Save** your module.

Here's how your module looks in the Module Builder:

![Module Builder including dtAccounts Data Table component, dwfConvertFieldString Data Workflow component, and btnConvert Button component.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/CastToString ModuleBuilder.png?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)

Preview your module in Express View and open the DevTools Console. Click the **Convert to String** button. You'll see your data both before and after the conversion. Notice that the number values in your `Before` **Console** data display in blue. In your `After` **Console** data, everything displays as red, indicating everything is stored as a string.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_ConvertField_String_Express.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)

In this how-to guide, you’ll learn how to set up a **Convert Field operator to convert (cast) data to a string data type**.

> [!NOTE]
> These instructions assume you have a new module open, saved, and with a title.

## Configuration

For example, let's say you have a data set with account information. For data processing purposes, you want your **Account Value** data to be in the string data type. Doing so lets your data hold alphanumeric characters.

### Configure the Data Table Component

First, let's set up your account data using a [Data Table](/v1/docs/data-table-component) component.

1. In the Module Builder, drag and drop a **Data Table** component onto your canvas.
2. In the **Label Text** and **Property Name** fields, enter `dtAccounts`.
3. In the data table, enter the following:

| # | A | B | C |
| --- | --- | --- | --- |
| 1 | firstName | certification | accountValue |
| 2 | Blair | aws solutions architect | $1000000 |
| 3 | JJ |  | $6789.00 |
| 4 | Jim |  | 1000000 |
| 5 | Evan | aws developer | null |
| 6 | Charlotte | aws security | 5000000 |
| 7 | Amy | aws database | $5439294 |
| 8 | Brian | aws machine learning | $178.90 |
| 9 | Rupert | null | 195.78 |
| 10 | Emily | aws networking specialty | nine hundred thousand |

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_ConvertField_Number_Dt.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)
4. Click **Save**.

### Configure the Data Workflow Component

Next, let's set up your [Data Workflow](/v1/docs/data-workflow-component). You'll use an Input operator to bring in your data and use a Convert Field operator with the **Cast To** field set to **String**. You'll also include two Console operators so you can see how your data looks before and after the conversion.

1. Drag and drop a **Data Workflow** component onto your canvas, placing it below your Data Table component.
2. In the **Canvas Label Text** and **Property Name** fields, enter `dwfConvertFieldString`.

#### Configure the Input Operator

1. Drag and drop an **Input** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Input |
| Component | dtAccounts |
| Required | Yes |
| Source | Default |

#### Configure the First Console Operator

1. Drag and drop a **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | Before |
3. Connect the output port (right) of the `dtAccounts` **Input** operator to the input port (left) of the `Before` **Console** operator.

#### Configure the Convert Field Operator

1. Drag and drop a **Convert Field** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Convert To |
| Label | Convert accountValue to String |
| Cast To | String |
| Keys | accountValue |
3. Connect the output port (right) of the `dtAccounts` **Input** operator to the input port (left) of the `Convert accountValue to String` **Convert Field** operator.

#### Configure the Second Console Operator

1. Drag and drop another **Console** operator onto your Data Workflow canvas.
2. Configure the operator's **Info** window as follows:

| Setting | Value |
| --- | --- |
| Category | Console |
| Label | After |
3. Connect the output port (right) of the `Convert accountValue to String` **Convert Field** operator to the input port (left) of the `After` **Console** operator. ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_ConvertField_String_Dwf.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)
4. Click **Save**.

### Configure the Button Component

Now, let's add a [Button](/v1/docs/button-component) component to trigger the entire operation.

1. Drag and drop a **Button** component onto your canvas, placing it below your Data Workflow component.
2. In the **Property ID** field, enter `btnConvert`.
3. In the **Label Text** field, enter `Convert to String`.
4. Set the **Action Type** as **Event**.
5. In the **Trigger on Click** field, enter `dwfConvertFieldString`.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_ConvertField_String_Btn.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)
6. Click **Save**.
7. **Save** your module.

Here's how your module looks in the Module Builder:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_ConvertField_String_ME.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)

Preview your module in Express View and open the DevTools Console. Click the **Convert to String** button. You'll see your data both before and after the conversion. Notice that the number values in your `Before` **Console** data display in blue. In your `After` **Console** data, everything displays as red, indicating everything is stored as a string.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_ConvertField_String_Express(1).jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A17Z&se=2026-11-09T04%3A51%3A17Z&sr=c&sp=r&sig=L9%2BeQ99EkgULlbvCkzRjpCCAD45XkwTpvfnLU%2BMhh4Q%3D)

A string is an object that represents a sequence of characters. Strings typically hold data represented in text form.

Data types are a classification of data that determines how it is stored and interpreted.

A Property ID is the unique field ID used by Unqork to track and link components in your module.

Canvas Label Text indicates the purpose of the corresponding field or component. For non-input components, the Canvas Label Text isn't end-user facing, and only appears in the .

Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field.

The action performed by the button when selected.

Enter the Property ID of the component that you want to trigger on each button-click.

Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.

The DevTools Console helps you securely store, build, test, and deploy your software.

Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field.

A Property ID is the unique field ID used by Unqork to track and link components in your module.

## Related

- [Data Workflow Operators](/data-workflow-operators.md)
- [Data Workflow Component](/data-workflow-component.md)
- [Introduction to Data Workflow](/introduction-to-data-workflow.md)