Customize page business logic | Creatio Academy | Improve your skills with Creatio Training Courses & Certification

Customize page business logic

You can configure the basic business logic of the record pages by adding or modifying business rules. Business rules affect the behavior of fields of the page, particularly:

To access business rule configuration in a section page:

1.Open the section where you want to customize the business logic.

2.In the section, click [View] –> [Open Section Wizard].

3.In the “Section pages” block of the Section Wizard:

•if you have only one edit page in your section, click [Edit page];

•if you have several edit pages in your section, click the link of a corresponding page in the list (Fig. 1)

Fig. 1 Selecting a section edit page from the list

4.Go to the [Business rules] tab. As a result, the list of business rules for the current page (Fig. 2) will open.

Note

Business rules are available for all section pages, detail pages, as well as custom pages designed as part of business processes.

5.To add a new business rule, click [Add business rule]. The business rule setup page will open.

Note

You can find examples of setting up business rules in the following articles:
“Show/hide an element on page”,
“Make a page field editable or locked”,
“Make a page field required or optional”,
“Filter values in a lookup field”,
“Set field value”

List of page business rules

You can set up several business rules for a page. All business rules display on the [Business rules] tab of the Page Designer (Fig. 2).

Fig. 2 The [Business rules] tab of the Page Designer

Click [Add business rule] to create a new business rule.
Select a rule in the list and click [Disable]/[Enable] to deactivate or activate it.

Note

Your Creatio configuration may have a “legacy” hard-coded business rules. Creatio will attempt to convert them to the regular rules, but it may not always be possible due to the implementation of the “legacy” rules. Creatio will attempt to convert them to the regular rules, but it may not always be possible due to the implementation of the “legacy” rules. If a hard-coded business rule was not recognized by the section wizard, then the name of this business rule will contain the message "(Incorrect rule)." The rule will be executed, but it cannot be opened or disabled in the section wizard. You only will be able to delete this rule with custom tools.

Business rule setup page

A business rule (Fig. 3) consists of two elements:

Condition (1) – a set of conditions that trigger the specific behavior of the page fields.
Action (2) – the page field behavior that is triggered.

Fig. 3 Business rule setup page

Creatio generates a business rule name and populates the [Name] field automatically, based on its condition and action.

Business rule conditions

Conditions in business rules are similar to advanced filters: they match a set if actual (current) values against the target values. If the values match, the condition is deemed fulfilled. On the business rule edit page, the conditions are grouped under the [IF] node.

The table below lists the types of elements that can be matched against each other in a business rule condition:

Type of value	Notes
Field	A column in an object that is the data source of the current page. For example, the data source of the [Accounts] section record page is the “Account” object. You can select columns of the linked objects (e.g., use the data of the account’s primary contact).
System setting	A system setting, that in this context is treated as a field with a certain value. Be sure to specify the system setting code (as opposed to its localizable title). You will need to specify the system setting code manually. The list of system settings is available in a separate article. Business rules work only with system settings that have [Cached] checkbox selected.
System variable	A system variable that in this context is treated as a field with a certain value that changes dynamically. For example, the “Current Date” variable is a “Date” type field that always contains the current date. Available system variables: “Current Time” “Current Date” “Current Time and Date” “Current user” (the current user account, stored in the SysAdminUnit object) “Current user contact” (the contact specified on the current user’s page in the [System users] section) “Current user account”
Attribute	The attribute value (for example, a virtual column). This option is intended for developer customization and requires development tools.
Constant	A static value of the following types: text, integer, decimal, date and time, date, time, lookup, Boolean. Use constants to match field values, system settings, system variables and attributes against a static value. A constant can be of any of the field data types supported in the section.

The conditions for execution of business rules are combined using common logical operators: "AND" / "OR." A business rule can have only one logical operator, which applies to all conditions of the business rule. The logical “AND” operator is used if the rule must be executed only if all conditions are met. Apply the “OR” logical operator if the rule must match at least one of the conditions.

A condition for executing a business rule usually consists of three parts: the left side, the type of comparison and the right side of the condition. More information about conditions in the business rules can be found in the specific chapter.

The actions of the business rule designer

Actions apply “on the fly,” whenever a business rule conditions are satisfied. Business rules can apply actions that implement the following behavior of the page fields:

Type of action	Notes
Show field on the page	Show and hide a page field. An active business rule with this action shows the specified field on the page if the conditions of the rule are fulfilled. Otherwise, the field will be hidden.
Make field required	[Make field required] – indicates that field is required when the conditions are met.
Make field editable	Lock and unlock a page field (make it grayed-out or editable). An active business rule will make the field editable, as long as the conditions of the rule are fulfilled. If the conditions of the rule are not met, the field will become grayed-out. If the conditions of the rule are not met, the field will become grayed-out.
Add field values filter	Filter the options in drop-down lists of lookup fields. An active business rule will apply the filter to the values available in the drop-down list of the lookup field. This type of action does not require a condition and will always apply to the page, as long as the corresponding business rule is enabled.
Set field value	Fills the specified field with the value of the specified Creatio object. If the conditions of the rule are not met, the field will not be populated automatically.