...
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 17301516 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).
...
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 17301516 Data Scripts, below). |
Anchor | ||||
---|---|---|---|---|
|
Data Scripts (Script Type = Data) are meant to be used with scripts and commands specified in tasks, and resolved when the script or command is executed. Data Scripts provide the script or command with access to a path on the UAG file system where the temporary Data Script content resides.
...
To use a Data Script with a script, embed the Data Script in any of the following:
- 17301516 Content of a Script specified in the Script field in a Linux/Unix or Windows task.
- 17301516 Content of a Data Script.
- Universal Template Script (Script, Linux/Unix Script, or Windows Script field).
...
Note | ||
---|---|---|
| ||
Although you can embed a Data Script in the Command field or Parameters field of a Linux/Unix or Windows task, only scripts with Script Type = Script can be referenced in a Linux/Unix or Windows task; that is, it is the only type of script that is available for selection in the Linux/Unix or Windows task Script field. |
...
For every Data Script embedded in a Data Script, the Controller will resolve ${_scriptPath('script_name')
} (if 17301516 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.
...
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 17301516 Content field (see 17301516 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 |
|
...
To upload a script into the 17301516 Content field in the Script Details:
Step 1 | Click the 17301516 Upload Script button. The Script File Uploader pop-up displays. |
---|---|
Step 2 | Click the 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 17301516 Content field. |