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

Compare with Current View Page History

« Previous Version 12 Next »

Client-side scripts let 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:

  1. make the field hidden or visible;
  2. make the field read-only;
  3. make the field mandatory or non-mandatory;
  4. set the value in one field based on the value in another field;
  5. change parameters in a Choice list;
  6. show a message basing on the field value.

The client-side script form configuration

Client script can be configured via the SIMPLE 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. The script will be executed on its form,
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.
ColumnThe changes of this field will be the triggers to start the onChange script.
DescriptionDetailed description of script actions.
ActiveIf TRUE then the script will work; otherwise it will not.
InheritedIf TRUE then 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 the client-side script.
Sys updated byThis field contains information about the person who did the last update of the script. This field is filled automatically and always read-only.


Client API

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

  • No labels