Business logic

From Resco's Wiki
Jump to: navigation, search
Wikipedia logo
Wikipedia has an article on the same subject:

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:

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