Input Parameters
Use input parameters in on-demand workflows to allow dynamic and flexible automation.
On-demand workflows can use user-input parameters to allow dynamic use of relevant values during execution. By defining these parameters, users can tailor workflows to specific needs without altering the workflow logic. Input parameters in on-demand workflows are always provided at runtime, enabling flexible and adaptable execution for various scenarios.
Input Parameter Configuration Options
By using input parameters, workflows can be more flexible and adaptable to different scenarios without requiring changes to the workflow logic itself.
Input parameters can be configured to provide flexibility in workflow execution. They can be:
| Input Control Type | Description |
|---|---|
| Mandatory or optional | Some parameters require input before execution, while others can be left empty. |
| Flexible Input Fields | Builders can configure different kinds of lists including a controlled set of options from which the users can choose when triggering the workflow, enable free text, use checkboxes and configure other input types as well. |
| Static or dynamic | Static inputs remain fixed, whereas dynamic inputs retrieve values from global variables. |
When defining an on-demand workflow, you can choose from the following input parameter types:
| Parameter Type | Behavior when the user triggers the workflow | Example |
|---|---|---|
| Text | Single-line text input for short entries | A user name |
| Long Text | Multi-line text field for detailed input | A description or detailed explanation |
| Number | Numeric value input | 100 |
| Single-Select | Choose one value from a the list; if enabled, users can alternatively add free text. | Choose one from the following: - Apple - Orange - Banana |
| Multi-Select | Choose multiple values from the list; if enabled, users can alternatively add free text. | Choose all that apply: - Apple - Orange - Banana |
| Checkbox | True/False input | |
| Date and Time | Pick a specific date/time or relative value | |
| Connection | Select a configured connection | From the list of available connections. |
| File | Upload a file (Max: 500MB) | For example, a PDF |
| List | Provide multiple string values | A list of values. For example, a list of names: Biff, Martin, Lorraine |
The file input parameter is not supported in triggered subflows.
Configure Input Parameters
-
Navigate to the on-demand workflow that you would like to update with input parameters.
-
From TRIGGER: ON-DEMAND, click +.
-
Configure each input parameter by setting:
Field Description Parameter Name Unique identifier for the parameter Parameter Type Choose the relevant type Display Name User-friendly name (optional) - this is the way the field will appear in the form for the user. Required Toggle on/off to enforce input or leave it as optional. Placeholder (Available for relevant types) Sample text shown in the input field (optional). For example, if a User Name is the required input, you can enter an example of the expected format in the placeholder. Valid and Default Values (Available for relevant types) Configure the values that are allowed for the parameter. The default value is the pre-populated value (optional). For example, if the input is a date, you can configure the date in advance for the default value. Options List Mode (Available for relevant types) Static (values that you manually add when building the workflow) or Dynamic (fetched from a source) -
Click Add to save the parameter.
The parameter appears in the TRIGGER section. When the flow runs, the value wwwill be retrieved in real time.
Now, you can test your trigger to view the input form and to watch how the input is leveraged in the rest of the workflow.
Related Articles
Was this page helpful?