Actions components

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Process wizard > Define Forms > Customizing controls behavior > Actions and Validations >

Actions components

Actions are defined by three components:

The condition to evaluate.

The action to perform when the condition is met.

The action to perform when the condition is not met.

 

To define an action, go to the Actions & Validations wizard and click the Add button within the Actions tab :

 

 

Controls behavior1

 

 

Define the conditions (When)

Click Add a condition. A new row will be added to create a condition.

 

Controls behavior3

 

 

The condition has a Control, an operator, and an argument.

 

Control: Defines the control to be evaluated. This control MUST be included into the form where the actions are configured.

Operator: Defines the comparison operator for the condition. The available operators are:

 

Operator

Description

Applies to controls

changes to

Evaluates if the value of a control has changed to a specific value.

Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date

is different to

Evaluates if the value of a control is different to a specific value.

Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date

is empty

Evaluates if the control is empty.

Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date

is not empty

Evaluates if the control is not empty.

Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date

changes

Evaluates if the value of a control has changed.

Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date

does not contain

Evaluates if the value of a control does not contain an specific character.

Text box

contains

Evaluates if the value of a control contains an specific character.

Text box

begins with

Evaluates if the value of a control begins with an specific character.

Text box

does not begins with

Evaluates if the value of a control does not begin with an specific character.

Text box

is an invalid email

Evaluates if the value of a control is an invalid email.

Text box

less than

Evaluates if the value of a control is less than a specific value.

Date, Currency, Number

less than or equal to

Evaluates if the value of a control is less than or equal to a specific value.

Date, Currency, Number

greater than

Evaluates if the value of a control is greater to a specific value.

Date, Currency, Number

greater than or equal to

Evaluates if the value of a control is greater than or equal to a specific value.

Date, Currency, Number

has a row deleted

Evaluates if a row has been deleted in a table.

Table

click

Evaluates if a button has been clicked.

Button

is true

Evaluates if the value of a control is equal to true.

Boolean

is false

Evaluates if the value of a control is equal to false.

Boolean

has a file uploaded

Evaluates if a file control has a file uploaded.

File

has not files uploaded

Evaluates if a file control has not files uploaded.

File

 

Argument: Defines the value to be compared with the control. This value can be a constant or a data binding.

 

You can create compound conditions connected with AND and OR.

 

To create a compound condition connected with an AND click Add a condition.

To create a compound condition connected with an OR click Add a condition group.

 

Controls behavior4

 

 

When the conditions are created you can switch between AND and OR by clicking over them.

 

Controls behavior18

 

Define the main Actions (Then)

Click Add an action. A new row will be added to create an action.

You can create as many actions as desired. All of them will be executed when the condition defined above is met.

 

Controls behavior5

 

The action has a command, a control and an argument.

 

Command: Defines the type of behavior to be applied. Within the commands you will find:

 

Command

Behavior

Set background for

Changes the control's background color

Set forecolor for

Changes the control's color

Changes visibility for

Makes a control visible / invisible

Changes editability for

Makes a control editable or read-only

Set required for

Makes a control mandatory or optional

Set value for

Sets a value for a control

Set minimum value for

Sets a minimum boundary value for a control

Set maximum value for

Sets a maximum boundary value for a control

Collapse

Collapses/Expand a group

Set as active

Sets a Tab as active

Refresh

Refreshes the control's value according to what has been entered in the form. It is very useful when a control's value depends on the value of another or the execution of an interface or expression.

note_pin Not supported in Add forms of a Search control

Execute rule

Executes an expression.

Execute interface

Executes an interface.

Clean data for

Deletes any data entered in a control.

 

 

Control: Defines the control to which the behavior will be applied.

Argument: Defines the value of the command to be applied.

 

Define the action when the condition is not met (Else)

These are the actions to be performed when the defined conditions are not met.

 

Controls behavior6

 

Perform the following Actions: Allows defining a set of actions to be performed when the defined conditions are not met. These are defined in the same way the main actions do.

Do nothing: Do not perform any action when the defined conditions are not met.

 

 

Affecting several controls

When you need to affect several controls that are one next to the other in a form, you can make use of the Panel control to group them. This way you can affect the whole group instead of making individual actions for each one.

 

This control is found in Bizagi's containers on the Form designer.

 

Action10

 

 

Using actions can save you time, check out the following image to compare how.

Both Actions are correct, and will do the exact same thing. But using Panel will make the form designs faster.

 

 

Action11

 

 

note_pin

Consider these concepts related to Panels:

Using Panel will only help you to work with Actions, it will not affect the end user interface in any way.

Panels can be used to set background color, change visibility, change editability and refresh.

 

 

Click to see examples of how to configure basic actions.

Click to see an example of how to configure other actions

Click to see how to configure actions over tables