Element

Icon

Description

Use a Text Area if you want to enable the input of longer texts, for example desciptions or notes. The Text Area is an input field for character strings of all kinds including line breaks. Input is always saved as character string, even if numbers are listed.

TypeString
Prepopulation

This element can be prepopulated.

  • You can set a default value in the Attributes panel to be applied before displaying the form. Refer to Changing BPMN Element Attributes for more information.
  • You can overwrite these defaults dynamically in the Get Data execution of a user task. How to do this is explained on Using Forms.
EditingRefer to  Modeling Forms for further information regarding editing of form elements using the context menu.

Configuration Options

Use the Attributes panel to edit the form element.

AttributeDescriptionAllowed Values
NameTechnical identifier for data processing and not visible for the end user.

Alphanumercial characters and underscore.

It is not allowed to start the name with a number.

DescriptionA commentary field for the developer. The content is invisible to users and its sole purpose is internal documentation.Any string.
LabelField name shown in the form.Any string.
MandatoryThe element must be filled or used if the checkbox is activated.trueElement must be filled.
falseElement may remain empty (default).
Read-only

This field is write-protected. When you use the option, Read-only is added to the bottom right of the element:

trueUser cannot enter values.
falseUser can enter values (default).
Text

In this field, you can enter text. Content added to attribute Text is shown in the element. If the user does not change the content of the field during form execution, the content of Text will be saved to the database.

Any string.
Placeholder

The content of this attribute is displayed in the element when attribute Text has not been filled. The placeholder is a sample value, it is not saved to the database. When a user overwrites the placeholder, it disappears and the user's input is saved to attribute Text.

If content is added to both attributes Text and Placeholder, the content of Text is displayed in the element.

Any string.
Max Length

Use this attribute to limit the number of characters that can be entered in the Text Area .
The default value is 0.

If the value is empty or 0, the length of the text that can be entered in the input field has no limit.

Any integer.
Vertical Alignment

The attribute is used to adjust the position of a form element in context to a bigger neighboring element.

Example: The Radio Button Group Color is much bigger than the Button Next, but the button should be shown at the bottom of the form. Therefore, the button's attribute Vertical Alignment is set to Bottom.

Top

Align the element on top of the element cell (default).

Center

Align the element in the middle of the element cell.

Bottom

Align the element at the bottom of the element cell.

CSS ClassEnables a field-acurate layout customization.A valid CSS class.
Custom Attributes

The attribute is used to activate Angular directives, that are created as development kit (devkit) library to expand the default functionality.

For detailed information about Angular directives, visit the official Angular documentation. For details about the usage of the Custom Attributes, refer to Developing Custom Directives.

  • empty attribute
  • attribute with value (e.g. color="red")
  • multiple entries separated by space (e.g. color="red" multiline max="5")
Symbol TypeDisplays the type of the form element in read-only mode.

_

On this Page:

Simple_Form_Example

Click the icon to download a simple example model that shows how you can configure form elements in Scheer PAS Designer.

Related Pages: