On-demand trigger

A Workflow with an on-demand trigger can be run by users directly from the designer, from other platforms, such as Slack, or triggered as a web form. It can also be used as a nested workflow that is executed during the execution of the parent workflow. You can add parameters to the trigger to customize the trigger event.

How to use

1. Select the on-demand trigger when creating a new workflow or click the replace icon above an existing trigger to change it to an on-demand trigger.
   
2. Add trigger parameters. These parameters will be presented as a form when the workflow is run. Each field contains:
   • Type: the parameter data type (text, JSON, number, file, boolean, single-select, multi-select). The default is text.
   • Name: the parameter name as it's presented in the form.
   • Description: (optional) the parameter description as it's presented in the form.
   • Default value: (optional) add a default value for the parameter.
   • Required: set the parameter to be required or optional. The default is required.
     File trigger parameter

     You can upload a file that can be accessed during the workflow execution by using the file trigger parameter. The file link in the event trigger will be non-shareable, meaning you'll have to use the file inline function to access the file content in Torq steps: {{file $.event.<file parameter name>}}
3. Add steps to the workflow and run it by clicking Test Run. You can also run the workflow from other platforms, for example, Slack.
   
4. Provide values for the trigger parameters.
   
5. Use the trigger event data in workflow steps: $.event.<parameter_name>

Trigger as a web form

You can copy the form URL to enable users to trigger the workflow outside Torq.

1. Publish the workflow.
2. Click Trigger As Web Form.
   
3. Embed the link so users can click it to trigger the workflow (service tickets, text messages).
4. The user who triggers the workflow has to specify values for the required trigger parameters.

Resend a trigger event

Resend the trigger event at any time by going to the trigger Event Log tab and selecting the resend button. You can change any of the trigger parameter values when resending an event.