...
Note | ||
---|---|---|
| ||
There is a 1MB limit on the content size of scripts, whether the content is defined in the Script Details or a uploaded from a local file system (see Scripts#Uploading Uploading a Script, below). |
You can use scripts with the following task types: Windows, Linux/Unix, SAP, and File Transfer (UDM scripts for UDM File Transfer tasks).
...
For example, the following script shows how a Controller variable could be used.
Panel |
---|
#!/bin/bash
echo Task Name: ${ops_task_name}
echo Task Instance: ${ops_task_id} |
Note | ||
---|---|---|
| ||
You also can enter a script directly into a Universal Template, but you cannot select a stored script. |
...
Script | For use in Windows or Linux/Unix tasks. |
---|---|
SAP Definition | For use in SAP tasks. |
UDM Script | For use in UDM File Transfer tasks. |
Web Service Payload | For use in Web Service tasks. |
Data | For use in a script or task (see Scripts#Data Data Scripts, below). |
Anchor | ||||
---|---|---|---|---|
|
...
To use a Data Script with a script, embed the Data Script in any of the following:
- Scripts#Content Content of a Script specified in the Script field in a Linux/Unix or Windows task.
- Scripts#Content Content of a Data Script.
- Universal Template Script (Script, Linux/Unix Script, or Windows Script field).
...
For every Data Script embedded in a Data Script, the Controller will resolve ${_scriptPath('script_name')
} (if Scripts#Resolve Resolve UAC Variables is enabled for the Data Script), and look for additional Data Script references (and Resolvable Credentials references). This process will continue until no additional Data Script references are found.
...
Step 1 | From the Automation Center navigation pane, select Other > Scripts. The Scripts list displays a list of all existing scripts. |
---|---|
Step 2 | Enter / select Details for a new script, using the field descriptions below as a guide.
To display more of the Details fields on the screen, you can either:
|
Step 3 | Click a button. The script is added to the Controller database, and all buttons and tabs in the Script Details are enabled. |
Note | ||
---|---|---|
| ||
To open an existing record on the list, either:
|
...
The following Script Details is for an existing script. See the field descriptions, below, for a description of all fields that display in the Script Details.
For information on how to access additional details - such as Metadata and complete database Details - for Scripts (or any type of record), see Records.
...
Field Name | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Details | This section contains detailed information about the Script. | ||||||||||||||||
Name |
| ||||||||||||||||
Version |
| ||||||||||||||||
Description |
| ||||||||||||||||
Member of Business Services |
| ||||||||||||||||
| Type of script:
| ||||||||||||||||
| Controls whether or not the Script will be parsed in pursuit of Universal Controller variables. It allows the Controller to avoid the overhead of parsing a Script that does not contain variables.
| ||||||||||||||||
|
For UDM Scripts, Source and Destination credentials are available for use. The credentials can be coded into the UDM script using the following File Transfer variables: The variables will be resolved by UDM internally. The following example illustrates the correct way to code them:
| ||||||||||||||||
Metadata | This section contains Metadata information about this record. | ||||||||||||||||
UUID | Universally Unique Identifier of this record. | ||||||||||||||||
Updated By | Name of the user that last updated this record. | ||||||||||||||||
Updated | Date and time that this record was last updated. | ||||||||||||||||
Created By | Name of the user that created this record. | ||||||||||||||||
Created | Date and time that this record was created. | ||||||||||||||||
Buttons | This section identifies the buttons displayed above and below the Script Details that let you perform various actions. | ||||||||||||||||
Save | Saves a new script record in the Controller database. | ||||||||||||||||
Save & New | Saves a new record in the Controller database and redisplays empty Details so that you can create another new record. | ||||||||||||||||
Save & View | Saves a new record in the Controller database and continues to display that record. | ||||||||||||||||
New | Displays empty (except for default values) Details for creating a new record. | ||||||||||||||||
Update |
| ||||||||||||||||
| Allows you to upload a script from the local file system and place it in the Scripts#Content Content field (see Scripts#Uploading Uploading a Script, below). | ||||||||||||||||
Copy | Creates a copy of this script, which you are prompted to rename. | ||||||||||||||||
Delete |
| ||||||||||||||||
Refresh | Refreshes any dynamic data displayed in the Details. | ||||||||||||||||
Close | For pop-up view only; closes the pop-up view of this task. | ||||||||||||||||
Tabs | This section identifies the tabs across the top of the Script Details that provide access to additional information about the script. | ||||||||||||||||
Tasks | Lists of all tasks using this script. | ||||||||||||||||
Notes |
| ||||||||||||||||
Versions |
|
Anchor | ||||
---|---|---|---|---|
|
To upload a script into the Scripts#Content Content field in the Script Details:
Step 1 | Click the Scripts#Upload Upload Script button. The Script File Uploader pop-up displays. |
---|---|
Step 2 | Click the Browse... button Choose File button and select a script from the local file system. |
Step 3 | From the Select file encoding drop-down list, select the character set of the script: ISO-8859-1, US-ASCII, UTF-8, UTF-16, UTF-16BE, or UTF-16LE. |
Step 4 | Click the Submit button to add the script to the Scripts#Content Content field. |