Form properties

The form properties were the default way of configuring a user task in the deprecated Flowable Eclipse Designer. For backwards compatibility, the Workflow Designer supports all form properties but you should use form references to design your user tasks and take advantage of the enhanced configuration options that they offer.

The behavior of a form property is determined by the Readable parameter.

Readable	Behavior
Clear (recommended)	Creates a configuration variable that you can later edit on the workflow definition page in Collibra.
Selected (not recommended)	Creates an individual input element that is part of a dialog box presented to the initiator before the start of the workflow.

Form property parameters

The form property parameters determine the value and class of the stored value for configuration variables. If used in a start form or user task (not recommended), it also determines the type of input that appears in the dialog box or task sidebar.

Parameter	Description
Id (required)	The unique ID of the form property. This is also the name of the workflow variable that contains the user-submitted value. IDs cannot include special characters.
Name (recommended)	The description of the configuration variable. If used in a start form or user task (not recommended), the label that is displayed on the form, next to the property.
Responsibilities (required)	The form property type.
Expression (not used for configuration variables)	Use an expression to display a value for this form. `${1 > 2}` displays "False" for a boolean. You must clear the Writable parameter. The class of the stored value for the expression result must match that of the property. The form variable does not retain the displayed value.
Variable (not used for configuration variables)	Use a variable to display the value of that variable. If you select the Writable parameter, the user can change the value of the variable. `variableName` for a boolean variable that has the value `false` displays "False". If the user selects True for this property, the value of variableName is updated to `true`. The class of the stored value for the variable must match that of the property. The form variable does not retain any value because the value is that of the provided variable.
Default (mandatory for configuration variables)	The default value for the property. You can also use variables, such as `${variableName}` or expressions, such as `${1 > 2}` The class of the stored value for the variable or the expression result must match that of the property.
Required	Whether it is mandatory to fill in a value for the property. Select this check box for configuration variables.
Readable	Whether the property is displayed to the user. Clear this check box for configuration variables.
Writable	Whether the user can change the current value.