Script includes used to store JavaScript functions and classes that will execute on the server. Script includes generally specifying either object class or function.
Role required: admin. |
A script include has a name, a description, and a script itself. Also, it is possible to specify if it is active or client-callable.
To create a new script include, please complete the following steps:
Field | Description | ||
---|---|---|---|
Name | Script include name. Should match with the class name declared in the script field. Also, script include name should not contain spaces. | ||
Description | Short action description | ||
Active | When set to TRUE, this script will execute when called; otherwise, it will not execute. | ||
Client callable | When set to TRUE, this script will be available to call on the client-side scripts. | ||
Script | Define the server-side script to run when called from other scripts
|
You can call a server-side script include in case if you need to use server-side methods on the client-side. To perform this, activate the Client Callable attribute.
For more clarity, let us consider a simple example of calling a script include from a client-side.
A practical case is a calculation of the time period between two specified values using a specific schedule.
For this, let us create script include with parameters like shown below:
Name | DurationCalculator | ||
---|---|---|---|
Active | true | ||
ClientCallable | true | ||
Script | Enter a script from the code example below
|
In another example listed below, we use SimpleAjax on a client-side, and that's what we do:
if (s_form.getValue('start') && s_form.getValue('end') && s_form.getValue('schedule_id')) { const calculate = new SimpleAjax('DurationCalculator'); // call script include calculate.addParam('sysparm_name', 'getDuration'); // call method calculate.addParam('sysparm_start', s_form.getValue('start')); // pass param calculate.addParam('sysparm_end', s_form.getValue('end')); // pass param calculate.addParam('sysparm_schedule', s_form.getValue('schedule_id')); // pass param calculate.getXML(callback); function callback(response) { const answer = response.responseXML.documentElement.getAttribute('answer'); // value received from server-side s_form.setValue('duration', answer); } } |