Getting Started
Datasources
Spaces
Functions
Components
Super Records
Tasks
Permissions
Settings
Advanced

Form Component

Forms provide a way for users to input data and then perform an action using that data (through functions like adding, updating or deleting a record). They can be set up to utilize data coming from other components, like table components and filter components. 

Form Configuration

Actions

Type: Select the data source that you want this form to work with, and then choose the type of action, aka function, that you want to perform. 

  • For most databases, you’ll see auto-generated insert, update, and delete functions (only if the database credentials used to connect have these permissions)
  • For business apps, you’ll see auto-generated functions based on available APIs
  • If you created a custom function for a database, you’ll see those functions here
  • If you created a custom function for HTTP services (API/GraphQL), you’ll see those functions here as well 


Form Name: This name will be shown at the top of your form.


Button Text: This will be displayed on the button used to submit this form. 


Instructions: This optional section allows you to display any instructions you want users to see when using the form. 


After Submitting: You can choose to refresh a table component here when you submit this form (allowing you to view updated values). “Add another action” allows you to refresh multiple components upon submission. 


Fields

This section allows you to configure the fields in your form and choose how those fields are populated. You can drag and drop a field to rearrange the ordering or remove a field from this form by clicking on the trash icon.


For auto-generated functions, the fields shown will be the fields (columns) in the resource your function acts on. For custom functions, the fields shown will be the dynamic parameters you defined when creating the function.


Form Fields

These fields will be displayed to users. Clicking “Edit” will allow you to configure this field - click to learn about field configuration options. Click “+ Add Data” to add more fields (only the primary field key is added by default). 


Hidden Fields

These fields will not be displayed to users of your form, but data will still be submitted. Use hidden fields for any fields that do not require manual user input where you still want to pass on data. 


Click “+ Add Data” to add hidden fields (note that you must have fields available to add). Hidden fields must have a value specified, as the user will not be able to enter in a value. Click on “Edit” for field configuration options.