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 (Forms Components147) 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.

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 (Forms Components148) 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.

 

 

Controls behavior

 

CreatingForms13

 

FORMAT TAB

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

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.

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

oFormat 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

Forms Components19

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.

 

Forms Components207

 

Layout example

 

Using percentage distribution

 

Forms Components20

 

Using fixed pixels

 

Forms Components222

 

 

ADVANCED TAB

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