Page History

This class allows the client-side script executing the code provides methods that allow the client-side script to be executed on the server side using Script IncludesInclude.

To use the SimpleAjax class, complete the following steps:

1. Call the SimpleAjax constructor to create a SimpleAjax instance. The script includes a name, which An argument for the constructor should be the name of the script include that involves the class with the necessary methods, should be the argument for the constructor.

2. Call the addParam(paramName, paramValue) method. Pass the required parameters defining the method

   . When calling it, provide 

   needed as the main call. To do so, complete the following steps:

   1. set the sysparm_name
    as a
   1. parameter.
   2. and the method name taken from the
   include part of
   1. defined class called by the script
   called
   1. include.
    

   To provide other parameters to the script

   code

   include, call this method as many times as you need.

3. Сall the Call the getXML(callback) method to execute the method declared above.

addParam( paramName, paramValue)

This Use this method passes to pass the specified parameter name and value to the server-side function associated with the current SimpleAjax object. The addParam() method can be used several times with different parameters and values.

Parameter(s):

Return:

Example:

const sAjax = new SimpleAjax('DurationCalculator'); // call script include
sAjax.addParam('sysparm_name', 'getDuration'); // call class method
sAjax.addParam('sysparm_start', s_form.getValue('start')); // pass parameter
sAjax.getXML(callback);

function callback(response) {
  const answer = response.responseXML.documentElement.getAttribute('answer');
  console.log(answer);
}

getXML(callback)

Anchor
XML XML

By calling this method, the client script sends a request to the server, where the method and parameters related related to the current SimpleAjax object are is executed with the specified parameters. The request is processed asynchronouslyprocessed asynchronously.  The results The results of the server-side method execution will be returned via passed to the function specified as a callback function. 

Return:

Example:

const sAjax = new SimpleAjax('DurationCalculator'); // call script include
sAjax.addParam('sysparm_name', 'getDuration'); // call class method
sAjax.addParam('sysparm_start', s_form.getValue('start')); // pass parameter
sAjax.getXML(callback);

function callback(response) {
  const answer = response.responseXML.documentElement.getAttribute('answer');
  console.log(answer);
}

runScript(scriptValue, tableName, callback)

This Use this method allows to run a script against a table specified. The script is run runs with the ACL restrictions.

Parameter(s)Parameters:

Return:

Example:

const CURRENT_ID = s_form.getUniqueValue();

const simpleAjax = new SimpleAjax();
await simpleAjax.runScript(
  `const current = new SimpleRecord('task');
  current.get('${CURRENT_ID}');
  setResult(current.caller.email)`,
  null,
  (response) => {
    console.log(response.data.result);
  }
)

runAdminScript(scriptValue, tableName, callback)

This Use this method allows to run a script by a user with the . To do so, an administrator role. The script is run without the ACL restrictions. If the user who is necessary. There are no ACL restrictions for the script. If a user that does not have the administrator role, attempts to a run a script, the script will not be run, and the method will return returns an empty result as callback. Therefore, before Before using the script result, verify that the response.data.result is not empty.

Parameter(s)Parameters:

Return:

Example:

const simpleAjax = new SimpleAjax();
await simpleAjax.runAdminScript(
  `const supportSiteURL = ss.getProperty('simple.auth_page.support_site');
  setResult(supportSiteURL)`,
  null,
  (response) => {
    const serverData = response.data.result;
    console.log(serverData);
  }
)