The RunScript API allows the execution of a specified script. Execution permissions are controlled by the script's execute ACL.
A Script can be run synchronously by calling the RunScript API or asynchronously by scheduling it to run at a certain date and time. Each Script execution time is limited to 30 seconds for safety and security reasons. Hence, Scripts operating on large data sets will need to run in asynchronous mode, where a batch of the data is handled every time the script is fired. In this case, the Script keeps rescheduling itself until all the data set has been handled.
A developer may choose to generate debug level info from any Script and have those log traces downloaded as a file using the GetScriptLogs API.
A developer is also given the choice to make his set of Scripts for a particular application mode modular by defining Script libraries that can be included in other Scripts. This is very useful for building different classes of script libraries that can be integrated in any application, such as social media script libraries, persistence script libraries, identity script libraries, messaging script libraries, etc.
The scripts that are created by the applications' owners are private and can only be accessible under that application. However, Apstrata provides a set of scripts that can be shared among all the applications; this feature grants the application owner the privileges to view those scripts and run them, to import them into their own script libraries and then apply desired updates and modifications on that private copies.
For more specific details on scripts, please refer to the Server Scripting Reference section.
- Note that shared common system scripts can only be executed when they are not overridden by an application private script.
Specific Request Parameters
(Refer to Common Request Parameters)
The name of the script to execute
The value of a parameter named "paramName" that needs to be passed to the script (i.e: parameter1 = valueA)
Note that multiple parameters and their values can be passed to the script
This parameter is used to sign the request with a token. For more details on signing requests, please refer to the page entitled Authentication .
Specific Response Elements
(Refer to Common Response Elements)
The following specific "result" element is a child of the common root element "response" and a sibling of the common "metadata" element:
Specific Logical Errors
(Refer to Common Logical Error Codes)
Invalid script name [scriptName]
Sample XML Response
Sample JSON Response
Upload a file to the Script
To pass a file to a script, you need to send it in a multipart request. This can either be done in an HTML form with an input of type “file” representing the field under which the file will be saved (ex: <input type=”file” name=”myFileFieldName”>) or by sending a raw HTTP request as follows: