---
title: "Get Operator"
slug: "get-operator"
updated: 2025-11-04T18:07:27Z
published: 2025-11-04T18:07:27Z
canonical: "docs.unqork.io/get-operator"
---

> ## 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.

# Get Operator

UDesignerClassic Designer

## Overview

The **Get operator** retrieves a single data point from a large data set. Creators can also use this [operator](/v1/docs/data-workflow-operatorlibrary) to retrieve an entire row from a table or array.![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/getOperator_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

To use the Get operator, Creators need a data reference key to locate the data to retrieve. The reference key looks different depending on the amount of data you want to retrieve:

- `[0]`: This reference key points to an entire row. Using this key retrieves the entire first row of your data set.
- `[0]`.name: This reference key builds on the first, leading to a single value in the first row of your data set. Using this key returns only the value labeled `name `from that row.

> [!WARNING]
> You'll notice that `[1]` does not represent the first row of your data set. Arrays begin at `[0]` when creating your reference keys.

You can also use the Get operator to reference global variables. You'll first create a global variable key and value. Then, use the Get operator to reference the variable's key. This configuration works in conjunction with your Input operator. After setting the Input operator's **Component** setting to `vars`, you can use your global variable. This is a powerful feature that lets you easily reference data in all your Unqork environments.

> For more information on creating global variables, view our [Global Variables Administration](/v1/docs/global-variables-administration) article.

You'll find the Get operator under the [Array](/v1/docs/array-operators) group to the left of your [Data Workflow](/v1/docs/data-workflow-component) canvas.

## About the Info Window

Learn more about each setting in the Get operator's Info window:

| Setting | Description |
| --- | --- |
| **Category** | Grayed out and non-adjustable setting indicating the operation type. |
| **Label** | Sets the label for your operator, displaying below the operator on your Data Workflow canvas. This field is optional, but set a label if you use more than one of the same operator type. A label helps you identify your operators without opening any Info windows. |
| **Preserve Argument Type** | When selected, this setting ensures the argument data type is respected when the operator executes. |
| **Path** | This is the reference key leading to the data you want to retrieve. For example, `[0]` references the first row in your data set. And the key `[0].name` references the column labeled `name` in that first row. Or, you can use this field to reference a global variable key. |

## Adding a Get Operator

For this example, create a [Data Table](/v1/docs/data-table-component) component that stores a list of countries and their capitals. Then, set up a [Data Workflow](/v1/docs/data-workflow-component) component with two Get operators. One Get operator retrieves an entire row of data, and the other retrieves a single value.

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

### Configure the Data Table Component

First, you'll add a Data Table component to store some sample data.

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

|  | A | B |
| --- | --- | --- |
| 1 | country | capital |
| 2 | Afghanistan | Kabul |
| 3 | Albania | Tirana |
| 4 | Algeria | Algiers |
| 5 | Cambodia | Phnom Penh |
| 6 | Czech Republic | Prague |
| 7 | Andorra | Andorra la Vella |
| 8 | Austria | Vienna |

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/dtCountries_thumb_0_0(1).png?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)
4. Click **Save Component**.

### Configure the Hidden Component

Next, add a Hidden component to store the output from the Get operator retrieving a full row of data.

1. Drag and drop a **H****idden** component onto your canvas, placing it below your **dtCountries** **Data Table** component.
2. In the Property ID and Label Text fields, enter **firstRow**.
3. Click **Save Component**.

### Configure the Text Field Component

Configure a Text Field component to hold the output for the Get operator retrieving a single value. That way, you can display the value in Express View.

1. Drag and drop a **T****ext Field** component onto your canvas, placing it below your **firstRow** **H****idden** component.
2. In the Property ID field, enter **fifthCountry**.
3. In the Label Text field, enter `Fifth Country`.
4. From the **Input Behavior** drop-down, select Disable User Input.
5. Click **Save Component**.

### Configure the Data Workflow Component

Next, you'll add a Data Workflow component and an Input operator to retrieve the data from the Data Table component. Then, add two Get operators—one to retrieve the first row of your data set and one to retrieve a single value. Lastly, you'll add two Output operators to output your results.

1. Drag and drop a **D****ata Workflow** component onto your canvas, placing it between the **dtCountries** **Data Table** and **firstRow** **H****idden** components.
2. In the Property ID field, enter **dwfGet**.
3. In theCanvas Label Text, enter **dwfGet**.

#### Configure the Input Operator

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

| Info |
| --- |
| **Category** | Input |
| **Component** | dtCountries |
| **Required** | Yes |
| **Source** | Default |

