Business logic

Business logic is a part of program or application, essentially a set of business rules and workflows that direct the interaction between user interface and data.

Examples

Here are some simple examples of what we understand as business logic in Resco Mobile CRM:

• Validate email address, postal code, telephone number
• Calculate the duration of an event (actual end – actual start)
• Hide a field or disable it, depending on a condition
• Populate fields on a child entity based on the parent
• Modify an order to add a special discount
• Find out how many appointments are associated to an account

Levels of business logic in Resco Mobile CRM

• Built-in / hard-coded
• Reused server-side logic
• Rules (Form, View, Calendar, Map, …)
• JavaScript

Rules

Rules are scripts that run directly in the mobile application. They offer a way for setting up business logic using Woodford. Rules can be placed on multiple user interface components:

• Form
• View
• Route plan
• Calendar
• Map

We are continuously adding rules support to UI components. See Rules editor for more information about rules.

Scripting language

Sample rule

Rules are formed in a simple scripting language. Essentially, you combine conditions and steps.

Conditions
If... Then... Else...

Steps
Hide fields Set read-only Assignment Set GPS position Say text Set a variable Load a fetch

You don't write scripts, you build them using buttons and selecting values from a drop-down menu. Use the dot notation to work with entity fields or object properties.

Objects in rules

Rules allow you to evaluate and modify parameters of various objects:

• Entity – edit/create/delete records
• Form – modify what's displayed on a form
• Tabs – modify all the tabs of a form
• Variables / shared variables – Save a value as a variable to use later in a rule, display, or use in a different rule
• Configuration – currently logged-in user, URL, online/offline status, etc.
• Relationship – determine whether a form is opened via associated view
• Specialties

Form rules

Form rules describe sequences of steps that are executed on form-related events. They allow you to for example to customize edit form user interface (hide or disable fields, assign values, etc.). Here are some of the events available for forms:

On Load

These rules are checked when you open a form. You can use these rules for example to apply custom format to certain records.

On Change

These rules are checked when you open a form or modify any field. Example: simple form validation.

On Save

These rules are checked when you save a record. For example, saving a record can automatically also update a field in a parent record.

On Can Execute

Define when a form command is available for the user.

On Execute

Define the actions that the command performs.

View rules

These are some of the events that trigger rule execution for views.

Row Script

Define conditions when a specific row design should be used.

On Save, On Change

These events are used in conjunction with editable lists, where they play similar role as on the form.

Button Click

Executed when a row button is clicked.

Cell Click

Executed when an editable or clickable cell is clicked.

JavaScript

Resco JavaScript Bridge, or JSBridge.js, is a component provided by Resco that allows the scripts in the HTML frame to interact with Resco mobile apps. You can interact with the user interface, with data, and perform additional actions. Script files need to be included in the project using the Offline HTML section of Woodford.

Rules and JavaScript can even be combined, see Execute JavaScript from rules for more information.

See also

• Best practices for form rules Blog
• Make inactive record active using form command rules Blog