Scenario inputs
The inputs feature allows everyone to run complex by just filling in the required inputs.
ļ»æ inputs allow you to pass data with a predefined structure to a every time you run it. First, you define the expected data structure. Then, whenever you run the , shows a form where you enter the data. The data from your input is then made available to all modules in the .
Imagine a new employee is about to start working in your company. You may need to create new accounts for your new employee in several different systems (e.g. JIRA, Slack, Email, Miro, etc). To create these accounts, you need the new employeeās name, email, employee ID, and maybe some other personal information. Without this data, you cannot proceed with the account creation. Once you have all the necessary information, you can start setting up the accounts for the new employee.
To automate this action, you can set up a that will create new accounts for your new employee in all the different systems you need. Use the inputs feature to define the input structure as the starting point of your . You can use the name, email, and employee ID as your inputs. Once you enter and save the employee information to the , the runs and sets up all the accounts. The cannot proceed unless it has all the data you define as required.
Some other cases in which you might use inputs:
- Syncing information about a new customer in multiple systems
- Adding offline leads to the CRM, email lists, and creating a proposal
- Creating a new record/invoice/email/order by providing a set of inputs
You can define inputs before or after adding our modules.
In the editor, click the inputs icon.
Click Add item.
Enter a value in the Name field. This field is mandatory.
You can't use spaces or special characters in the name. You can use letters, numbers, and the underscore symbol. You can only start with a letter or underscore.
In the Specification field, select the inupt date type from the dropdown menu.
Optional: In the Default field, enter the default value you expect to get.
Under Required, select whether this input is required or not to start your .
If you have required inputs, your scheduling type must be On demand. For more information, see the scheduling a scenarioļ»æ article.
Under Multi-line, select how you want your text to be displayed if you selected Text, Array, or Collection as your Specification.
Selecting Yes shows multiple lines of text. Selecting No shows only one line of text.
Repeat the process if you need to add more items.
Click Save in the Scenario inputs box.
Click the Save icon to save your scenario.
ļ»æ
You can use the inputs as mappable values in your . You can find them under the Variables tab in the mapping dialog.
Once you define your inputs, they appear as mappable values under the Variables tab in the mapping dialog.
With defined inputs, every time you trigger a (via Run Once or via API), the inputs window pops up.
The can run only if you fill in all the required fields with the correct data types.
Navigate to the inputs icon in the editor.
Click on the item you want to edit.
Make your changes.
Changing the input name will cause the to fail. If you need to change the input name, we recommend deleting the old item and adding a new one with the new name.
If you change the inputs from not required to required, you need to change your scheduling to On-demand.
Click Save.
Once you save your changes, the changes update automatically everywhere you use the specific input mappable value.
Editing the input structure item(s) in an active might lead to dataĀ inconsistencies and failure.
Navigate to the inputs icon in the editor.
Find the item you want to delete.
Click X to delete the item.
Click Save.
Deleting the input structure item(s) in an active might lead to dataĀ inconsistencies and failure.
The Make API allows you to define inputs programmatically, as well as use the API to pass input values to a and run it.
In the API, the definition of inputs is called scenario interface.
You can also use the Run a scenario module of the Make app.
The following endpoints are available:
ļ»æ