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
Every control has a set of properties that allow to customize its behavior in the Work Portal. However, some properties are exclusive to a specific control. 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
Advanced tab
PROPERTY |
DESCRIPTION |
|---|---|
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. |
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. |
|
Enable search |
Enables the option for the end user to type within the combo, to quickly find the desired value
|
|
Clicking the Set to default value icon will reset the properties. |
Sort by example
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).
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.
4. Add any more controls you need to the form.
Go to the Work Portal and test the control.
Last Updated 1/6/2022 11:24:32 AM