Form block

Form blocks combine all the necessary components to build a comprehensive and flexible form.

There are three key types.

Type	Fields	Save button
Create	Provides blank fields to be filled out.	Creates a new row.
Update	Provides pre-populated fields based on the record that matches the row ID.	Updates the existing record.
View	Provides pre-populated read-only fields based on the provided row ID.	N/A

Next you can select a table which will provide the Datasource and Schema. This supports both the Budibase internal table, as well as the core SQL databases.

If you want to use a custom schema then you will need to Eject the block.

Row ID

When selecting Update or View type, you will need to provide a row ID so that the form block knows which row data to populate the fields with.

If left blank, it will assume to look for the _id field.

Fields

After you pick a table schema, you will be able to select fields to show from a multi-select dropdown.

The order in which you select the fields will determine the order they appear within the form.

Buttons

Depending on the selected type, you will have the option to show or hide the form action buttons. For example, Update type will have the following options:

If you do not want to perform navigation after the button presses, simply clear the navigation field.

Ejecting

A form block can be ejected to expose it's constituent parts. When a Create type form is ejected, it will appear similar to the following:

The Update type is similar, but will also include the Data provider and Repeater necessary to provide the row detail.