Release Notes

Release Notes

Universal Controller release 6.6.0.0 contains the following high-level features.

For a complete list of all the included features and fixes, please refer to the Universal Controller 6.6.x Maintenance list.

Bundle and Promote Security

Backlog	Title	Description
B-09939	Business Services Security and Visibility for Bundles	In order to allow more granular administration bundles can now be assigned to business services and a new user / group permission type for "Bundle" has been added to control how users can interact with Bundles. The existing "ops_bundle_admin" remains to provide global access to the bundle feature.
B-09938	Business Services Security and Visibility for Promotion Targets	In order to allow more granular administration promotion targets can now be assigned to business services and a new user / group permission type for "Promotion Target" has been added to control how users can interact with promotion targets. The existing "ops_promotion_admin" remains to provide global access to the promotion targets.
B-10286	Optionally, allow bundle-less promotion for users without ops_promotion_admin role.	To augment the features delivered in B-09938 and B-09939, a new system property - Bundleless Promotion With Execute Permission Permitted - has been added to optionally allow promotion of definitions outside of a bundle without requiring the ops_promotion_admin role. By default this property is "false", meaning that the Promote… action is disabled unless a user has the ops_promotion_admin role. For a user with the ops_promotion_admin role, the Promote… dialog allows selection of any pre-existing promotion target. When the property is set to "true", the Promote... action will be available to users who have "execute"permission to at least one promotion target. Again, for a user with the ops_promotion_admin role, the Promote… dialog allows selection of any pre-existing promotion target.

Calendar and Trigger Enhancements

Backlog	Title	Description
B-06728	Calculate Observed Public Holidays	This provides the ability to support "observed" public holidays without the need for a custom day list of dates. For example if July 4th falls on a Saturday the observed July 4th would be Friday July 3rd and if July 4th falls on a Sunday the observed July 4th would be Monday July 5th.
B-09506	Time Trigger expanded to include "Week" as a Complex Qualifier.	For Example "Run on 1st Business Day of week"
B-03218	Run Criteria expanded to include "Week" as a Complex Qualifier	For Example "Skip on 1st Business Day of Week"
B-07357	Custom Days (Relative Repeating Date) Add “Last Day” & “Last Business Day” to the When Clause	For Example "Run 2 Business Days before the Last Day of the Month"
B-04047	Automatic purging of old Custom Day dates from Date List	A new System Property has been added to allow customers to automatically purge old dates in a Custom Day of type Date List. If the System Property “Purge Dates From Custom Day List Older Than” is set, then after midnight when the log is rolled over, part of the post log rollover will now purge any dates out of Custom Day (Date List) that are older than the number of days set as the System Property value. For example, if the System Property is set to 7, then any dates older than 7 days will be automatically removed from Date List – Custom Days.
B-07148	Add Nth and Nth Amount to Time Trigger Restrictions - Complex Restriction - Adjective In the Restrictions section of the Time Trigger Definition you could previously specify 1st, 2nd, 3rd, 4th, First and Last. Support has been added for Nth and Nth amount. For example, this will enable restrictions for 10th Day of Month.
B-09498	New System Property to Control the Minimum Frequency in Seconds for a Time Interval on a Time Trigger	New System Property "Time Trigger Minimum Frequency in Seconds". This allows customers to restrict the creation of new Time Triggers with a time Interval less that the value specified in this property.

File Monitor Task Enhancements

Backlog	Title	Description
B-03621	Be able to specify a minimum file size for Monitor Type = Create	When monitoring for new files with the File Monitor Task you can now optionally also specify "Minimum File Size" and the "Minimum File Scale" (i.e.Bytes, KB, or MB) as an additional filter criteria. This means that when a new file matching the "Monitor Files" criteria is found, the File Monitor will wait until the file also meets the Minimum File Size" specification is met.

New Output Functions and Out Retrieval Enhancements

Backlog	Title	Description
B-03412	Add function to retrieve predecessor task output by specific line.	Two new functions have been added to allow access to specific lines from a task's output. As with the existing task output functions you will need to both Retrieve the output automatically and check the Wait for Output option to ensure that the task's output is available for processing. These functions can be used in task set variable actions to allow access to specific lines from the output of a task.

${_outputLines('outputType', startLine, numberOfLines[, 'defaultValue', 'resultDelimiter'])} or for sibling tasks ${_outputLinesFromTask('siblingName', 'outputType', startLine, numberOfLines[, 'defaultValue', 'resultDelimiter'])}

For Example STDOUT Contains:

License_Product INDESCA
License_Customer STONEBRANCH
License_OS_Type UNIX
License_Type DEMO
License_Expiration_Date 2020.04.30 YYYY.MM.DD
License_NT_Servers 10000
License_UNIX_Servers 10000
License_OS400_Servers 10000
License_OS390_Servers 10000
License_OS390_Unix_Servers 10000
License_Key B1E9-AABD-E59A-8079-30BF-3B17-2E67-8D21

A set Variable Action For Status Success uses the new function:

And the Global Variable is set as follows:

${_outputLinesByRegex('outputType', 'regexPattern'[, maxCount, numberOfLinesBefore, numberOfLinesAfter, 'defaultValue', 'resultDelimiter'])} or for sibling tasks ${_outputLinesByRegexFromTask('siblingName', 'outputType', 'regexPattern'[, maxCount, numberOfLinesBefore, numberOfLinesAfter, 'defaultValue', 'resultDelimiter'])}

For Example STDOUT Contains:

