Skip to main content

 –

Migrating existing mashups

Suggest edit Updated on September 29, 2021

To ensure that updates to Pega Platform 8.5.1 and later work seamlessly, you must migrate your existing mashups. Beginning in Pega Platform 8.5.1, Pega Web Mashups include a channel ID in the mashup code for validation with your mashup server.

Before you update your production environment, migrate existing mashups by completing the following steps:
  1. Create the mashup channel and mashup script on the updated, cloned staging environment, with the URL pointing to the production environment. Ensure that the mashup code contains a data-pega-channelID value. For more information, see Creating a mashup.
  2. Update the appropriate external websites that host the mashup with the generated mashup scripts that you generated.
  3. If you need to maintain full availability of the mashup during the update of the production environment, on the updated, cloned staging environment, create a product rule that contains the mashup channel to deploy to production. For more information, see Creating a product rule that includes associated data by using the Create menu.
    Skipping this step will result in the mashup being inaccessible for a short period of time during the update.
    1. On the Product page, in the Individual instances section, in the Select a class and press Query field, pressing the Down arrow key and select Data-Channel-Mashup.
    2. In the Individual Instances To Include dialog box, select the mashup channels to include in the product rule, and then click Submit.
    3. Save the product rule.
    4. Use an ad hoc task to deploy the product rule to production. For more information, see Performing ad hoc tasks.
  4. Add the mashup channel to the product rule that contains your update fixes. For more information, see Editing a product rule.
    1. On the Product page, in the Individual instances section, in the Select a class and press Query field, pressing the Down arrow key and select Data-Channel-Mashup.
    2. In the Individual Instances To Include dialog box, select the mashup channels to include in the product rule, and then click Submit.
    3. Save the product rule.
Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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