Universal Controller 6.4.1.0 Release Notes
Web Services Tasks
A new task type for Web Services has been introduced to provide support for HTTP(S)/REST and SOAP web service calls. XML and JSON input can be specified in the Web Service Task Details or referenced as a new script library object type, Web Service Payload. New functions are provided to allow access to Web Service results using XML path and JSON Path queries.
Script Data Functionality
A new script library object type, Data, has been introduced to allow script library objects to be referenced as data files by commands and from within Scripts and Universal Tasks. For example, this new feature allows powershell scripts to be stored in the Universal Controller database and used as input to Windows tasks executing the powershell command. A new _scriptPath
function is used to reference the script data object within the desired command, script, or Universal Task.
Assuming that a Script Data object called myscript.ps1
is created and contains a valid powershell script it then can be executed in a windows task command as follows:
powershell -F "${_scriptPath('myscript.ps1')}"
In this case, the myscript.ps1
script object is copied to the file system on the agent server and referenced as an input file to the command that is executed on the agent server.
Note
_scriptPath
requires Agent 6.4.0.0 or later.
User Administration Function
Users with the ops.admin role can view logged on users, send messages to logged on users, and manually expire their sessions.
Automation / Workflow Control Enhancements
New System Operation Task Actions have been provided to support Launch, Trigger, and Re-run. This significantly extends the automation possibilities from the Task Actions feature.
Users are now able to initiate a manual re-run for tasks that are awaiting an automatic retry.
Users can now insert a sub-workflow into an active workflow instance.
Calendar Updates
Custom Day definitions with relative repeating dates now support less and plus offsets. This makes certain types of special days easier to define, for example Black Friday = 4th Thursday in November plus one day.
Bulk Export Enhancements
New Server Operations have been added to support bulk export of History, Audit, and Activity records. These exports are of course supported for bulk import.
Backup and Purge Enhancements
A new option, Purge by Retention Duration, is available for Trigger definitions. If Purge By Retention Duration has been specified for a trigger, and the Purge By Retention Duration checkbox has been selected in the Data Backup / Purge Details, all task instances launched by the trigger are eligible to be purged from the database as soon as the retention duration time specified in the trigger has been met.
This allows a more aggressive purge strategy to be implemented for tasks that are frequently triggered.
New User Password Encryption
Following previous improvements for credential passwords stored in the Universal Controller database delivered in 6.4.0.0, improved password hashing and salting using SHA-256 has been delivered for any user passwords stored in the Universal Controller database. Note that this does not impact passwords that are checked against an LDAP / AD database, as these are not stored in the Universal Controller database. Also note that the new password hashing will only be implemented when an existing users change their password. The user mass update functions can be used to set the Password Requires Reset flag to force users to set a new password.
Listing Agent Referenced Tasks
A new tab in the Agent details, Tasks, is provided to give visibility to all tasks that reference a specific agent.
File Transfer Task Updates
In conjunction with the new UFTP (Universal Agent FTP Client), updates have been made to the File Transfer Task in order to support additional protocols (for example, FTP) and new functionality (for example, Move).
API Enhancements
The RESTful Web Services API of the Universal Controller was extended with additional functionality:
Reports |
Run Report Definition and Return Output |
Groups |
Create / Modify / Delete / Read / List |
Users |
Create / Modify / Delete / Read / List |
Trigger Now |
Response SYSID in its own XML TAG |
Task Instance |
List Task Instance by Specific SYSID |
Agent Clusters |
Create / Modify / Delete / Read / List |
System |
Get System Status Information |
Agents |
Add agent suspended status to List Results |
Agents |
Read / Update Agent Properties |
OMS Servers |
Create / Modify / Delete / Read / List |
Credentials |
Create / Modify / Delete / Read / List |
Scripts |
Create / Modify / Delete / Read / List |