Overview
This configuration guide provides the technical instructions required to insert, manage, and organize nodes within a Workflow template. A node represents a specific step or element within a workflow design. Proper node management ensures that executions are routed correctly, dependencies are established, and the workflow can be published successfully.
Prerequisites
- An existing workflow template.
Required Permissions
- Admin permissions with Workflow configuration access.
Configuration Steps
Insert a Node
To insert a node in the workflow template, follow these steps:
- Find the Nodes on the left side of the canvas in the Workflows Editor.
Locate the cursor over any of the icons corresponding to the available type of nodes.
Node types are: Task, Rule, Delay, Automation, Schedule, and Outcome node.
Drag and drop the node onto the canvas.
A Draft card appears. The draft badge indicates that a configuration is missing.
Enter a unique value in the Name field.
Element names must be unique among elements of the same type and a blank name counts as a value, so duplicate unnamed nodes are rejected. This name is mandatory for most nodes but optional for an Automation.
- Complete the required configuration for the specific node type.
The Draft badge clears once all required configuration is provided. - Click CREATE.
Rename a Node
- Locate the node.
- Click the ellipsis icon.
- Select Rename.
Change the value in the Name field and click RENAME.
Only new executions are affected by renaming a node. Running executions remain unchanged and continue using the version they were created from.
Delete a Node
- Locate the node.
- Click the ellipsis icon.
- Select Delete.
Click YES, DELETE NODE to confirm the action.
Deleting a node in a published workflow updates the status of the working version to Draft. Editing does not take the workflow offline; the last published version stays live and keeps executing while the new version is being built.
Autolayout Nodes
The Autolayout feature organizes the added nodes automatically in the canvas.
To organize the nodes using the Autolayout feature, follow these steps:
- Click the autolayout icon located in the upper-right corner of the grid.
- All nodes on the grid will be automatically organized.
The Autolayout feature organizes the added nodes automatically in the canvas. To organize all of them, click the autolayout icon located in the upper-right corner of the grid.
Validation and Expected Results
- The node appears on the canvas without the Draft badge when fully configured.
- Element names are accepted only if they are unique among elements of the same type.
- The Workflow template can be published once all Draft badges are cleared.
- New executions follow the updated node structure and names, while already running executions continue using the version they were created from.
Common Issues
- Publication is blocked: A workflow template cannot be published while any node retains the Draft badge. Ensure all required configurations are completed to clear the badge.
- Duplicate Name Error: Two nodes of the same type cannot share a name. Provide a unique name for each element.