For the complete documentation index, see llms.txt. This page is also available as Markdown.

Form Components

Form components are generally associated with an attribute or field of the data source, with the exception of Label and Attachments components, which are not directly linked to data.

The following sections describe:

  • The different types of available components.

  • The parameters for each component type.

  • The component management features within a form.

Component Types

JMap Cloud Portal offers several component types to adapt forms to various functional and visual needs.

Label

Static text displayed as-is in the form.

Text

Input field for an alphanumeric value.

The associated attribute/field must be of type Text.

Number

Input field for a numeric value.

The associated attribute/field must be of type Number.

Boolean

Used to populate the associated attribute/field for which only 2 possible values exist, corresponding to the checked and unchecked states of the component.

The associated attribute/field can be of type Text or Number.

Date

Allows the user to select a date.

The associated attribute/field must be of type Date or DateTime.

List

A list of values from which, depending on the configured parameter, either a single value (single choice) or multiple values (multiple choice) can be selected.

The associated attribute/field must be of type Text or Number and must have a value domain that determines the possible values the attribute/field can take.

Attachment

Allows a JMap NG application user to attach one or more files to a feature or record in the data source. See the Data Source Attachments section for details.

Only one Attachment component can be added to a form.

The data source must have a linking attribute/field selected, and it must be unique and non-null.

Note: If the linking attribute/field is modified after attachments have been added, the attachments are detached from the features/records but are not deleted.

Table

Allows a JMap NG application user to create and edit data from a table associated with a feature or record in the data source.

A relationship must be configured between the data source and the table. If the table data is editable, you must configure a form for the table.

Example: A point layer represents air quality monitoring stations. A table contains the pollutant measurements taken at each station on different dates. For each monitoring station, there can be 0, 1, or multiple measurements.

In the attribute form for the monitoring station layer, the Table component displays a table containing pollutant concentration data at different dates. Each row corresponds to a measurement of a pollutant on a given date.

Component Parameters

Each component type has specific parameters that control its behavior and appearance (e.g., default text, format, style, constraints, etc.).

Attribute

Select the layer attribute or table field to which the component is associated. This is the attribute or field that the form component will populate.

Title

Assign a title to the component.

Text

Attachment and Label components.

Text of the label or of the form section that contains the attachments.

Define linking attribute

Attachment component.

If not already done, click the button to open the data source configuration interface and define the linking attribute. If the linking attribute is already defined, this parameter is not displayed.

This attribute is used to associate attachments with features or records in the data source. It must be unique and non-null.

Note: If the linking attribute is modified after attachments have been added, the attachments are detached from the features/records but are not deleted.

Default value

Enter or select a default value to initialize the input field.

This option should be used for a component that has a default value.

Choice

List component.

Select the list type: single choice or multiple choice.

Display

Select the display type of the component in the form.

Text: Single line or Multiple lines.

List: Radio button or Selection.

Boolean: Checkbox or Toggle.

Number: Input field or Slider.

Value domain

List component.

This section allows you to view the attribute's value domain.

If you want to modify the values, click Show value domain to open the data source Attributes tab interface. You can then edit the values.

If the attribute has no value domain, a Create value domain button appears; clicking it opens the data source Attributes tab interface where you can create the value domain.

Minimum

Number component.

Enter the minimum value for the attribute.

Maximum

Number component.

Enter the maximum value for the attribute.

Checked value

Boolean component.

Specify the value to record when the checkbox is checked or the toggle is enabled.

Unchecked value

Boolean component.

Specify the value to record when the checkbox is unchecked or the toggle is disabled.

Status / Required

Determines whether the field is required.

The user will not be able to submit the form until all required fields are filled in.

Required fields are identified by an asterisk (*) in the form designer.

Status / Read only

Enable this option to set the component to read-only mode.

The user will not be able to modify the content.

Relationship

Table component.

Select the relationship used to link the table to the data source. The relationship must be defined beforehand.

Visible attributes

Table component.

Select the table attributes that will be visible in the form. If the table is editable, you must configure a form for the table to edit these attributes.

Sort by

Table component.

Select the attribute used to sort table records in the form.

Working with Components

Adding a Component

To add a component to a form, drag it from the palette and drop it into the Design tab interface. Components can be inserted into containers for layout purposes.

By default, components are stacked vertically in the form.

Configuring a Component

To configure a component already placed in the form, click it in the Design tab. The editable parameters are displayed in the Properties section.

The spatial arrangement of components can be adjusted using the layout tools, described in the following section.

Removing a Component

To remove a component, click it in the Design tab, then click .