Error Node

Overview

The Error Node redirects a workflow when the Plug-In component of an automated Screen/Task node module returns an error. In the Workflow Builder, the Error node attaches to that Screen/Task node in the Automated swimlane.

If your Plug-In already contains an error trigger, your Error node won't catch the error and redirect.

You’ll find the Error node in the list of nodes on the left of the Workflow Builder.

What You'll Learn

After completing this article, you’ll know when to use an Error node, how to configure its most commonly used settings, and understand the best practices.

Settings Menu Description

Next, let's explore the node's Settings Menu. This menu appears as a blue menu bar, either above or below the node, when you select the node itself. The Error node has these Settings Menu options:

Setting

Description

Edit

Takes you to the Edit Error Event window, where you can configure related settings.

Delete

Removes the node from the workflow.

Edit Error Event Window Description

A statice image displaying the Error node and the Edit Error Event window.

Clicking the Edit button displays the Edit Error Event window.

The following settings are available in the Edit Error Event window:

Setting

Description

Label

Sets the name of your node. By default, the Label displays as errorEvent-1. The label you enter here is optional and displays below the node on the workflow canvas.

Define your labels by associating them with the role of the node.

Adding an Error Node

For this use case, the workflow confirms if an end-user wants an error returned. If your end-user selects no, your workflow proceeds and returns a message retrieved from a transform. If your end-user selects yes, the Plug-In in the second Screen/Task node simulates an error. Then, your Error node returns the end-user to the first Screen/Task to answer the question again.

What You Need

To set up this use case, you need:

Configure the Screen/Task Nodes

Add three Screen/Task nodes to your workflow. The first Screen/Task node connects to the Start node. The second Screen/Task node uses Plug-In components to simulate an error response. The final Screen/Task node returns a message if no error occurs.

1. Drag and drop two Screen/Task nodes into the Authenticated swimlane.
2. Select a Screen/Task node.
3. Click Edit.
4. In the Label field, enter Input.
5. From the Module drop-down, enter or select Enablement Labs: Error Node Use Case-Input.

A static image displaying a workflow, the Screen/Task node is selected, the Label field and Module drop-down settings are highlighted.

6. Click X (Close).
7. Select the second Screen/Task node.
8. In the Label field, enter Result.
9. From the Module drop-down, enter or select Enablement Labs: Error Node Use Case-Result.
10. Click X (Close).
11. Drag and drop a third Screen/Task node into the Automated swimlane.
12. Click Edit.
13. In the Label field, enter Error Check.
14. From the Module drop-down, enter or select Enablement Labs: Error Node Use Case-Error Check .
15. Click X (Close).
16. Connect the output port (right) of the Start node to the input port (left) of the Input Screen/Task node.
17. Connect the output port (right) of the Input Screen/Task node to the input port (left) of the Error Check Screen/Task node.
18. Connect the output port (right) of the Error Check Screen/Task node to the input port (left) of the Result Screen/Task node.

Configure the Error Node

Next, add an Error node. Your Error node redirects the workflow path if a Plug-In error occurs.

1. Drag and drop an Error node onto your Error Check Screen/Task node.

2. Click Edit.
3. In the Label field, enter Error Event.
4. Connect the output port (bottom) of the Error node to the input port (left) of the Input Screen/Task node.
5. Click X (Close).

Configure the End Node

1. Drag and drop an End node into the Authenticated swimlane.
2. Click Edit.
3. In the Label field, enter End.
4. Connect the output port (right) of the Result Screen/Task node to the input port (left) of the End node.
5. Click Save....
6. Save your workflow.

Your workflow looks like the following image when finished:

A static image displaying a completed workflow using the Error node.

Resources