On Save: Difference between revisions

Revision as of 06:48, 20 July 2022

Rules and examples
On Load On Change On Save On Create Select Form Row Script On Execute On Can Execute Cell Click Button Click On Item Added On Item Completed On Repeat On Delete Form rules Rules on the bulk update form Command rules Questionnaire Designer examples Rules editor Global constants

Warning

Work in progress! We are in the process of updating the information on this page. Subject to change.

The On Save rules are checked when you save a record. Rules are client-side scripts that are executed when a user of the mobile app interacts with the app. Rules are no-code business logic, which are managed using the rules editor, usually in Woodford.

On Save rules are available for the following user interface components:

Save action

To understand On Save rules, it is important to understand how the saving of records works in Resco mobile apps. This is the order of events when saving:

User initiate saving process.
On Save rules are executed.
The app checks whether the record can be saved (rules may interrupt save).
If valid, the record is saved.

Display validation problems

There are two built-in string variables that can be used to display validation problems:

ErrorMessage: A string variable where you can set an error message for form. In the case of On Save event, this stops the saving.

ErrorMessage	Assign	Web site URL cannot be empty!

WarningMessage: A string variable where you can set an error message for form. In the case of On Save event, this does not prevent saving, user can decide to continue.

WarningMessage	Assign	Web site URL is empty! Continue anyway?

Forms

On Save rule on forms usually serves as a final field validation or they can automate changes in related records.

Rule execution

When you save a record.

Example: Main phone field validation

This rule shows a warning message if the phone format is not correct. As this is only a warning, users can ignore it and save the record anyway.

Example: Check related entity before saving

This somewhat dated blog shows how to check a related record before you can save changes. Blog

Views

On Save rules can be used with views, but only when the Editable field is set. (Editable field, list, or editable grid is a feature that allows users to edit one or more records directly from the view, without a need to go to the form of a record.)

Questionnaires

In inspections, there are two options when to execute On Save rules.

Rule execution

When you save the questionnaire
When you complete the questionnaire

This behavior is configured on the questionnaire level, in the Validate On property.

@@ Line 34: / Line 34: @@
 ;Rule execution
+* When you save a record.
-*When you save a record.
+=== Example: Main phone field validation ===
-===Example: [https://www.resco.net/blog/utilizing-form-rules-to-load-information-from-any-entity-on-forms-e-g-save-changes-only-when-specific-data-is-associated/ Save changes only when specific data is associated.] {{Badge|Blog}} ===
+This rule shows a warning message if the phone format is not correct. As this is only a warning, users can ignore it and save the record anyway.
-===Example: Main phone field validation===
-Shows warning message if the phone format is not correct.
+[[File:Warrning message example.PNG|600px]]
-[[File:Warrning message example.PNG|600px]]
+=== Example: Check related entity before saving ===
+This [https://www.resco.net/blog/utilizing-form-rules-to-load-information-from-any-entity-on-forms-e-g-save-changes-only-when-specific-data-is-associated/ somewhat dated blog] shows how to check a related record before you can save changes. {{Badge|Blog}}
 == Views ==