Low-Code Designer > Apps > App Builder / App Item Forms

App Item Forms

A form is a set of fields for entering, displaying, and editing data. When we configure a form, we specify how the page of an item looks: what data it displays, what information users have to enter, which fields can or cannot be edited.

You can configure forms when adding a new app and when editing an existing one. A configured form is used for creating, viewing, and editing an app item.

Here is what an app item creation page may look like:

AIF 1

Forms have such fields as name, contact person, phone number, etc. In addition, tables, lists, and radio buttons can be added to the form that allow the user to select one or more items.

Configuring form fields

начало внимание

Only the users included in the Administrators group can configure forms.

конец внимание

You can add any number of fields to a form, arrange them, and define their parameters.

There are two ways to open form fields settings:

1. In the left menu of a workspace, click app gear icon next to an app name and select Form Settings.

AIF 2

2. On an app page, click on the name of any app item. In the opened window, click Form Settings.

aif 3

The Form Settings window will open. It contains two areas: on the left is the app item form, on the right is the properties pane. You can find more information about all the property types in this article.

Each property on the form is a field on the page. Drag and drop properties from the side panel to add the fields you need.

aif 4

You can also drag and drop the fields on the form to rearrange them.

After adding fields, you can start configuring them.

Fields are displayed collapsed in the left part of the window. Click on a field to expand it and define its parameters.

AIF 5

You can edit:

aif 6

The property name that will be displayed on the forms for creating, viewing, and editing an app item.

aif 7

Property code used when working with API.

aif 8

Additional information, which clarifies how to fill in the field on an app item form. E.g. "Enter a mobile phone number as +1 5ХХ ХХХ ХХ ХХ".

aif 9

If you select this option, this field will be used as a parameter in app item search.

aif 10

Each property has a set of parameters. For instance, for a Phone number property, you can specify its type - home, work, mobile, etc. For a Money property, you can select a currency, e.g. USD. To learn more about properties and their settings, read this article.

If a field on a creation or editing form must be a required one, click required greynext to the field's name.

Required fields are marked with requiredon the form. If a required field is not filled in, the user will see a warning.

aif 11

To delete a field click trash.

aif 12

After configuring the form, click Save.

aif 13

If you want to set up different pages for creating, viewing, and editing, switch to the Advanced Mode.