#### Configure the Get First Row Get Operator

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

| Info |
| --- |
| **Category** | Get |
| **Label** | Get First Row |
| **Preserve Argument Type** | ☐ (**unchecked**) |
| **Path** | [0] |
3. Connect the output port (right) of the **dtCountries** **I****nput** operator to the input port (left) of the **Get First Row** **G****et** operator.

#### Configure the firstRow Output Operator

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

| Info |
| --- |
| **Category** | Output |
| **Component** | firstRow |
| **Action** | value |
3. Connect the output port (right) of the **Get First Row** **G****et** operator to the input port (left) of the **firstRow** **O****utput** operator.

#### Configure the Get Fifth Country Get Operator

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

| Info |
| --- |
| **Category** | Get |
| **Label** | Get Fifth Country |
| **Preserve Argument Type** | ☐ (**unchecked**) |
| **Path** | [4].country |

> [!NOTE]
> Remember, `[0]` is the first row. So, `[4]` retrieves data from the fifth row.
3. Connect the output port (right) of the **dtCountries** **I****nput** operator to the input port (left) of the **Get Fifth Country** **G****et** operator.

#### Configure the fifthCountry Output Operator

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

| Info |
| --- |
| **Category** | Output |
| **Component** | fifthCountry |
| **Action** | value |
3. Connect the output port (right) of the **Get Fifth Country** **G****et** operator to the input port (left) of the **fifthCountry** **O****utput** operator.

Here's how the completed Data Workflow looks:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/dwfGetComplete_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

1. Click **Save Component**.
2. **Save** your module.

Your completed module looks like the following:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/getOperatorModuleBuilder_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

**Preview** your module in Express View. You'll see the **Fifth Country** **T****ext Field** populates with Czech Republic. This is the country from the fifth row of your Data Table component, returned by your **Get Fifth Country** **G****et** operator. Open the DevTools Console and run the Angular command. Expand the **▶** **data:** tab to see the first row of data returned by your **Get First Row** **G****et** operator.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/get_operator_dataworkflow2_ja_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

## Overview

