The Streamline workflow canvas shows you the errors in your workflow draft in one place, so you can fix them before you run a session or publish. Each error is explained in plain language and links to the step that needs attention. Blocking errors stop you from running a session or publishing until you fix them. Warnings are flagged for your review but don't block you. This article shows you how to find the errors in your workflow, fix them, and then test and publish.
Key Capabilities
- Error count in the builder - A button at the top of the builder always shows the error count for the workflow.
- One list of errors - Select the button to open the Resolve errors panel. It lists errors from across the workflow, grouped by step.
- Go to the step - Select Open step to jump to the step that needs attention.
- Step markers - A step with a blocking error has a red outline and a red icon on the canvas. A step with a warning has an orange icon. Inside the step, an error count appears at the top.
- Drafts always save - Errors never stop you from saving your work in progress.
- Blocking errors - You can't run sessions or publish until blocking errors are fixed.
Select the count at the top of the builder to open the panel, which separates blocking errors from warnings. Blocking errors show a red blocking count and a red icon. Warnings show an orange warning count and an orange icon.
Review findings in the builder
- Open your workflow in the builder.
- If the workflow has errors, a red button appears at the top of the builder, next to the version selector, Run session, and Publish. Select it.
- The Resolve errors panel opens. It explains that you can't run sessions or publish until blocking errors are fixed. Under Steps, you see the number of blocking errors.
- Review the list. Each step with errors has its own card, and each error is listed under the step in plain language.
Note: Workflows save automatically, so the list updates on its own. You don't need to refresh it.
Fix a finding
- In the Resolve errors panel, find the step card and select Open step. You can also select the step with the red outline on the canvas.
- The step opens. The error count appears at the top right of the step
- Complete or correct the setting that each error describes.
- Close the step.
- Confirm the error no longer appears in the count at the top of the builder.
Tip: Fix blocking errors first. You can't run sessions or publish until they are fixed.
The error count updates after you close the step.
Common causes
- An email notification has no recipients, an empty subject, or an empty message (shown in the screenshots).
- A field is removed from a step, and a later step still uses it in a mapping.
- A mapping uses a field from a step that runs after it or on a different branch.
- A step is missing a required setup such as form fields or a document in the documents step
Test and publish a workflow
Start a test session
You can't run a session while blocking errors are open. Run session is grayed out. Point to it to see the message "Resolve all blocking errors before running sessions." Fix the errors, then select Run session.
Warnings don't block you from running a session or publishing.
Publish
You can't publish while blocking errors are open. You can still open the Publish menu, which allow you to edit the version name, Session name, and Version details. The Publish workflow button is grayed out. Point to it to see the message "Resolve all blocking errors before publishing." Fix every blocking error, then select Publish workflow.
If only warnings are open, you aren't asked to confirm before publishing.
Comments
0 comments
Please sign in to leave a comment.