Skip to main content


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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Implementing Snowbound VirtualViewer 5.3 on Pega Platform

Updated on September 10, 2021

Use Snowbound VirtualViewer to preview case and Pulse attachments and document case types, from portals and in Pulse comments inline without first downloading the attachments. For more information, see Snowbound VirtualViewer.

To install VirtualViewer on any production system, follow these steps:

Before you begin: Ensure that your application server meets the Snowbound system requirements for a compliant servlet container. For more information, see the Snowbound documentation and the Pega Platform Support Guide for a complete list of supported platforms.
  1. Obtain a SnowboundLicence.jar license file for VirtualViewer from Snowbound.
  2. On Marketplace, download the VirtualViewer_#.zip file that contains the VirtualViewer.jar file and the VirtualViewer.war file.
  3. Extract the VirtualViewer_#.zip file onto a shared location to which both Pega Platform and any external validation engines have access.
  4. Deploy the VirtualViewer.war file. For more information, see your application server documentation.
  5. Copy the license file from step 2 into the virtualviewer/WEB-INF/lib directory.
  6. Optional: Customize the default log location in the WEB-INF/classes/logging.properties file:
    1. Open the logging.properties file.
    2. Edit the log file line to update the default log file location. For example:
      java.util.logging.FileHandler.pattern =../logs/pegaLogs/virtualviewerlog.log
    3. Save and close the logging.properties file.
  7. Optional: If logging to a specific file is not required, delete the logging.properties from following location WEB-INF/classes/.
  8. Configure email attachment features:
    • If you do not need to send attachments as email messages, hide the Configure Email Documents button on the VirtualViewer tool bar:
      1. Open the virtualviewer/user-config/toolbar-config.js file.
      2. Comment out the entry for //vvEmailDocument.
      3. Save and close the file.
    • If you need to send attachments as email messages from VirtualViewer, configure the default email sender address:
      1. Open the virtualviewer/user-config/toolbar-config.js file.
      2. Enter the email address in the following format:
        emailDefaults: {
        prepopulateFrom: "[email protected]", 
        … 
        }
    • See the Snowbound VirtualViewer documentation website for additional configuration options. Please note that Pega has only validated that the default configuration options included with the Pega Marketplace component are fully compatible with Pega. Additional implementation and testing work is required by any client who wishes to enable additional Snowbound VirtualViewer capabilities.
  9. Start the server and make note of the context path.
  10. Import the VirtualViewer rules components into your Pega Platform production system.
    1. In Dev Studio, open the application rule form for your application by clicking the application name in the Dev Studio header and then clicking Definition.
    2. Add the VirtualViewer component to the list of Enabled components. For more information, see Enabling components.
    3. Save and close the application rule form.
    4. Edit the dynamic system setting, VirtualViewerURL, to include the context path from step 9. For more information about editing dynamic system settings, see Editing a dynamic system setting.
    5. Save and close VirtualViewerURL.
  11. Optional: Modify user permissions for annotations. For more information, see Modifying user permissions for Snowbound VirtualViewer annotations.
  12. Optional: Change user details to display in annotations. For more information, see Changing user details in Snowbound VirtualViewer annotations.

Troubleshooting VirtualViewer

To debug calls made from VirtualViewer to Pega Platform for file content, set the Rule_Obj_Activity.pyGetExternalViewerDetails._baseclass.Action logging level to Debug. After troubleshooting, revert the logging level.

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