Page History

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

• form loading;
• form submitting;submission
• field value changingchange.

Client -side scripts are used to configure scripts allow configuring forms, form fields, and field values while the client uses the form. Their abilitiesThey can execute the following actions:

• 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 based on the value in another field;.
• change the parameters in a Choice the choice list;.
• show a the message basing based on the field value.

Client-side scripts are used to execute JavaScript scenarios on the client-side. Client-side scripts may be either a record of the Client Script (sys_script_client) table, or it can be executed within some UI Actions when its Client parameter is equal to 'true'.

Image Added

Client logic can also be implemented within the client script widget:

Image Added

The general client-side

classes are: SimpleForm, SimpleList, and SimpleUser. To get more information about client-side classes, please check our Client-Side API article.

Creating a client script

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

To configure a the script, please complete the steps below:

1. Navigate to System Definition -> to System Settings → Client Script.
2. Click New and fill in the fields.
3. Click Save or Save and Exit to apply changes.

Client script form fields

Client-Side API

In the client-side scripts, you can use methods that are provided by Client-Side API.

Script Debugging

Image Removed

Also, client logic can be implemented within the widget client script:

Image Removed

General client-side classes are: SimpleForm, SimpleList, and SimpleUser. To get more information about client-side classes, please check our API reference.

Special Features

Use callback Use callback functions to work with SimpleRecord objectsClient-Side objects:

const record = new SimpleRecord new SimpleRecord('task');
record.get('159644860216948298', () => {
  console    console.log(record.number);  // TSK0000123
});

Dot-walking is not available for fields of the Reference type. You can use a the callback function sequence as a workaround.
For example, instead of server-side dot-walking:

current.slm_commitmentcaller.agreementcompany.service_idphone

in client-side script, it will be looks look like:

const commitmentIDcallerID = s_form.getValue('slm_commitmentcaller');
let callersCompanyPhone = '';
if (commitmentIDcallerID) {
    const commitmentuser = new SimpleRecord('slm_commitmentuser');
    commitmentuser.get(commitmentIDcallerID, () => {
        const agreementcompany = new SimpleRecord('agreementorg_company');
        agreementcompany.get(commitmentuser.agreementcompany, () => {
         const service = new SimpleRecord('sys_cmdb_ci_service');if (company.next()) {
      service.get(agreement.service_id, () => {
        s_form.setValue('service_id', agreement.service_id, service.name);
callersCompanyPhone = company.phone;
            });
        });
    });
} else {
  s_form.clearValue('service_id');
}

// Not Recommended
document.querySelector(".article-body").innerHTML = s_widget.getFieldValue('body');
// Recommended
s_widget.addTemplate('body', s_widget.getFieldValue('body'));