The **Get operator** retrieves a single data point from a large data set. Creators can also use this [operator](/v1/docs/data-workflow-operatorlibrary) to retrieve an entire row from a table or array.![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/getOperator_thumb_0_0(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

To use the Get Operator, Creators need a data reference key to locate the data to retrieve. The reference key looks slightly different depending on how much data you want:

- `[0]`: This reference key points to an entire row. Using this key retrieves the entire first row of your data set.
- `[0].name`: This reference key builds on the first, leading to a single value in the first row of your data set. Using this key returns only the value labeled name from that row.

> [!NOTE]
> You'll notice that `[1]` doesn't point to the first row of your data set. Remember that arrays start at `[0]` when creating your reference keys.

You can also use the Get operator to reference global variables. You'll first create a global variable key and value. Then, you'll use the Get operator to reference the variable's key. This configuration works in conjunction with your Input operator. After setting the Input operator's Component setting to vars, you can use your global variable. This is a powerful feature that lets you easily reference data in all your Unqork environments.

> For more information on creating global variables, view our [Global Variables Administration](/v1/docs/global-variables-administration) article.

You'll find the Get operator under the [Array](/v1/docs/array-operators) group to the left of your [Data Workflow](/v1/docs/data-workflow-component) canvas.

## About the Info Window

Learn more about each setting in the Get operator's Info window:

| Setting | Description |
| --- | --- |
| Label | Sets the label for your operator, displaying below the operator on your Data Workflow canvas. This field is optional, but set a label if you use more than one of the same operator type. A label helps you identify your operators without opening any Info windows. |
| Path | This is the reference key leading to the data you want to retrieve. For example, **[0]** references the first row in your data set. And the key **[0].name** references the column labeled name in that first row. Or, you can use this field to reference a global variable key. |

## Adding a Get Operator

For this example, create a [Data Table](/v1/docs/data-table-component) that holds a list of countries and their capitals. Then, you'll set up a [Data Workflow](/v1/docs/data-workflow-component) with two Get operators. One Get operator will retrieve an entire row of data, and the other will retrieve a single value.

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

### Configure the Data Table Component

First, add a Data Table component to hold some sample data.

1. In the Module Builder, drag and drop a **Data Table** component onto your canvas.
2. In the Property ID and Canvas Label Text fields, enter **dtCountries**.
3. To the left of the component's configuration window, click **D****ata**.
4. In the data table, enter the following:

|  | A | B |
| --- | --- | --- |
| 1 | country | capital |
| 2 | Afghanistan | Kabul |
| 3 | Albania | Tirana |
| 4 | Algeria | Algiers |
| 5 | Cambodia | Phnom Penh |
| 6 | Czech Republic | Prague |
| 7 | Andorra | Andorra la Vella |
| 8 | Austria | Vienna |

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Get_Operator_DT_thumb_0_0(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)
5. Click **Save & Close**.

### Configure the Hidden Component

Next, add a Hidden component to store the output from the Get operator retrieving a full row of data.

1. Drag and drop a **H****idden** component onto your canvas, placing it below your **Data Table** component.
2. In the Property ID and Canvas Label Text fields, enter `firstRow`.
3. Click **Save & Close**.

### Configure the Text Field Component

Configure a Text Field component to hold the output for the Get operator retrieving a single value. That way, you can display the value in Express View.

1. Drag and drop a **T****ext Field** component onto your canvas, placing it below your **H****idden** component.
2. In the Property ID field, enter fifthCountry.
3. In the Label Text field, enter `Fifth Country`.
4. Set **Disable User Input** to ![A toggle switch indicating an on/off state for a user interface element.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Group 1.png?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D) **(ON)**.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_SelectingData_TextField_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

1. Click **Save & Close**.

### Configure the Data Workflow Component

Next, add a Data Workflow component. Use an Input operator to retrieve the data from the Data Table component. Then, add two Get operators—one to retrieve the first row of your data set and one to retrieve a single cell. Lastly, you'll add two Output operators to output your results.

1. Drag and drop a **D****ata Workflow** component onto your canvas, placing it between the **Data Table** and **H****idden** components.
2. In the **Canvas Label Text** and **Property Name** fields, enter `dwfGet`.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Dwf_SelectingData_Get_Dwf_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

#### Configure the Input Operator

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

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

#### Configure the Get First Row Get Operator

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

| Setting | Value |
| --- | --- |
| Category | Get |
| Label | Get First Row |
| Path | [0] |
3. Connect the output port (right) of the **dtCountries** **I****nput** operator to the input port (left) of the **Get First Row** **G****et** operator.

#### Configure the firstRow Output Operator

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

| Setting | Value |
| --- | --- |
| Category | Output |
| Component | firstRow |
| Action | value |
3. Connect the output port (right) of the **Get First Row** **G****et** operator to the input port (left) of the **firstRow** **O****utput** operator.

#### Configure the Get Fifth Country Get Operator

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

| Setting | Value |
| --- | --- |
| Category | Get |
| Label | Get Fifth Country |
| Path | [4].country |

> [!NOTE]
> Remember, [0] is the first row. So, [4] pulls the fifth row.
3. Connect the output port (right) of the **dtCountries** **I****nput** operator to the input port (left) of the **Get Fifth Country** **G****et** operator.

#### Configure the fifthCountry Output Operator

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

| Setting | Value |
| --- | --- |
| Category | Output |
| Component | fifthCountry |
| Action | value |
3. Connect the output port (right) of the **Get Fifth Country** **G****et** operator to the input port (left) of the **fifthCountry** **O****utput** operator.
4. Click Save.
5. **Save** your module.

Your completed module looks like the following:

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/get_operator_dataworkflow_ja_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

**Preview** your module in Express View. You'll see the **Fifth Country** **T****ext Field** populates with Czech Republic. This is the country from the fifth row of your data table, returned by your **Get Fifth Country** **G****et** operator. Open the DevTools Console and run the Angular command. Expand the **▶** **data:** tab to see the first row of data returned by your **Get First Row** **G****et** operator.

![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/get_operator_dataworkflow2_ja_thumb_0_0(1).jpg?sv=2026-02-06&spr=https&st=2026-11-07T20%3A53%3A43Z&se=2026-11-07T21%3A53%3A43Z&sr=c&sp=r&sig=NPxN5VJX3m9pKp68d%2FLuu1M6yxeib9TgNljg1KPFHmM%3D)

## Resources

- [Modify the Get operator](/v1/docs/modifying-data-workflow-operators).
- [Introduction to Data Workflow](/v1/docs/introduction-to-data-workflow)
- [Introduction to Data Workflow Operators](/v1/docs/data-workflow-operators)
- [Data Workflow component](/v1/docs/data-workflow-component)
- [Input operator](/v1/docs/input-operator)
- [Output operator](/v1/docs/output-operator)

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.

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

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

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.

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 .

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

The Angular command, or data command, is a tool that displays submission data in a browser's developer console. In Express View, enter the following command in the devtool console: angular.element('.unqorkio-form').scope().submission