Configuring the Mashup channel

You can configure the Mashup channel in your application to embed Pega Platform content in an external application, for example, to create new work for a case type or to display a harness. Mashup code is generated as HTML that you can cut, paste, and view within a page or view of an external application.

You can also quickly test how the generated mashup code looks in a test demo mobile app. To view your mashup, you must download the Pega Mashup Preview mobile app from the Apple App Store or Google Play, and scan a QR code by using the app.

  1. In Designer Studio, click the name of your application, and then click Channels and interfaces.
  2. In the Create new channel interface section, click Mashup.
  3. In the Mashup name field, enter a name for the Mashup channel interface.
  4. Optional: To distinguish this channel interface from other channel interfaces that use the Mashup channel, enter short text in the Description field that describes the purpose of the channel interface.
  5. In the Mashup URL field, enter the URL for a Pega Platform instance, for example: http://sample.pega.com:8080/prweb/
  6. In the Action list, click a Pega Platform action, for example: Create new work.
    Depending on the selected action, you might have to specify additional information. For example, for the Create new work action, you must specify the case type.
  7. Optional: To test your cases for the Pega Platform application in a demo mashup mobile app:
    1. Click Try Mobile Mashup.
    2. Download and install the Pega Mashup Preview mobile app from the Apple App Store or Google Play.
    3. Open the mobile app and scan the displayed QR code.
      You can also enter the URL for the Pega Platform application from step 5 and the credentials manually.
    4. Click Mashups tab.
    5. Click the case name that you specified in step 6 to verify that you can create new work, and check the branding for the app.
  8. Click Generate.
  9. Copy the generated HTML code from the Mashup code text area, for example, click Copy to clipboard.
    You can then paste the HTML into a web page or a view of an external application.
  10. Click Save.