Description

The FieldSet control is used to group multiple form fields together in a labeled collapsible/expandable area. This helps to organise and group the form fields for functional reasons. The screenshot below shows an example of a form with 2 fieldsets:

Untitled

Untitled

The SimpleSwatFieldSet can be used as part of a Forms to structure it.

<aside> <img src="/icons/light-bulb_purple.svg" alt="/icons/light-bulb_purple.svg" width="40px" /> The expand and collapse state of the form fieldset is saved in the user profile. If required to change the default state please expand or collapse the required fieldsets and save the user profile.

</aside>

How to use it

  1. Go to Build > Components > Forms (or directly in your screen via the object designer)
  2. Search for your form object (type SwatForm) and open it.
  3. In the ribbon click on “Design” to open the form designer.
  4. Search for “SimpleSwatFieldSet” in the catalog and drag&drop it to the preview screen. Please note to drop it to a position where the preview screen will be highlighted in green, not in red.
  5. Save.

Now you can change the "label" attribute of the fieldset (the text at the top of a fieldset) and add fields into it. You can also add SwatColumns to a fieldset to arrange the fields.

<aside> <img src="/icons/light-bulb_purple.svg" alt="/icons/light-bulb_purple.svg" width="40px" /> Finding fields you want to add If you want to add existing fields of a SwatBusinessEntity which is used in the parent screen, just filter the object name by using the SwatEntity (you can find the entity-name in the attribute resourceName of the SwatBusinessEntity in the SwatWindow), e.g. “Customer.”. The results are all related SwatDataFields which can be added to the form.

</aside>

Settings/Attributes

Attribute Description Example/Values
collapsed To display a fieldset as collapsed or uncollapsed as default.
Remark: If a user collapse or uncollapse a fieldset in a deployed application, this will be saved in the user profile and the next time, configuration will we take from user profile true/false