Combo

<< Click to Display Table of Contents >>

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

Combo

Use

The Combo control presents a drop-down list that displays a set of values. Only one item can be selected.

 

Considerations

Always define a Display attribute for the control.

 

Related to attribute types

Combos are usually related to Parameter entities, as related attributes, to display a list of entity values.

However they can also be related to Master entities and System entities. Take great care when relating combos to a Master entity; remember they hold all information pertaining to the case and thus they tend to increase in size. Displaying a very large list of values might become impractical for end users.

 

Properties

The following properties are exclusive to the Combo control:

 

Basic tab

PROPERTY

DESCRIPTION

Display attribute

Defines the attribute of the entity that will display in the Work Portal.

For example, the City entity has three attributes namely City name, City Area code and City initials. In order for the end user to easily recognize the City, the Display Attribute can be set to City name.

Additional attribute

Defines an additional attribute to be shown in the combo. It will follow the Display attribute with a dash character.

 

Display attribute and Additional attribute example

 

Forms Components25

 

Advanced tab

 

PROPERTY

DESCRIPTION

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. For Combos you will be able to set a default value using an expression.

 

If the associated attribute is valued by means of an expression, the default value of the Combo control will be ignored.

Submit on change

This property is deprecated. We suggest using Actions and Validations.

When enabled, as the end user selects a value from the control, the entire form will refresh and execute all actions, validations and visibility rules, saving what has been entered.

Sort by attribute

Enables the Combo to be sorted by an attribute of the Parameter entity. The list in the child attribute is sorted in ascending order based on the chosen attribute. For example the Delivery City control can be sorted by either the City name or by Area code.  If a method of sorting is not defined, the attribute will be ordered by its internal identifier.

Filter

Allows you to define a smaller set of values from the list of all possible values in the related entity, for displayed in your combo. Bizagi only display the records that meet the filter condition defined in a Boolean expression.

 

note_pin

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

 

Sort by example

Forms Components26

 

Example

In a Purchase Request Process it is necessary to select one of the company's Cost Centers to identify where to charge the purchase.

A Cost Center combo is required in the Request activity for the end user to select it.

 

1. You need a Parameter entity containing all the Cost Centers available in the company. There must be an attribute (Cost center) in the Process Entity pointing to the Parameter entity; this will be done using a related attribute relationship between Purchase Request (Process Entity) and Cost Center (Parameter entity).

 

 

Forms Components45

 

2. Enter values (or records) in the Cost Center entity.

 

3. In the Forms Designer identify the attribute Cost Center. Drag and drop it onto the Display area.

When you drag and drop an attribute with a related entity relationship it will be interpreted in Bizagi as a Combo control, by default.

 

Forms Components46

 

4. Add any more controls you need to the form.

Go to the Work Portal and test the control.

 

Forms Components47