Circular Reference Errors in Data Workflow

A circular reference error occurs when an operator in a Data Workflow acts on a value that does not exist yet. It can also occur when an operator references itself as an input.

Describe the circular reference error to the Build Agent. The agent can often identify the cause and suggest a fix based on the Data Workflow configuration.

Removing Numerical Value Requirements in Data Workflow Inputs

If an input is zero or begins with zero, do not mark it as required in the Data Workflow. When a zero-value input is set to required, a circular reference error is almost certain to occur. To fix this, change the required setting in the Input operator from Yes to No.

Adding an Initializer Component with Inputs Set to Required

Any required input with a zero value can trigger a circular reference error. The Initializer component moves those inputs out of the Data Workflow and runs them in a controlled order. This ensures values exist before the Data Workflow fires.

Ask the Build Agent to walk through this configuration. Describe the circular reference error and the Data Workflow inputs involved. The agent can guide the Initializer setup for the specific module.

After configuring the Initializer, click UI View to open Express View and access the DevTools Console while running the Data Workflow. The circular reference error should no longer appear.

Creating a Greater Than Zero Argument

When numerical values are always greater than zero, add a Gate operator to enforce this condition. The Gate evaluates whether the argument is greater than zero. When the condition is met, data passes through and the circular reference does not trigger.

Configure the Gate operator with the following settings:

When checked, Do Not Sanitize Formula tells the operator to use the formula as-is. If unchecked, the operator removes special characters that can cause unexpected behavior.

Connect the output port of the Input operator to the input and argument ports of the Gate operator. If the wiring is unclear, describe the Data Workflow structure to the Build Agent and ask it to configure a Gate operator with this condition.

Click UI View to open Express View and confirm the circular reference error no longer displays in the DevTools Console.