Script Page

The Script page defines the script to be executed.

Name

Provide a descriptive name for this script. If the script is Shared, a name is required. Otherwise the name is optional. The name must be unique across all scripts.

Shared

Check this option to allow the script to be shared among jobs, responses, etc. If the script is not Shared it will be available only for the object with which it is associated.

When a script is shared the Security page will be visible, allowing you to specify permissions for the script.

Once you have checked the Shared option and clicked OK, the script cannot be "unshared." If you no longer want it to be shared you must delete it and recreate it.

Description/Notes

Enter any extended descriptive information or notes for this script. There is no limit on the length of the text.

Language

Select the language that the script uses. The following languages are supported by default:

VBScript
VB.NET
C#
JScript

If your server has a Windows Scripting Host-compatible language (such as perlscript) that is not listed, you can enter the name of the script language and adTempus will attempt to use it.

Included Script Libraries

If your script uses procedures from any Script Libraries, select them here to make them available to the script. The libraries you use must be written in the same language as the script, therefore the list of available libraries will change when you change the Language.

Referenced Assemblies

If you have selected one of the .NET languages (VB.NET or C#), your code may reference other .NET assemblies.

Script

Provide the body of the script.

When you initially select the script language, the script body will be filled with a template script for you to use as a starting point. The contents of the template will depend on the context of the script (for example, the template for a Script Execution Task will be different than the template for a Condition Script).

In most cases, your script must return a result to adTempus to indicate the outcome of the script and tell adTempus how to proceed. See the Script Overview topic for more information about how to return a result to adTempus.

Maximum Execution Time

Specify the maximum time (in minutes) that the script should be allowed to run. (This feature protects against "runaway" scripts.)

If this script is used in a Script Execution Task, which also allows you to specify a time limit, adTempus will use the most restrictive of the maximum run times specified for the Script and the Task.

Validate

Click the Validate button to validate your script. adTempus will check to ensure that the code appears valid. The script is automatically validated when you click the OK button.

Quick Test

Click Test to validate and execute your script. If the script returns a value, that value will be displayed.

Validation and testing of the script occur on the computer that the Console is running on. If you are connected to the adTempus server from a remote computer and your script refers to external objects, files, etc., you should test the script from a Console running on the computer that hosts the server to be sure that it will work correctly on the server.