Published Release Notes

Improved resiliency and observability of email infrastructure

Pega Platform now has several enhancements to improve the resiliency and observability of its email infrastructure. With the following enhancements, you can improve service quality and reduce maintenance costs:

• Pega Predictive Diagnostic Cloud alerts notify you of connection timeouts and help you troubleshoot more quickly.
• Default values for email settings ensure that your email configuration is optimal and follows best practices.
• Email listeners automatically retry test connectivity upon start-up if the connection fails or authentication fails.
• Improved logging provides meaningful messages and log categorization to support debugging.

For more information, see List of events and notifications in PDC.

Association of incoming emails with triage cases

Customer service representatives (CSRs) can now associate an email triage case with existing business cases or service requests. As a result, CSRs can respond more quickly to information about the same issue reported by customers several times. The system displays a list of related service cases for the same customer that CSRs can then associate or disassociate from the open email triage case in the Email Manager or Case Manager portal.

For more information, see Associating service requests with a triage case and Keep related incoming emails together for a triage case.

Secure email threading mechanism in email bots

Pega Email Bot™ now uses a secure built-in threading mechanism to ensure that all email communication between customer service representatives (CSRs), customers, and other stakeholders is secure and organized in separate threads for a triage case. For this purpose, the system embeds a unique encrypted security code in the body of outbound emails that identifies related triage cases, service requests, and forwarded emails.

For more information, see Understanding email triage process and Use a secure threading mechanism for emails.

Ability to handle responses to automatic email notifications in email bots

Pega Email Bot™ can now handle email responses to automatic email notifications that a Pega Platform™ application sends for a related case. As a result, customer service representatives (CSRs) can save time because all relevant emails from customers and other stakeholders are available from a single triage case in the system. To use this feature, ensure that you add the same email account to the email bot that you use to send case notifications in your application.

For more information, see Handle customer responses to automatic email notifications.

Update to Intelligent Virtual Assistant official names

To use better and more consistent names for conversational channels in Pega Platform™ and to help distinguish conversational channels from Pega Unified Messaging Edition™, Pega Intelligent Virtual Assistant™ (IVA) for Unified Messaging is now called IVA for Digital Messaging. Furthermore, the IVA for Web Chatbot is now officially called IVA for Legacy Webchat.

For more information, see Creating a Digital Messaging channel and Pega Intelligent Virtual Assistant features.

Ability to train the text analytics model based on email attachments

You can now train the text analytics model for Pega Email Bot™ based on training data from email attachments. As a result, you improve the natural language processing (NLP) analysis for your email bot so that your system detects the correct language, sentiment, topics, and entities from both the body of emails and their attachments. By default, you train the text analytics model based only on training data from the body of emails.

For more information, see Enabling training the model based on email attachments.

Deprecation of EAR deployments in Pega Platform 8.6

Starting with Pega Platform 8.6, EAR deployments of Pega Platform are deprecated. In the upcoming 8.7 release, EAR deployments will not be supported. The following rules that require EAR deployments will also be deprecated and no longer supported in Pega Platform 8.7:

• Connect EJB
• Connect JCA
• JCA Resource Adapter
• JMS MDB Listener
• Service EJB

With this deprecation, you can use the latest tools and keep your application up to date. 

Upgrade impact

In Pega Platform 8.6, you can still create rules that require EAR deployments and update existing rules. However, after an upgrade to Pega Platform 8.7, rules that require EAR deployments are no longer supported.

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

To prepare your application for this change well in advance of the Pega Platform 8.7 release, see the following table for a list of alternative rules and for guidance on modernizing your application.

For information on the supported platforms that are affected by this deprecation, see Pega Platform 8.6 Support Guide.

Upgrading to the secure threading mechanism for email bots

In Pega Platform™ version 8.6, Pega Email Bot™ includes a more secure threading mechanism to help track emails from customers and other stakeholders in separate threads for an email triage case.

Upgrade impact

If you upgrade from Pega Platform version 8.5 or earlier, in which you configured an Email channel, perform the following steps to ensure that your system uses the new secure threading mechanism:

• Update the service email rule that the system uses to send an email reply as the initial acknowledgment.
• Update the email reply template in the data transform rule that the system uses when a customer service representative (CSR) sends the reply.

For more information about creating an initial acknowledgment email and email reply template, see Creating outbound email templates. For more information about the secure threading mechanism, see Use a secure threading mechanism in emails.

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

For the initial acknowledgment email used by your email bot, update the service method for your email listener rule. On the Response tab for this service email rule, expand the Message contents section. In the Message data section, you specify the rule that defines the structure of the content of the email body. In Pega Platform version 8.6, you use for this purpose the pyEmailAcknowledgement correspondence rule that takes into account the selected built-in template. This template includes the security code tag that the system uses for the secure threading mechanism. If your application uses a different rule in the Message data section, update this definition to match one of the built-in correspondence template rules, for example, EmailAckTemplate_Clear.

The pySetEmailBotReplyTemplate data transform rule sets the name of the email correspondence rule that the system uses as the email reply template. If you do not want to use the default approach using the Classic, Cobalt, or Clear outbound email template themes, override this data transform rule to set the email correspondence rule name for the Param.ReplyTemplate target in the Source column field.

For more information about how to update the service email rule and the data transform rule to ensure that your system uses the secure threading mechanism, see Upgrading to the threading mechanism available in the 8.6 version.

Legacy Parse XML rule configurations must be upgraded to edit them

If your application has Parse XML rules that use the legacy configuration from Pega Platform™ 5.x, you cannot edit these rules after you upgrade to Pega Platform 8.6 until after you upgrade them to use tree-based parse rule configuration.

You must upgrade a Parse XML rule that you want to edit if it shows the following warning when you open it in Dev Studio.

This type of Parse XML rule is deprecated. An upgrade should be performed.

An option to upgrade also displays below the message.

Upgrade impact

Parse XML rules with the legacy configuration do not map data to the clipboard, and the rule definition is empty. After you upgrade to Pega Platform 8.6, you cannot edit Parse XML rules that you created in Pega Platform 5.x or earlier until you upgrade them to use tree-based parse rule configuration.

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

Update legacy Parse XML rules to use tree-based parse rule configuration before you edit them in Pega Platform 8.6. Using tree-based parse rules is considered a best practice.

1. Open the legacy Parse XML rule.
2. On the Mapping tab, click Upgrade.
   Result: The Allow tree editing? check box is displayed and is automatically selected. You can add attributes and elements to the tree structure, or delete them.
3. Save the upgraded rule configuration.

For more information, see Parse XML rules.

Connect MQ rules configured with alias queue do not work after upgrade

Connect MQ rules that you defined with an alias queue in earlier versions of Pega Platform do not work after an upgrade to Pega Platform 8.6.

Upgrade impact

If you defined an alias queue in Connect MQ rules, after an upgrade to Pega Platform 8.6, those Connect MQ rules do not work.

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

In the Pega-IntegrationEngine ruleset, create the following dynamic system settings and their default values:

• "mq/pmo" = 0
• "mq/gmo" = 0
• "mq/oo_request" = 1040
• "mq/oo_response" = 16

For more information, see Creating a dynamic system setting.