Skip to content

Basics of Ruleset Development

What is a Ruleset

A ruleset is a special document within the Formbird system that contains instructions to execute on a particular event.

A ruleset comprises a collection of rules, each of which is evaluated in turn, and executed, if the rule condition is met.

See Also: Rulesets - Basic Concepts

Why use Rulesets

A lot of functionality can already be performed and encapsulated within a Template, such as setting fields mandatory, enabled and so forth.

Often though, we may need more complex functionality that can't be configured in a Template.

Example:

When a checkbox field labeled "Requires Verification" is checked, then the fields labeled "Verification Details" and "To be verified by" should be enabled and made mandatory for saving the document.

When do Rulesets run

Rulesets are invoked by the Formbird system on particular events of a document*.

There are two types of events to consider: client-side events, and server-side events.

ClientSide Event Description
OnLoad When a document is read from the system and loaded to the browser.
OnFieldChange When a field is changed on a document in the browser.
PreSave When the user has clicked the save button, but before the saving has completed.
ServerSide Event Description
PreSaveServer Before the document has been saved to the database.
PostSave After the document has been saved to the database.