Cleansing Workflow Validation Errors

cleansing workflow validation errors

The Data Cleansing module uses a visual flow builder where transformation rules are represented as connected nodes. Before the workflow can be applied, MatchLogic validates that the flow is structurally correct and that all nodes are properly configured. Validation errors prevent the workflow from running until they are resolved.

How to See Validation Errors

When a validation error exists, affected nodes display a red error indicator (typically a warning icon or red border). Hover over the indicator on any node to read the specific error message for that node. A summary of all errors may also appear when you click "Apply Rules."

Common Validation Errors

"Disconnected Node"

Every node in the workflow must be part of a continuous chain from the Start node to the End node. An orphaned node — one that exists on the canvas but is not connected — will trigger this error.

Fix: Either connect the node to the appropriate position in the flow, or delete it if it is not needed. Use the delete key or right-click menu to remove unwanted nodes.

"Missing Required Parameter"

Some nodes require configuration before they can run. For example:

  • A Replace node needs both a "Find" value and a "Replace With" value.
  • A Regex Replace node needs a valid regex pattern and a replacement string.
  • A WordSmith node needs a dictionary to be selected.

Fix: Click the node to open its configuration panel and fill in all required fields.

"Invalid Regex Pattern"

If a regex node contains a pattern that does not compile (e.g., an unclosed bracket or invalid escape sequence), this error appears.

Fix: Test your regex pattern in an external tool such as regex101.com before entering it. Correct the pattern in the node's configuration panel.

"Cycle Detected"

The workflow must flow in one direction — from Start to End — with no loops. Connecting a node's output back to an earlier node creates a cycle, which is not allowed.

Fix: Review the connections and remove any backward-pointing edges. If you need to repeat a transformation, duplicate the node and place it further down in the linear chain.

"No Input Column Selected"

Transformation nodes must have a source column specified. If a node has no column assigned, it cannot process data.

Fix: Open the node's settings and select the input column you want to transform.

Tip: Save your workflow frequently using the Save button. Validation errors do not prevent saving — they only prevent applying the rules. You can save an incomplete workflow and return to it later.
Note: Fixing one error may reveal additional errors that were previously hidden. Work through errors one at a time and re-validate after each fix.