Skip to main content

Troubleshooting workflow errors

Unable to publish your workflow? The Workflow Designer helps you pinpoint potential issues in your workflow.

Written by Yokoy Team

🌐 Web | 👤 Yokoy admin with Workflow Designer permissions

Only correctly configured workflows can be published. The Workflow Designer flags any errors that may be present in the workflow when you try to publish it so you can troubleshoot and fix the errors.

For example, your workflow may contain critical issues that prevent the workflow from being published as its components are incorrectly configured.

Errors or inconsistencies are highlighted in red in the Workflow Designer workspace.

Hover over a node with an error to display the corresponding error message and get more information on how to fix it.

💡Tip

When you get an error, fix the issues sequentially and publish again to check again if the issue persists. Often, the issues are related, meaning that the first issue causes the other ones. Hence, you should work through the issues step-by-step and save to see if the issue persists.

The Workflow Designer flags these errors:

  • Invalid path: This error requires you to specify an action for the path. If this is shown, check the node flagged by the Workflow Designer and make sure that it has an event specified (e.g. for draft status: either submit, recall, etc.)

    Usually, when you have an error like this, the path affected is also highlighted.

  • Disconnected workflow: This error can appear in different circumstances. In general, the validation algorithm checks the validity of the whole workflow. If it finds that one node cannot be converted into a valid workflow, it flags that path as cannot be used. This causes the rest of the nodes connected to that specific workflow node to be invalid as well. To solve the issue, first fix the errors that may cause this issue and publish again.

  • Activity node error: This error requires you to perform some action on the activity node, i.e. fix some properties or enter missing configuration for the node.

  • Condition node error: This error requires you to perform some action on the condition node, i.e. some properties or enter missing configuration for the node.

  • Missing node exit: This error means that a specific node is lacking an exit path.

  • Duplicate path action: This means that for a certain node you have two identical outgoing actions. For example, for the Draft node, you have two outgoing “Submit” actions. Since the action is duplicated, the Workflow Designer flags the node.

  • Missing start node: This happens because you don‘t have a starting workflow node. If this happens, start building your workflow from scratch using one of the templates.

  • Missing mandatory node exit: This happens because the node lacks an exit path. This typically happens when you forget to specify an outgoing line from a certain condition node.

Did this answer your question?