Text box

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Process wizard > Define Forms > Form Controls >

Text box

Use

The Text box control displays string-type attributes in the Form.

 

Considerations

By default, the maximum length allowed for the text entered will be equivalent to the maximum length defined for the associated attribute. If there is also a maximum length defined in the Text box control's properties, the true length allowed will be the lesser amount of the attribute's property or the control's property.

The number of lines displayed in an extended text control is not related to the number of characters allowed in such control.

 

Related to attribute types

This control is related to string-type attributes or extended text attributes.

Extended text attributes hold an unlimited number or characters.

 

Properties

The following properties are restricted to the Text box control:

 

Basic tab

 

PROPERTY

DESCRIPTION

Is extended

The property, if enabled, expands the height (number of lines) of the text area and displays a vertical scroll bar.

Auto-extend

If enabled, expands the height (number of lines) of the text area by demand, every time the number of lines is reached, an additional line is added and hides the vertical scroll bar. This property is hidden when the property Is extended is disabled.

Lines to display

Sets the number of lines that will be displayed for an Extended text control. This property affects the height of the text area. It is very useful for Extended texts in Tables. By default the number of lines is 6. If number of characters exceeds the space, a scroll bar will display.

This property is available when the property Is extended is enabled.

Maximum length

Defines the maximum number of text characters that can be entered into the Control.

 

Is extended property example

 

Forms Components105

 

 

Advanced tab

 

PROPERTY

DESCRIPTION

Re-type

Forces the user to re-enter the value to make sure they entered it correctly.  These values are compared on clicking the Next button. If there is no match the values must be re-entered.

The verification value can be configured for entry in one of two ways:

Duplicate: Displays two Number Controls. Both controls must contain the exact same information to continue.

Double: Requires end users to type the same number twice in the same Control. If the values do not match a validation message will display.

Default Value

Automatically sets a value when the Form opens for the first time. As soon as a value is chosen by the user the default will be replaced. If the associated attribute is valued by means of an expression, the default value of the Text box control will be ignored. The default value can also be set using an expression.

Regular Expression

A regular expression is a special text (with a defined syntax) for identifying a pattern of characters or a particular character in order to validate the content that is entered in a text box control. This functionality is not meant to replace the text entered; if the text does not satisfy the regular expression, the control is left empty.

Expression: defines the expression that validates the content entered in the Text box Control.

For further information please refer to Regular expressions.

Clicking the Set to default value icon will reset the properties.

Validation message: defines the validation message that will be shown if the entered text does not comply with the expression condition.

 

note_pin

Clicking the Set to default value icon will reset the properties.

 

 

Re-type property example (Duplicate method)

 

Forms Components111

 

Example

A school has implemented a Process in Bizagi to execute history tests. The answers to each test question are stored in Parameter entities. Suppose the test has three questions and answers; so, three parameter entities must be created.

In order  to answer these questions, Text box Controls must be inserted onto the Form.

 

 

 

Forms Components106

 

 

1. Drag and drop the Answer1 attribute from the data model onto the Display area. This will be interpreted automatically in the Form as a Text box Control.

 

Forms Components107

 

2. Enable Is extended in the Basic tab of the Text box Properties.

 

Forms Components108

 

 

3. Repeat the previous steps for the other two Text box controls pertaining to questions two and three.

Save the form.

 

Forms Components109

 

 

4. Go to the Work Portal to test the controls.

 

Forms Components110