License_Product INDESCA
License_Customer STONEBRANCH
License_OS_Type UNIX
License_Type DEMO
License_Expiration_Date 2020.04.30 YYYY.MM.DD
License_NT_Servers 10000
License_UNIX_Servers 10000
License_OS400_Servers 10000
License_OS390_Servers 10000
License_OS390_Unix_Servers 10000
License_Key B1E9-AABD-E59A-8079-30BF-3B17-2E67-8D21

A set Variable Action For Status Success uses the new function:

And the Global Variable is set as follows:

B-05005 Automatic output retrieval only on task failure

This enhancement introduces a new check box "Failure Only" for task types that support automatic output retrieval. If the Failure Only option is checked the automatic output retrieval will only occur if the task status is FAILED (or transitions through a FAILED status).

On Delete Validation for Credentials

Backlog	Title	Description

B-09385 Add on-delete validation for credentials Deleting a Credential is now prohibited if any references exist for the Credential.

Results Set Processing (Change in Default Behavior)

Backlog	Title	Description

B-09427 Add support for decimals to Task "Result Set Processing" comparison operators (>, >=, <, <=).

For the greater than (>), greater than or equal (>=), less than (<), and less than or equal (<=) operators, the Universal Controller, by default, will now attempt to parse the String values as floating point values, rather than integer values, allowing proper numerical comparison when the values being compared are both floating point values, or a combination of integer and floating point values.

While this is a behavior change from previous releases, we believe this would be the expected behavior and have made it the default.

The following functionality in the Universal Controller relies on this functionality and should be regression tested. The regression testing should not be limited to the above operators, but all supported operators for the specific feature being regression tested.

Email Monitor Task Instance > Content Processing
SQL Task Instance > Result Processing
Stored Procedure Task Instance > Result Processing
Variable Monitor Instance > Value Condition
Web Service Task Instance > Response Processing
Run Criteria > Variable

Server Operations

Backlog	Title	Description

B-10115

List/Download Opswise log files via the Client GUI

New Server Operation that lists the available "opswise log" files for the current cluster node and allows the user to select one or more logs for download to their local machine for viewing.

UI Changes

Backlog	Title	Description

B-10224 Relabeling of the Shorted Estimated End Time, and Longest Estimated End Time, for consistency. In the Task Instance the computed estimated end times were previously displayed as Shortest Estimated End Time, and Longest Estimated End Time. For consistency with the Task Definition these have been relabeled to Lowest Estimated End Time and Highest Estimated End Time.

Universal Task Enhancements

Backlog	Title	Description

B-08870 Array Field Support

New Universal Template Field Type to support input of name value pairs in Universal Tasks. Also includes the following new functions:

_convertArrayFieldFieldVariable Provides formating options for the array string.

_getArrayFieldVariableValue Returns the value from a specific name.

Variables

Backlog	Title	Description

B-05636 Increase supported variable value length from 1024 to 4000. The maximum size for a variable value can now be specified up to 4000 characters in length.
B-10166 New Task Instance Variables for Task Statistics

We have introduced four new built-in variables for a task instance, specifically, ops_user_estimated_end_time, ops_avg_estimated_end_time, ops_highest_estimated_end_time, and ops_lowest_estimated_end_time, which resolve to the task instance User Estimated End Time, Average Estimated End Time, Highest Estimated End Time, and Lowest Estimated End Time, respectively, in the server's time zone.

For example,

$

Unknown macro: {ops_user_estimated_end_time}

> 2018-10-16 15:01:54 -0400
$

Unknown macro: {ops_avg_estimated_end_time}

> 2018-10-16 15:01:45 -0400
$

Unknown macro: {ops_highest_estimated_end_time}

> 2018-10-16 15:01:45 -0400
$

Unknown macro: {ops_lowest_estimated_end_time}

> 2018-10-16 15:01:44 -0400

If the date/time value for any of the above is NULL, the variable will remain unresolved, consistent with other date/time built-in variables.

You can use the ${_resolve(...)} function to force resolution, for example.

${_resolve("ops_user_estimated_end_time", "")}
${_resolve("ops_avg_estimated_end_time", "")}
${_resolve("ops_highest_estimated_end_time", "")}
${_resolve("ops_lowest_estimated_end_time", "")}

Virtual Resource Enhancements

Backlog	Title	Description

B-09853 Virtual resource order processing optimizations

A number of optimizations have been implemented to improve the performance for Virtual Resource Processing where tasks are associated with large numbers of Virtual Resources:

Creation of virtual resource events consolidated into VirtualResourceEvent helper methods for easier maintainability and better visibility.
Additional logging for debugging purposes.
Number of queries invoked by order check event handling reduced.
Queuing enhanced to allow avoiding duplicate events to be added, specifically, the virtual resource order check events, allowing a single check to be executed for multiple order requests and return events.
De-coupling of order request event processing thread(s) from other virtual resource event handling to allow for improved order creation throughput.
Dispatching of Resource Wait event immediately in order check event handling rather than after event completion.

Web Service API Enhancements

Backlog	Title	Description

B-10167 Support 'inheritance' property for Actions in the Create Workflow RESTful API request Supports creation of Workflows with Workflow Level Actions via the Web Service Create Workflow API
B-09857 List Task Instance Variables (Show Variables) New Web Service RESTful API to return task instance variables. Provides API access to the "Show Variables" feature in the user interface.
B-09771 Delete Scheduled Bundle Promotion New Web Service RESTful API to delete a currently scheduled bundle promotion.
B-10124 Cancel Scheduled Bundle Promotion New Web Service RESTful API to cancel a currently scheduled bundle promotion.
B-08515 API CRUD & List for Universal Task Templates New Web Service RESTful API to Create, Read, Update, Delete, and List Universal Task Templates.

Universal Controller 6.6.0.0 Release Notes