Controls properties

<< Click to Display Table of Contents >>

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

Controls properties

Each control has a set of properties that allow you to manipulate their behavior and visual presentation in the Work Portal.

To display a control's properties, click on the control or select the Properties icon (FormsComponents147) located on its upper boundary. The properties will display in the Left panel.

 

CreatingForms11

 

The Properties are contained in three tabs: Basic, Format and Advanced.

 

Basic tab

Display a list of the core properties of the control.

Properties highlighted with a red asterisk are mandatory.

Setting the Basic properties alone, will result in the default behavior of the control in the Work Portal.

 

PROPERTY

DESCRIPTION

Display name

This is the name of the attribute that will be shown in the Work Portal.

Help text

Contains the help text for this control. This context help is activated by the Help (FormsComponents148) icon on the control's upper boundary.

Data source

Relates the control to an attribute of the data model.

Visible

Sets the visibility of the control.  This can be determined by an expression.

Editable

Determines if the control is editable or read-only and can be set by an expression.

Required

Defines if the control is mandatory or optional and can be determined by an expression.

 

The Visible, Editable and Required properties allow you to either define if a control ALWAYS exhibits the same behavior or evaluate an expression (or business rule) to determine the behavior. To learn more about evaluating expressions for these properties please refer to Manage properties with expressions.

 

IMPORTANT: You can change some properties of multiple controls at the same time by selecting them while holding the Ctrl key. This will enable the Basic tab with the properties you can manage.

 

 

Controlsbehavior

 

CreatingForms13

 

Format tab

Apply to most of the form controls and enable you to customize the appearance of the Control in the Form.

 

PROPERTY

DESCRIPTION

Display type

Enables different visual formats in respect to the text (label) and the control (value). This includes hiding either the label or the value.

Label and value horizontal align

Aligns the label and value of the control within the space available in the Form.

Orientation

Defines if the text should be written from left to right or vice versa. The Inherited option indicates the property will be set according to the language selected in the Work Portal.

Format options

Changes the look of the control value or of the control label by customizing the size and formatting; for example font type, font style and background color.

Format label: changes the look of the control label, this format also controls the background color.

Format value: changes the look of the control value.

Layout

This property defines the percentage to distribute the control in the space available in the work area. When the value for Select format is Percentage, it splits the space into different width columns based on a percentage ratio. When the value for Select format is Pixels, Bizagi sets a fixed label width in pixels, the maximum value that can be set is 999 pixels. By default, it is a two-column split with a 50/50 width distribution.

 

IMPORTANT: You can change some properties of multiple controls at the same time by selecting them while holding the Ctrl key. This will enable the Format tab with the properties you can manage.

 

Display type example

 

FormsComponents19

Format example

The following image shows three controls (Request Date, Purchase justification, and Customer), the format for both, the value and the label are shown as they look in the Forms Modeler and in Work Portal.

 

FormsComponents207

 

Layout example

 

Using percentage distribution

 

FormsComponents20

 

Using fixed pixels

 

FormsComponents222

 

 

note_pin

Advanced tab tab contains the properties that are exclusive to the control to allow advanced configuration and customize its behavior.