In Torq, workflow step names play a critical role in ensuring seamless and efficient automation. This article will guide you through the process of renaming workflow steps and managing references, making it easier for you to maintain clarity and functionality in your workflows.
Why Step Names Matter
Unique Identifier: Each step name serves as a unique identifier within the workflow designer.
Reference Access: It enables you to access and reference the step elsewhere in the workflow using JSON expressions (e.g.,
{{ $.<step_name>.results }}).
When you change a step's name, Torq automatically updates all references to maintain consistency across your workflow unless the name is not unique (see below).
Handling Duplicate Step Names
If you have multiple steps with the same name and need to rename one, you must decide whether to update the references to the new name or keep the existing ones intact.
For example, consider a workflow with two steps named RF Result. Depending on the conditions, only one of these steps will be executed.
Here’s how you can manage this situation:
Rename and Update All References
Rename the step.
Confirm the list of steps that reference the renamed step.
Ensure the Update all references checkbox is checked.
Torq will automatically update all references to use the new step name.
Result: Only the step with the new name is now referenced, while the other steps with the original name are not referenced anywhere.
Rename Without Updating References
Rename the step.
Uncheck the Update all references checkbox.
References to the step with the original name remain unchanged.
Result: The renamed step is not referenced anywhere, while the steps with the original name continue to be referenced.
Manually update references if needed.