You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Next »

Client-side scripts allow the system to run JS scripts in the browser when the client-side events happen, for example:

  • form loading;
  • form submitting;
  • field value changing.

Client-side scripts are used to configure forms, form fields, and field values while the client uses the form. Their abilities:

  • make the field hidden or visible;
  • make the field read-only;
  • make the field mandatory or non-mandatory;
  • set the value in one field, basing on the value in another field;
  • change parameters in a Choice list;
  • show a message basing on the field value.

The client-side script form configuration


The client script can be configured via the SimpleOne administrative interface.

You must have admin privileges to do this.

To configure a script, please navigate to System Definition -> Client Script. In the table below you can find information about the fields.

NameDescription
NameClient-side script name
TableA table on which form the script will be executed.
Type

The script type:

  • onLoad – it starts when the system displays the form for the first time before users will enter data. Generally, onLoad scripts perform manipulations on the client-side with the current form or set default record values.
  • onChange – it starts when the specified field in the form is changed;
  • onSubmit – this client-side script can cancel form submitting by returning false.
  • onCellEdit - this client-side script starts at the moment when some cell is to edit.
View
Condition
DescriptionA detailed description of script actions.
ActiveWhen set to TRUE, the script is active; otherwise, it is not.
InheritedWhen set to TRUE, the script will be applied not only for the table specified in the Table field but also for all its child tables.
ScriptThis field contains a client-side script.
Updated byThis field contains information about the person who has updated the script. This field is filled automatically and always read-only.


Client-side API

In the client-side scripts, you can use methods that are provided by client-side API (SimpleForm class).

  • No labels