Third Quarter of 2019

Family Policies

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: September 27, 2019

Table 1. Enhancements and New Features

The following enhancements and new features have been added.

DescriptionTracking ID
You can now use a reserved parsing keyword, such as the name of a function or a mathematical constant, as an input variable name in a Math node.US359538
When you update the execution schedule of a policy other than in the Details workspace, the Policy Trigger Job is now configured according to the updated schedule.US339892
You can now validate and execute a policy that contains a Collection Filter node with an empty collection. However, a warning message appears in the Node Execution Details window for the node, indicating that the collection is empty.US334152
To enhance the usability of the model canvas in the Design workspace, the following enhancements have been made:
  • You can now use a grid to accurately align the nodes with the other nodes in the model canvas. To facilitate this enhancement, the Enable Grid button () has been added to the canvas.
  • You no longer need to select specific connection points on nodes. To facilitate this enhancement, the button now appears when you select a node.
  • You can now bend a connector between nodes.
  • The button now appears when you point to a connector. This button enables you to define the logic path of the connector.
  • You can now select a point on the model canvas and then drag the pointer to select all nodes and connectors within a rectangular region.
  • US330552
  • US284834
  • US237250
You can now create a recurring alert using the Create Alert node.US328484
To improve the performance of policy execution, a node whose output is not used by any node of the policy model is no longer executed during the execution of the policy. This enhancement has been made to the following nodes:
  • Math
  • Query
  • Query Alerts
  • Predix Time Series
US327421
In the Properties window for a node, when you specify a family ID, the name of the family associated with the family ID is now added to the default name of the node. However, if you modify the default name of the node before specifying the family ID, the modified name of the node is not updated with the name of the family. This enhancement has been made to ensure consistent behavior of the following nodes:US325425
You can now download the image of a policy model to your local drive. To facilitate this enhancement, the Download button () has been added to the model canvas in the Design workspace.US325413
To enhance the usability of the Design workspace, the following enhancements have been made:
  • The Policy section has been removed from the toolbar.
  • The Save button now contains the text Save instead of the icon.
US321474
You can now refresh the metadata used by a policy and its nodes without refreshing the policy. To facilitate this enhancement, the Refresh Policy Metadata button () has been added to the following elements of the Design workspace:
  • The Edit section of the toolbar.
  • The Properties window for the nodes that use external metadata.
US315588
You can now retrieve the latest readings for a given time period in a Predix Time Series node. To facilitate this enhancement, the Start Time input has been made optional.US246548
You can now revert the transaction that triggers a family policy. To facilitate this enhancement, the Cancel Transaction node has been added to the Actions section of the toolbar in the Design workspace.US236247
Table 2. Resolved Issues

The following issues, which existed in one or more previous versions, have been resolved.

DescriptionTracking ID
Previously, in the Validation section, if you copied the null value of an instance to use it as an ad hoc test value for validation, the validation results of the policy were incorrect. This issue has been resolved.US306739
Previously, when you added the Create Alert node to a policy, only 20 values were displayed in the Alert Name drop-down list box even if more than 20 Alert Templates were defined in Predix Essentials. In addition, if you selected an Alert Name, saved the policy, and then added additional Alert Templates, when you reloaded the policy, the Alert Name setting may have been lost. These issues have been resolved. Now, up to 1000 Alert Names can be displayed.
Note: The capability to display unlimited Alert Names will be enabled in a future release.
DE117905
Previously, if you configured a Query Alerts node to retrieve alerts for a Functional Location representing a Site, Segment, or Enterprise, no alerts were returned. Also, if you configured a Create Alert node to create an alert for a Functional Location representing a Site, Segment, or Enterprise, no alert was created. These issues have been resolved.DE117298
Previously, the Query Alert node retrieved a maximum of 100 alerts regardless of the number available within the requested time range, and there was no indication that the result was truncated. This issue has been resolved. Now, the Query Alert node retrieves up to 1,000 alerts, and if the result is truncated, a notification appears in the execution history details.DE117288
Previously, if you configured the Policy input of a Sub Policy node, then copied and pasted the node, the copy of the Sub Policy node did not display the input fields for the specified Policy. This issue has been resolved.DE116740
Previously, if you attempted to access a policy containing an Entity, Create Entity, or Edit Entity node referencing an entity family that did not exist in Predix Essentials, the policy failed to load. This issue has been resolved.DE113400
Previously, if you entered a value in the Value section of a Text node that could be interpreted as a date or time span (for example, Sunday or 30d), the value was converted to the standard display format for a date or time span prior to being inserted into the Text Pattern. This issue has been resolved. Now, the Text node treats these values as strings.
Note: This change may affect the behavior of the pre-existing policies. Before you upgrade, you must review the policy designs to ensure that the Text node is configured so that the date and time and the time span values are mapped from the Constant node.
DE113062
Previously, if a sub policy contained multiple Return Value nodes with the same name, when you mapped the results from the sub policy to a successor node, the successor node input value list displayed the Return Value name multiple times, even though a single value was returned from the sub policy. This issue has been resolved. Now, the Return Value name is displayed only once in the input value list.DE113041
Previously, if you specified an input value in a Constant node that could be interpreted as a date or a time span (for example, today or 700D) and specified string as the data type for the node, the input value was converted to a date or time span. This issue has been resolved.
Note: This change may affect the behavior of the pre-existing policies. Before you upgrade, you must review the policy designs to ensure that the correct data type is specified in all the Constant nodes.
DE112424
Previously, in the Properties window for an Edit Entity node, in the Auto-map field values section, if you selected Yes, the Entity Key Column box was enabled as a required field. This issue has been resolved. Now, in this scenario, the Entity Key Column box is enabled as an optional field, and a warning message appears in the notification bar, indicating that you have not specified any value in the Entity Key Column box.DE107430
Table 3. Known Issues

The following issues are unresolved in this release.

DescriptionTracking ID
When you export a policy from Predix Essentials V4.3.1.0.0, and then access the exported policy in an older version of Predix Essentials, the connectors in the policy model do not appear even though you can successfully validate and execute the policy. The workaround for this is to manually redraw the connectors between the nodes before making any modifications to the policy.DE116734
Table 4. Obsolete Features

As of this release, the following items are no longer available.

DescriptionTracking ID
The Close Event node has been removed from Family Policies.
Note: The functionality of the Close Event node depends on the Policy Events associated with a policy instance. As family policies do not contain any policy instances, the Close Event node did not function as expected.
DE114843