Components

Components are graphical widgets used to build a form. A graphical widget is an interactive UI element, such as a calendar field, text field, or checkbox, that allows users to interact with and manipulate data.

They are divided into three families:

  • Organizers, which organize the form layout using groups and structures, ensuring that the components contained within it are arranged according to a logical spatial or control hierarchy structure. They are the Container, Tab, Carousel and Collapse.

  • Visualizers, which have a graphical function, giving additional information to the users and guiding them interacting with the mask/task forms. They are the Label, Table and Plot.

  • Controllers, which allow inserting inputs linked to a specific option, allowing user interaction to modify one or more values. They include, among the others, the Checkbox, the Combobox, the text, number, password and calendar fields, the attribute controllers, the source controls and the Code field.

Each component family is divided into sub-families, which are listed and explained in the corresponding pages.

Some components are available only in task forms, since they rely on data and structures which are specific to tasks. This is specified in the corresponding component family page, next to the name of the component.

Editing a component

To start building a form, drag a component onto the stage: an Edit window opens automatically, whose options and properties vary according to the component type.

The Edit window always contains the Layout section, which changes how the component is displayed in the form, for example its order, its dimensions, its label and its CSS. The components which need a data or behavior configuration, such as the controllers and the Table visualizer, also contain the Option section, where the component is linked to an option and its values are configured. The Plot visualizer has a specialized window, instead of a separate Option section.

Some fields are available only if other fields have been selected: for example, a text field shows the number of lines only if its Multiline field has been selected, and the fields of a table change according to the selected table type. Moreover, in task forms the structures used by the components can be selected among the available ones, while in the other types of form their name is typed directly. If a field is disabled, select or configure first the data which it needs in the task or in the form.

A detailed description of the available options is provided in the corresponding component family page.

This window can be opened at any time through the component context menu, whose characteristics are explained below.

The Components context menu

The components’ context menu can be opened by right-clicking on the component onto the stage.

The following options are available:

  • Open component layout: it opens the component’s layout menu. Its options vary according to the chosen component, which are explained in the corresponding component’s family page.

  • Rename: it renames the component. The new name will be visible in the Graphics tab.

  • Copy: it copies the selected component(s).

  • Paste: it pastes the selected component(s). Available only if at least one component has been copied.

  • Delete: it deletes the selected component(s).

  • Create connection: it allows creating a new connection, which will be visible and editable in the Connections tab. Type the connection name in the Connection Name field and click ADD. The selected controller will be the Origin of the connection. Then, configure the connection as explained in the Connections page.

  • Set connection: it allows setting up a connection on the selected component. By clicking on it the Select a connection window opens, where users can choose from the Connections drop-down list the connection (which has been previously set, and it is available in the Connections tab) they want to add to the chosen component. The selected component will be the destination of the connection.