Need Technical Assistance for Apryse WebViewer Integration in Pega

Hi Team,

I am working on Apryse WebViewer integration with Pega.

I have created a custom React component using Apryse WebViewer with the aim of editing Word documents directly within the Pega UI.

Currently:

  • The component is working successfully in local React environment

  • It is also working correctly in Storybook

  • However, after publishing and integrating the component into Pega, the WebViewer fails to load/work properly

I have already:

  • Installed the @pdftron/webviewer package

  • Copied the required WebViewer static assets

  • Configured the WebViewer path inside the component

But the issue occurs specifically within the Pega environment.

Could you please help me understand:

  • Whether there are any known limitations with Pega integration

  • Recommended deployment approach for WebViewer assets in enterprise applications

  • Any required CSP or static asset configurations

  • Best practices for integrating DOCX editing within embedded enterprise platforms like Pega

Your guidance would be greatly appreciated.

Thank you,
Ranjith

Hi there,

There are eplicitly known limitations for Pega integration. If issues occur, I recommend taking a look at the browser console for any error messages and the network panel for any failed requests.

Here are some common suggestions and fixes you should watch for:

  1. Confirm the WebViewer assets are correctly hosted and accessible. You can confirm this by checking the network panel for any failed requests for the WebViewer resources.
  2. CSP & Static assets. Make sure the CSP allows script-src and style-src. Check our CSP guide for more details: Using a Content Security Policy (CSP) with WebViewer | Apryse documentation
  3. Confirm you do not have anything else blocking the requests (such as extensions, browser security, etc)
  4. Ensure you are on the latest version of WebViewer (currently 11.12.0).
  5. If you are having specific issues regarding DOCX loading, try testing it with a PDF as well.

Best regards,
Kevin