Edit field

The "Input field" application element is one of the basic controls. The input length is limited to 255 characters. In the image above you can see the "Title" input field, in which a title can be entered. This input can be saved with a corresponding button, provided that a data field is linked to the input field.

Input fields can be configured for different data types. A variety of control types are available.

The input field element can be found in the "Applications" module in the "Elements" area. A new input field can be created by positioning the element on the workspace from here using drag & drop.

Further information on creating elements can be found here.

The properties dialog of an input field element opens automatically when a new input field is created. The properties dialog of an existing input field can be opened by double-clicking on the element on the workspace, via the "Properties" context menu or via the "Edit / Properties" main menu if the input field is selected on the workspace.

General

The following settings can be found on the "General" tab in the properties dialog for input fields:

Title

Provide the edit field with a title. Information on multilingual titles can be found here.

Display title in control

With this setting an edit field will be made a mandatory field.

Input required

This setting makes the edit field into a mandatory field.

Write-protected

With this setting, it is no longer possible to enter data in this field.

Open numeric pad when edit field is clicked

This setting is available for input fields with the control type "Integer", "Floating point number" or "Currency" on pages that are transformed for mobile devices. This shows a numeric keypad on the mobile device that can be used to select and enter numbers into the field.

On the "Options" tab, you will find different settings for the various control types in the input field.

Options - "Text" control type

Maximum number of characters available

In this field, you can define the maximum amount of characters that may be entered. If no value is entered, a maximum of 255 characters are permitted. If the number of characters is exceeded, a message is displayed during input.

Regular expression to restrict the characters

You can enter a regular expression that defines which characters may be entered. Other characters will not be accepted. The following regular expressions are possible:

  1. [a-z]

    exactly one lower case letter from a-z

  2. [a-z]*

    0 to infinite letter from a-z

  3. [0-9]

    exactly one number between 0 and 9

  4. [a-zA-Z0-9_]

    exactly one character of the set: letters (upper and lower case), digits and the underscore

  5. [abc]

    a,b or c

  6. [^abc]

    not a,b or c

Characters that must be escaped with backslash:
(){}[]\|/+?*.^&-<>^=$!

Options - "E-mail" control type

Maximum number of characters available

In this field, you can define the maximum amount of characters that may be entered. If no value is entered, a maximum of 255 characters are permitted. If the number of characters is exceeded, a message is displayed during input.

Email address validation

This setting will check whether the email address contains an @ character and a domain.

Options - "URL" and "Telephone" control type

Maximum number of characters available

In this field, you can define the maximum amount of characters that may be entered. If no value is entered, a maximum of 255 characters are permitted. If the number of characters is exceeded, a message is displayed during input.

Control type "Color"

There are no optional settings for input elements with the "Color" control type. Clicking in the input field opens a palette in the browser from which the desired color can be selected.

Options - "Integer" control type

Minimum value / maximum value

Here you define the value that must not be undercut or exceeded during input. The value will be checked before the page is saved. If values are not permitted, a corresponding message is displayed.

Thousands separator

This can be displayed as a point or a comma. If you select the "Portal setting" entry, the separator is output according to the setting of the number format in the country settings of the portal for the respective language.

Options - "Floating point number" and "Currency" control types

Minimum value / maximum value

Here you define the value that must not be undercut or exceeded during input. The value will be checked before the page is saved. If values are not permitted, a corresponding message is displayed.

Separator character

Use company settings

With this setting, the separator is used according to the setting of the number format in the country settings of the portal for the respective language. If you want to set the 1000 separator and decimal separator differently from the portal settings, deactivate this setting so that the "1000 separator" and "Decimal separator" settings are activated.

Thousands separator

Select the desired separator.

Decimal separator

Select the desired decimal separator.

The 1000s separator and decimal separator must be different.

Decimal place

Use company settings

With this setting, the decimal point is used according to the setting of the number format in the country settings of the portal for the respective language. If you want to set the decimal place differently from the portal settings, deactivate this setting so that the settings "Leading zero" and "Decimal places" are activated.

Leading zero

Defines the format for the display of zeroes in front of the number (i.e. 0.7 or .7).

Decimal places

Enter an integer that defines how many decimal places should be displayed.

Options - "Date", "Time", "Date & time" control types

Minimum value / maximum value

Here you define the value that must not be undercut or exceeded during input. The value will be checked before the page is saved. If values are not permitted, a corresponding message is displayed.

Date format

The format for the displayed date is defined here. Here,

  • dd

    is the two-digit display of the day

  • MM

    is the two-digit display of the month

  • yyyy

    is the four-digit display of the year

If you select "Portal setting", the format from the country settings of the portal is used for the respective language.

Time format

The format for the displayed time is defined here. Here,

  • HH

    is the two-digit display of the hours

  • mm

    is the two-digit display of the minutes

  • ss

    is the two-digit display of the seconds

If you select "Portal setting", the format from the country settings of the portal is used for the respective language.

Calendar settings

All information about these settings can be found here.

Binding

The display values of the element can be defined on this tab in the properties dialog. All information about these settings can be found here.