Trigger a workflow with a file

When using an on-demand trigger, you can create a File field, which accepts files for input. Any file you upload will be accessible only in Torq steps by using a non-shareable link that will be available in the trigger event. The user executing the workflow will be required to upload a file when running the workflow from Torq or when using the trigger form URL. You can also easily trigger a nested workflow using a file.

How to use

1. Create a new workflow with an On-Demand trigger or use one that already exists.
2. Add a trigger input parameter.
3. Select the File type and give the parameter a name. Specify whether the file is required or optional.
4. Add at least one step to your workflow and click Test Run.
5. Upload a file to use during the workflow execution.
6. The file link is available in the trigger event. The link is non-shareable and can only be used in Torq steps.
7. Use the file in the workflow steps. The file link is available at {{ $.event.<file parameter name> }}. To get the file content, use: {{ file $.event.<file parameter name> }}. The file inline function is required when accessing the file content since the link is non-shareable.

Trigger a nested workflow with a file

You can pass a file URL to a nested workflow that has a file type trigger parameter. The nested workflow can also return a file URL as an output.

 IMPORTANT

Only non-shareable links that have the format tqfile://steps/XXXXXXXXX can be passed as trigger parameters.