System Events trigger

System Events are internal Torq events triggered by changes and operations within your Torq workspace. If a workflow or step fails, a request to share a resource with the workspace is initiated, or a user requests a review of their work, that event will trigger the start of a workflow created with any of the following triggers. You can build specific logic and conditions to limit the trigger scope or create global logic by leaving the trigger as is and running your workflow on every event.

How to use

1. Go to Build > Workflows.
2. Select Create Workflow.
3. Select the System Events trigger.
4. Click Pick scenario.
5. Select from the available triggers:
   • Workflow failure
   • Step failure
   • Request for review
   • Share request created

Workflow failure

Trigger a failure alert system upon any workflow within your workspace failing, or use conditions for a specific workflow to make a failure alert. Use tags, workflow ID, workflow creator, or many other conditions to specify workflows. 

1. Click Create workflow > System events > Workflow failure.
2. If you want global monitoring logic that runs upon any workflow failure, leave the trigger as is and build your workflow using whatever logic best suits you (chatbot notification, nested workflows, etc.) 
3. If you have a more specific use case, click on the trigger and click Add condition.
4. Build the appropriate conditions for your workflow using event context conditions, including:

Step failure

Trigger a workflow upon any step failure within your workspace. If you want to trigger only for certain step failures, you can use conditions to specify a step by using the step name, type, or other conditions, such as the workflow name the step is in.  

1. Click Create workflow > System events > Step failure.
2. If you want global monitoring logic that runs upon any step failure, leave the trigger as is and build your workflow using whatever logic best suits you (chatbot notification, nested workflows, etc.) 
3. If you have a more specific use case, click on the trigger and click Add condition. 
4. Build the appropriate conditions for your workflow using event context conditions, including:

Request for review

Trigger a workflow upon a user requesting a review of a created or changed workflow. The workflow will be triggered upon any request for review within your workspace, or you can specify workflows or users by using conditions. 

1. Click Create workflow > System events > Request for review.
2. If you want global monitoring logic that runs upon any review request, leave the trigger as is and build your workflow using whatever logic best suits you (chatbot notification, nested workflows, etc.) 
3. If you have a more specific use case, click on the trigger and click Add condition.
4. Build the appropriate conditions for your workflow using event context conditions, including:

Share request created

Trigger a workflow upon a request to share a resource with the workspace. You can use trigger conditions to filter specific trigger events.

1. Click Create workflow > System events > Share request created.
2. To add a trigger condition, click the trigger and then click Add condition.
3. Use the event context to extract information about the trigger event:

The example below shows a workflow triggered by the Share requested created internal scenario. When a request to share a resource with the workspace is received, it can be sent to an admin Slack channel where the channel members can select to accept or deny it.