Published Release Notes

Automatic draft off mode for processes in case types

App Studio now supports automatically turning off the draft mode for processes in your case types. Any process that you add to a case type is in draft mode by default so that you can run the case type to check the run-time behavior even if the process contains errors. However, in a production environment, processes in draft mode do not work. To save time and deliver your projects faster, any process that has no errors now automatically switches off draft mode when you save the case type. Additionally, Case Designer now displays a list of errors that processes in your case type include, so that you can quickly locate any issues.

For more information, see Save time and effort with automatic draft off mode for processes in case types (8.5), Draft mode of case processes.

Enhancements for fields in views and data models

Pega Platform™ now provides a unified experience of adding fields to views, the case type data model, and the application data model, by using an intuitive dialog box. For greater clarity, a new field type, data relationship, replaces data references, field groups, and field group lists. As a result, you can conveniently reuse data objects in your application. 

When you upgrade to Pega 8.5, your system automatically converts your field groups, field group lists, and data references to data relationships. The case type data model now displays all the fields by default, including any referenced fields, and provides an application layer that contains each field. Use this functionality to view how the data is organized across your system.

For more information, see Define fields in data objects intuitively (8.5), Adding data relationships to fields and data models.

Support for nested Declare Trigger rules

Pega Platform™ now supports nested Declare Trigger rules so that you can conveniently create correlations between actions in your case types. Declare Triggers rules invoke an action when a specified event takes place in a case type. You can now design more complex scenarios faster by nesting more Declare Trigger rules that work in the context of running another Declare Trigger rule. For example, when a case participant changes a postal code in their personal details, a Declare Trigger rule runs and a respective customer service representative (CSR) receives an email. After the CSR receives the email, a nested Declare Trigger rule runs and your application creates a document with the updated personal details and attaches it to the case.

For more information, see Develop applications faster with nested Declare Trigger rules (8.5), Declare Trigger rules.

Support for validations in Declare Expression rules

Pega Platform™ now correctly evaluates validations on target properties in Declare Expression rules. As a result, any validations defined on properties that have Declare Expression rules in previous releases, now work correctly. 

Upgrade impact

Any unintended validations on properties that have configured Declare Expression rules, both default and user-defined, might cause issues in an application upon saving work objects and data objects that refer to Declare Expression rules.

What steps are required to update the application to be compatible with this change? 

If you experience issues when saving objects, debug your application by setting the declareexp/target/validation/disable dynamic system setting to true. If your application works correctly after the change, it means that validations on Declare Expressions cause the issues. For your application to work correctly, analyze the log files and remove any unintended validations.

For more information, see Declare Expression rules.

Close button on a pop-up application update removed from App Studio

When you open an existing application that you created in previous releases without support for the Pega Express methodology, App Studio now displays a pop-up window to support Microjourneys™ without a Close button, to improve the usability of App Studio. 

Upgrade impact

The UI automation script might require a change if the script mentions clicking on the Close button.

What steps are required to update the application to be compatible with this change?

If you have a UI automation script that uses the Close button, update the UI automation script to delete reference to clicking on the Close button.

For more information, see Creating a Microjourney for customer success.

App Studio enhancements further support Pega Express methodology

App Studio now includes improvements that you can use to plan your Microjourney™ in a more convenient way. The Overview workspace now includes a button to edit application details, such as name, description, and business objectives, without having to switch to Dev Studio. You can also access relevant information faster, because Case Designer displays additional details about channels, data objects, and attachments associated with a case type directly in a properties pane. For improved management of your features, feature categories are now available in the application inventory so that you can clearly communicate to your development team what type of features need implementation.

For more information, see:

• Editing application details in App Studio 
• Associating personas with channels 
• Adding features to application inventory 
• Creating a Microjourney for customer success

Enhanced mapping of personas and users in App Studio

App Studio now provides a consistent and transparent experience when mapping personas to users. When you invite users to your application, you can associate each user with a run-time persona or developer role by selecting an option from a clearly organized list. For example, you can associate run-time users with a customer service representative persona, and then invite a person to help develop your application and assig them a developer role. For greater clarity, personas now replace references to roles in App Studio.

For more information, see Inviting collaborators to your application.

Tracer support for Cosmos React

The Tracer tool is now available for stateless applications, so that you can trace and debug applications that you build on Cosmos React. Because in a stateless application multiple requests can run simultaneously, to provide clarity, Tracer shows the events by request ID instead of grouping the events by the time of occurrence. For greater convenience, debugging Cosmos React applications is also available in an offline Tracer tool. As a result, you speed up the development process and deliver top-quality applications that are free of bugs.

For more information, see:

• Debug your Cosmos React applications faster with Tracer (8.6)
• Application debugging by using the Tracer tool
• Pega Digital Experience (DX) API
• Cosmos React

Upgraded selected third-party JAR files to support Pega Platform functionalities

Pega Platform™ 8.6 now provides upgraded versions of the JAR files that support various functionalities within the Platform, such as generating documents or PPTX files.

Upgrade impact

If you have custom implementations and use any classes from the upgraded JAR files directly in your code or through JAR APIs, after your upgrade to Pega Platform 8.6, your application might experience unexpected run-time behavior if the upgraded JAR version lacks any elements from the previous version. For example, custom implementations can typically include activities, functions, or non-autogenerated sections. Unexpected run-time behavior might also occur when you use a third-party library that has dependencies on the upgraded JAR files. If you use only default Pega Platform functionalities without any customizations, the JAR files continue to work correctly without any additional actions.

What steps are required to update the application to be compatible with this change?

If you have any JAR customizations, ensure that you test the upgraded JAR files for compatibility and upgrade impact. The following table lists the upgraded JAR files that might impact your application:

For more information, refer to the documentation of  your JAR provider.

Default value of the threadpoolsize agent affects batch indexing

After you patch Pega Platform to version 8.5.2 or higher, the system changes the default value of the threadpoolsize agent, which controls the number of concurrent activities (threads) in the system, from 5 to 15. Batch indexing in Pega Platform™ does not require all 15 threads, so you can change the agent value to increase system performance by managing the indexing/distributed/batch/numworkers dynamic system setting.
If your deployment does not support that setting, and batch indexing does not use Queue Processors, the system uses the threadpoolsize value for batch indexing instead.

For more information, see Editing a dynamic system setting.