Output Operator

Estimated Reading Time: 4 minutes

Overview

Where the Input operator is the starting point for your Data Workflow, the Output operator is the ending point. The Output operator contains a single input port to output data from the Data Workflow to a component in your module. Importantly, the Output operator can do more than just transfer a piece of data to a new component. You can also configure the operator to trigger an action.

You'll find the Output operator under the I/O group to the left of your Data Workflow canvas.

What You'll Learn

In this article, you'll learn what an Output operator is and how to configure it in a Data Workflow.

About the Info Window

And here's a breakdown of each setting in the Info window:

Setting	Description
Component	Your output destination or the component where you want the output value pushed to. Here, you'll see a drop-down containing the Property ID of every component in your module. Select the component you want to reference from the drop-down list. You can also type the name of the component's Property ID in the Component field and it will filter the drop-down based on your input. After selecting a Property ID, the Component field remains editable. You can type in the Component field to define a property path or target fields nested under the selected Property ID. Your selection here displays as the operator's label. TIP The Data Workflow component supports using grid referencing syntax to target the Dynamic Grid, Uniform Grid, and Freeform Grid components. Grid referencing syntax supports targeting at the component, column, row, and cell level. To learn more, see the following articles in our In-Product Help: Dynamic Grid: Targeted Logic and Referencing Syntax and Uniform Grid and Freeform Grid: Logic and Referencing Syntax.
Action	The action you want to output in your Data Workflow. The most common action is value, which outputs a value. To perform another type of action, select that specific action. For actions like clear, reset, visible, and disable you'll use a Create Value operator as the input. In the Create Value's expression/value field, add 'yes' or 'no' enclosed in single quotes. Then select the appropriate action in the Output operator. For a trigger output action, enter "GO" in the expression/value field.

Setting

Description

Component

Your output destination or the component where you want the output value pushed to. Here, you'll see a drop-down containing the Property ID of every component in your module. Select the component you want to reference from the drop-down list. You can also type the name of the component's Property ID in the Component field and it will filter the drop-down based on your input.

After selecting a Property ID, the Component field remains editable. You can type in the Component field to define a property path or target fields nested under the selected Property ID.

Your selection here displays as the operator's label.

TIP The Data Workflow component supports using grid referencing syntax to target the Dynamic Grid, Uniform Grid, and Freeform Grid components. Grid referencing syntax supports targeting at the component, column, row, and cell level. To learn more, see the following articles in our In-Product Help: Dynamic Grid: Targeted Logic and Referencing Syntax and Uniform Grid and Freeform Grid: Logic and Referencing Syntax.

Action

The action you want to output in your Data Workflow. The most common action is value, which outputs a value. To perform another type of action, select that specific action.

For actions like clear, reset, visible, and disable you'll use a Create Value operator as the input. In the Create Value's expression/value field, add 'yes' or 'no' enclosed in single quotes. Then select the appropriate action in the Output operator. For a trigger output action, enter "GO" in the expression/value field.

Manually-Defined Outputs

In some cases, you might want to reference an input that doesn't display in the Info window's Component drop-down. For example, the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. of components in imported modules.

To reference an input that doesn't display in the Component drop-down:

Select your

Output operator.

In the operator's Info window, select any Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. from the Component drop-down. The Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. displays below the

Output operator as a label.

On the Data Workflow canvas, double-click the

Output operator's label. The field becomes editable.

Enter the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. to use as an output.

Click outside the field to save your manually-defined output.

NOTE Reopening the Data Workflow component might not display your manually-defined output on the canvas, though the connection still exists. Consider using the Data Workflow component's Comment field to note the output.

Adding an Output Operator

To demonstrate an Output operator, take data from a Data Table component and output it to a Hidden component.

What You Need

For this configuration, you need:

1 Data Table component
1 Hidden component
1 Data Workflow component

To set up your Data Workflow, you need:

1 Input operator
1 Output operator

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.

In the Module Builder, drag and drop a Dropdown Component Icon

Data Table component onto your canvas.

In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. and Canvas Label Text Label Text conveys what the input component is and what information it displays. Enter the purpose of the corresponding component or field. fields, enter dtStates.

To the left of the component's configuration window, click Data Icon

Data.

In the data table, enter the following:

	A	B
1	state	capital
2	California	Sacramento
3	New York	Albany
4	Texas	Austin

Click Save & Close.

Configure the Hidden Component

Next, add a Hidden component to store the output from your Data Workflow.

Drag and drop a

Hidden component onto your canvas, placing it below your Dropdown Component Icon

Data Table component.

Click Save & Close.

Configure the Data Workflow Component

Lastly, configure a Data Workflow to process the data.

Drag and drop a Data Workflow Icon

Data Workflow component onto your canvas, placing it between your Dropdown Component Icon

Data Table and

Hidden components.

In the Canvas Label Text and Property Name fields, enter dwfStates.

Configure the Input Operator

Drag and drop an

Input operator onto your Data Workflow canvas.

Configure the

Input operator's Info window as follows:

Setting	Value
Category	Input
Component	dtStates
Required	Yes
Source	Default

Configure the Output Operator

Drag and drop an

Output operator onto your Data Workflow canvas.

Configure the

Output operator's Info window as follows:

Setting	Value
Category	Output
Component	dwfOutput
Action	Value

Connect the output port (right) of the

Input operator to the input port (left) of the

Output operator.

Click Save.

Save your module.

Your completed module looks like the following:

Preview your module in Express View Express View is how your end-user views you 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.. Open the DevTools Console and run the Angular command. Expand the data: tab and the dwfOutput to see the output data stored in the Hidden component.