The App Action trigger is intended to be called from the UI of your Budibase application.
Fire and forget
Automations run asynchronously on a background thread, therefore once an automation is triggered from the client, there will be no returned response by default.
To receive a response you can make use of Synchronous automations 🔒.
To use the App Action trigger, you will need to create an automation with the App Action defined as trigger. Head over to the Automation section, create a new automation, and select
App Action as the trigger you want to start your automation with.
Once you've entered the name and picked
App Action you can click
Save and your automation is created.
You now can define fields that you want to have applied to the automation. This enters data into your automation which you can use in future steps.
Right now, 5 different types of fields are supported: Text, Number, DateTime, Boolean and Array. Add as many as you will want to have inside your automation.
You can use these fields in the next steps, check the Working with data in automations guide to learn how.
Now that you have defined fields to be used in your automation, you can call this automation from the UI and populate the fields you just defined.
First, add a button to your application in the Design Section of Budibase. Then, head over to the
Define Actions button in the Settings Panel.
A modal will open where you can define Actions. Create a new action by clicking the
Add Action button, and then choose
Trigger Automation from the options.
Then you'll want to use the automation you've already created, so select
Use an existing automation and then from the dropdown pick the one you created.
Next we're going to be adding the fields we've defined in our automation. When you click the
Add Field button as displayed in the image above, you can pick from all the fields you've already defined.
Whatever you choose for bindings, you will receive the result back in your automation, which you can then use in next steps.
This subject touches upon working with data in automations, but I wanted to highlight the specific data that comes in with this trigger.
One popular thing to do with an
App Action trigger is to create one, or multiple, rows in the database. You could use this action to populate multiple tables, or even Data Sources at once.
Let's take a look at the
Create Row action. Select the table you want to create a row in, and then use Bindings to use the
trigger.fields. object to populate the data you want.
As you can see we're using the same names of fields we've defined in the first step.
And if you want, at this stage, you could create another
Create Row, or other of course, action to create a row in another table, or somewhere else entirely. This could also be a good moment to duplicate data to MongoDB or Airtable for example.
Updated 2 days ago