Filled

The Behaviour type Filled evaluates a form element to be checked to determine whether it is considered 'filled' or 'not filled' in its current state.

images/download/attachments/189431853/image-2024-9-30_8-52-14-version-1-modificationdate-1727679133200-api-v2.png

The form element to be checked is determined depending on the existence of an element link as follows:

  • If no element is linked, the executing element is checked.

  • If an element is linked, this element is checked.

If the type of the form element to be checked supports the check for filled, then the Actions on 'true' are executed if the element is considered filled. Otherwise, the Actions on 'false' are executed.

If the type of the form element to be checked is unsuitable, an error message ('No validator found [...]') also appears in the browser's developer console.

Regardless of the progress of the check, any input data ($input) is transferred unchanged to the actions.

NOTE◄ If the Filled behaviour is configured, e.g. for a Button (with the triggering event Click), to check a linked element, the value of $input is always true, because the linked element is checked, but its value is not accepted as input data.

Notes on checking selected form elements

Form element

Check possible

Notes

Check box

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

  • Filled only returns 'true' if the value is 'true' (check mark set).

  • Empty and 'false' (no check mark) are considered 'not filled', but can be differentiated by $input if necessary.

Text field

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

The value in a Text field is trimmed before checking, so that the text field is not considered Filled if it contains only whitespace characters (spaces, line breaks, etc.).

Date range

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

A Date range is only considered Filled if both date components ('From', 'To') are filled. Depending on the details when editing date components interactively, this can sometimes lead to unexpected results. If required, the components can be checked individually by Filled and linked e.g. via a Logical condition.

List elements

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

The different list elements can generally be checked. Depending on the type, the check refers to the contained list or the selection made on its basis:

NOTE◄ Even if the key value of a selection (such as in a Combobox element with static values) corresponds to an 'empty' text value (whitespace or empty string), the element with that selection is considered Filled.

Repeatable element

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/check.svg

A Repeatable element is considered Filled if at least one entry (an instance of the repeating element) exists.

Optional elements

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg

An Optional elements container does not support a check for Filled.

Elements without interactive access
(without any claim to completeness)

images/s/-95e2zf/9012/8yg2g7/_/images/icons/emoticons/error.svg