Implementing Snowbound VirtualViewer 5.3 on Pega Platform
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:
- Obtain a SnowboundLicence.jar license file for VirtualViewer from Snowbound.
- On Marketplace, download the VirtualViewer_#.zip file that contains the VirtualViewer.jar file and the VirtualViewer.war file.
- Extract the VirtualViewer_#.zip file onto a shared location to which both Pega Platform and any external validation engines have access.
- Deploy the VirtualViewer.war file. For more information, see your application server documentation.
- Copy the license file from step 2 into the virtualviewer/WEB-INF/lib directory.
- Optional: Customize the default log location in the WEB-INF/classes/logging.properties file:
- Open the logging.properties file.
- Edit the log file line to update the default log file location. For example:
java.util.logging.FileHandler.pattern =../logs/pegaLogs/virtualviewerlog.log
- Save and close the logging.properties file.
- Optional: If logging to a specific file is not required, delete the logging.properties from following location WEB-INF/classes/.
- Configure email attachment features:
- If you do not need to send attachments as email messages, hide the
- Open the virtualviewer/user-config/toolbar-config.js file.
- Comment out the entry for
//vvEmailDocument
. - Save and close the file.
button on the VirtualViewer tool bar:
- If you need to send attachments as email messages from VirtualViewer, configure the default email sender address:
- Open the virtualviewer/user-config/toolbar-config.js file.
- 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.
- If you do not need to send attachments as email messages, hide the
- Start the server and make note of the context path.
- Import the VirtualViewer rules components into your Pega Platform production system.
- 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.
- Add the VirtualViewer component to the list of Enabled components. For more information, see Enabling components.
- Save and close the application rule form.
- 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.
- Save and close VirtualViewerURL.
- Optional: Modify user permissions for annotations. For more information, see Modifying user permissions for Snowbound VirtualViewer annotations.
- 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.