- 23 May 2023
- 2 Minutes to read
- DarkLight
Workflows
- Updated on 23 May 2023
- 2 Minutes to read
- DarkLight
Workflows are the logic you build to automate your security posture or upkeep practices and actions, for example, employee onboarding or compliance. A workflow consists of a trigger and a series of steps that accomplish an automation use case. Workflows can be as long and complex or simple and everything in between. Scheduled, triggered on demand, or triggered upon specific parameters from a vendor or other integration or webhook.
Workflow statuses
The workflow status represents the status of the current or most recent workflow run. To view workflow statuses, go to the Activity Log page.
Status | Description |
---|---|
![]() | The workflow execution was completed successfully. |
![]() | A step failed, causing the workflow to fail. Hover over the information icon to see the name of the step that failed. View the run log to get more information about the failed step. |
![]() | The workflow is currently running. |
![]() | The workflow was manually stopped. |
![]() | There are a few reasons a workflow might be on hold:
|
![]() | The maximum number of concurrent workflow runs (workflows in Running status) was reached. The queued workflow will be executed |
![]() | A workflow that was queued for 24 hours will be dropped. |
Workflow states
Workflow creation is an iterative process, which we call the workflow lifecycle. It includes planning, designing, building, testing, publishing, and editing.
A unique feature of Torq's workflow lifecycle is that you can actively edit a workflow while the published version runs in production.
State name | UI | Description |
---|---|---|
Unpublished | ![]() | Workflow draft. In this state, you can make changes to the workflow, steps, perform test runs, and more. |
Published and trigger enabled | ![]() | View-only. The workflow runs in production automatically when the trigger conditions are met. |
Published and trigger disabled | ![]() | View-only. The workflow is in production but will not run automatically because the trigger is disabled. You can run the workflow manually. |
Published and draft exists | ![]() | The workflow runs in production automatically when the trigger conditions are met and there is an active draft that you can edit. |
Nested workflows
Nested workflows are a good way to perform a common action or set of actions that you want to use in multiple workflows. This is helpful when workflows that achieve different purposes require the same logic at stages. Nested workflows also allow for easy content reuse, so you only need to maintain and update a single workflow for multiple goals. If you're ready to start, learn how to create a nested workflow.