Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Updating from Pega Customer Decision Hub for Communications

Updated on December 16, 2021

+

This content applies to On-premises, Client-managed cloud and Pega Cloud environments

Starting from Pega Customer Decision Hub 8.6, the capabilities of Pega Customer Decision Hub for Communications (formerly known as Pega Marketing for Communications) merge with Pega Customer Decision Hub. To update from Pega Customer Decision Hub for Communications 8.5 or earlier to Pega Customer Decision Hub 8.7, in your application definition, you need to replace the communications application with Pega Customer Decision Hub application.

Your system might contain rules that are built on rules that are specific to the retired communications application. During the update, you must add the Pega Customer Decision Hub for Communications legacy component in order to add the retired rules to the Pega Customer Decision Hub application. The legacy component ensures that the updated system can resolve these rules correctly.

An example of a retired rule is the xCAR class rule NBAMCCustomerClass. This rule is not part of Pega Customer Decision Hub. New implementations of Pega Customer Decision Hub derive their xCAR class from industry-specific xCAR components or custom configurations.

Pega Customer Decision Hub Update Guide Pega Customer Decision Hub Update Guide
Before you begin:

  1. Ensure that Pega Cloud Services have updated your Pega Customer Decision Hub application to the current release.
  2. Download the following components from the Pega Marketplace:
  1. Log in to your implementation application with administrator credentials.
  2. In the header of Dev Studio, click the name of the application, and then click Definition.
  3. On the application tab, in the Built on applications section, remove PegaMarketingForCommunications, and then add PegaMarketing_FW with version 8.
  4. To seamlessly update your artifacts, you must install the Comms Legacy component for Pega Customer Decision Hub.
    1. In the Enabled components section, click Manage components, and then click Install new.
    2. Select the Comms Legacy component from your local system.
    3. Ensure that the Enabled check box is selected for the new component, and then click OK.
  5. If you use Pega Next-Best-Action Advisor, add the Pega Next-Best-Action Advisor connector for Customer Decision Hub:
    1. Click Manage components, and then click Install new.
    2. Select the Pega Next-Best-Action Advisor connector for Customer Decision Hub from your local system.
    3. Ensure that the Enabled check box is selected for the new component, and then click OK.
      The following figure shows the connector component and the Comms Legacy component added and enabled:
      Adding components
      Pega Exchange window with the new components added and enabled.
  6. Click Save.
  7. On the application tab, in the Enabled components section, ensure that the PegaCDH_NBAA_Integration component in on top of the application stack, as in the following figure:
    Built on applications and enabled components
    Built on applications and enabled components.
    Tip: You can modify the order by dragging and dropping the components.
  8. Click Save.
  9. If your application has rules that are dependent on the Pega Foundation for Communications application, update the application and apply the required hotfixes:
    Note: If you are updating from 8.4 or prior versions and if your rules are dependent on the Pega Foundation for Communications application, you must update the Pega Foundation for Communications application and then add it to your implementation application stack.
    1. Update to Pega Foundation for Communications 8.7.
    2. Apply the required hotfixes by using the Hotfix Manager.
      For more information, see Hotfix management.
    3. In the header of Dev Studio, click the name of the application, and then click Definition.
    4. In the Built on applications section, click Add application.
    5. In the Name field, enter the name of your Pega Foundation for Communications application.
    6. In the Version field, enter the version number of your Pega Foundation for Communications application.
    7. Click Save.
  10. Re-save your Next-Best-Action Designer Channels configuration.
    1. In the Pega Customer Decision Hub portal, click Next-Best-ActionDesignerChannels.
    2. Click Edit, and then click Save.
  11. If you created any supporting decisions before the update, re-save them so that the new properties are updated in data flows.
    1. In the Pega Customer Decision Hub portal, click Next-Best-ActionSupporting Decisions.
    2. Open and re-save each supporting decision that you created before the update.

Optional: Updating the Legacy component

If your application stack contains the Pega Next-Best-Action Advisor connector for Customer Decision Hub 8.6 component, updating the component is not required. However, if you wish to use the latest features available in the components, you must install and configure the Legacy 8.6 Next-Best-Action Component for Pega Customer Decision Hub.

  1. Download the Legacy 8.6 Next-Best-Action Component for Pega Customer Decision Hub from the Pega Marketplace.
  2. Log in to your implementation application with administrator credentials.
  3. In the header of Dev Studio, click the name of the application, and then click Definition.
  4. In the Enabled components section, delete the Pega Next-Best-Action Advisor connector for Customer Decision Hub 8.6 component.
  5. In the Enabled components section, add the Legacy 8.6 Next-Best-Action component:
    1. Click Manage components, and then click Install new.
    2. Select the Legacy 8.6 Next-Best-Action component for Pega Customer Decision Hub from your local system.
    3. Ensure that the Enabled check box is selected for the new component, and then click OK.
  6. Click Save.
  7. In the Enabled components section, add the Pega Next-Best-Action Advisor connector for Customer Decision Hub 8.7:
    1. Click Manage components, and then click Install new.
    2. Select the Pega Next-Best-Action Advisor connector for Customer Decision Hub 8.7 from your local system.
    3. Ensure that the Enabled check box is selected for the new component, and then click OK.
  8. On the application tab, in the Enabled components section, ensure that the PegaCDH_NBAA_Integration component is on top of the application stack.
  9. Click Save.
  10. Re-save your Next-Best-Action Designer Channels configuration.
    1. In the Pega Customer Decision Hub portal, click Next-Best-ActionDesignerChannels.
    2. Click Edit, and then click Save.
  11. If you created any supporting decisions before the update, re-save them so that the new properties are updated in data flows.
    1. In the Pega Customer Decision Hub portal, click Next-Best-ActionSupporting Decisions.
    2. Open and re-save each supporting decision that you created before the update.
What to do next:
Note: In previous versions of Pega Customer Decision Hub for Communications, strategies used monthly internal and one-time internal costs to determine the investment value. Since version 8.7, the strategy uses the Internal cost and Customer cost as defined in the financial details of the action. Ensure that these values are set appropriately.
    • Previous topic Restarting the application server
    • Next topic Updating from Pega Customer Decision Hub for Financial Services

    Have a question? Get answers now.

    Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

    Did you find this content helpful?

    Want to help us improve this content?

    We'd prefer it if you saw us at our best.

    Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

    Close Deprecation Notice
    Contact us