Brava!® HTML Viewer 4.

ADMINISTRATION GUIDE

1
BravaHTMLViewer_AdminGuide

Table of Contents
Brava HTML Viewer Administration Guide ..........................................................................................3
Chapter 1: Requirements .................................................................................................................4
Chapter 2: Installation .....................................................................................................................5
Installing Brava HTML Viewer ........................................................................................................5
Chapter 3: Configuration Options ......................................................................................................5
Feature Availability Matrix .............................................................................................................6
Tips and Limitations .........................................................................................................................6
Copyright Notices and Acknowledgements.........................................................................................8

2
 Brava HTML Viewer Administration Guide

BRAVA HTML VIEWER ADMINISTRATION GUIDE

INTRODUCTION

This guide provides information about installation and configuration of the Brava! ® Enterprise HTML
Client. Version 4.0 is integrated with a Brava Enterprise Server installation 7.3.
The Brava HTML Viewer provides users the capability to load documents from the Brava Server online
using a web browser. Documents are processed with the Brava! Enterprise Server as HTML output and
are presented in this streamlined viewer for quick viewing, searching, publishing, redacting, and
adding/reviewing annotations (including Changemark discussion).
A separate user interface is also available for 3D HTML viewing, Video file viewing, and HTML Compare
viewing.

PRODUCT VERSION INFORMATION

Version 4.0
Copyright 2015. All rights reserved.
If you need information on integrating and customizing Brava HTML Viewer or if you experience any
problems or have general inquiries, please feel free to contact us.

4835 E. Cactus Road, Suite 445

Scottsdale, Arizona 85254
Phone: (602) 971-6061
M - F 5am to 5pm, Arizona time
E-mail: info@infograph.com
Web: www.infograph.com

3
BravaHTMLViewer_AdminGuide

CHAPTER 1: REQUIREMENTS

HTML CLIENT REQUIREMENTS

 Installation of Brava Enterprise 7.3 or Brava Enterprise .NET 7.3

 The following environments are supported for the Brava HTML Viewer client system:

Details of tested configurations:

HTML Viewer (Desktop Client)

IE Chrome Firefox Safari
Operating Systems
Versions Versions Versions Versions
Windows 8 32/64-bit
9*
Windows 8.1 32/64-bit 31.x ESR
10 ---
Windows 7 32/64-bit
11
Windows Vista 32-bit 38

Mac OSX 10.9.1 --- 7.0.1

Mavericks 31.x ESR
Mac OSX Mountain Lion
--- ---
10.8.5 6.0.5
*IE9 is supported in native mode. Compatibility mode is not supported. Video mode is not supported with
IE9.

Mobile: HTML viewer is also supported in the following Mobile Client environments

Mobile Tablets
iPad with iOS 7.1, iOS 8.0, iOS 8.1
Android - Jelly Bean and Ice Cream Sandwich, Browsers - Chrome browser only
Mobile Phones
iOS 7.1, iOS 8.0, iOS 8.1
Android- Jelly Bean and Ice Cream Sandwich, Browsers - Chrome browser only
Blackberry 10
MS Phone 8.1

Note that different printing features and options are available depending on which browser and PDF plug-
in configuration you are using. Please see the feature matrix. To obtain the optimal PDF plugin printing
experience, please update your browser to the most recent version available.

4
 Brava HTML Viewer Administration Guide

CHAPTER 2: INSTALLATION

INSTALLING BRAVA HTML VIEWER

Run the Brava Enterprise Installer. In the Custom Setup screen, the Brava! SDK component is disabled by
default. Select the drop down arrow for Brava! SDK and select "This feature, and all subfeatures will
be installed on local hard drive". The HTML Client files and folders are installed as a component of
the Brava Enterprise SDK to your Brava Enterprise installation directory as ..\BravaSDK\HTML\.

CHANGEMARKCONFIG.XML NOTES

Once installation is complete, it may be necessary to copy the ChangemarkConfig.xml file from the HTML
Viewer install directory (located on the BravaServer in \BravaSDK\HTML\config) to your web server
directory (C:\Program Files (x86)\Apache Software Foundation\Tomcat
7.0\webapps\BravaSDK\HTML\config). Without ChangemarkConfig.xml on the web server, any markup
file, including a changemark entity, cannot be saved.
The GetSignedConfig.aspx/jsp file (see the HTML Integration documentation in BravaSDK/Docs)
references the ChangemarkConfig.xml file in its ChangemarkConfigURI property. That property MAY need
to be manually updated after the installation to point to the correct location, OR the xml file MAY need to
be copied to the directory referenced by the URL.

CHAPTER 3: CONFIGURATION OPTIONS

5
BravaHTMLViewer_AdminGuide

FEATURE AVAILABILITY MATRIX

Depending on your browser configuration, the following Print features will be available in the HTML
Viewer.

Browser With Acrobat Markups Banners / Changemark Redaction Monochrome

Plug-In Watermarks Summary Reasons
Internet Explorer 9/10/11 X X X X
Chrome X X X
Firefox X X X
Safari X X X (v.6+)

To obtain the optimal PDF plugin printing experience, please update your browser to the most recent
version available.

Browser Without Acrobat Plug-In Markups Banners / ChangemarkRedactionMonochrome

Watermarks Summary Reasons
Internet Explorer 9/10/11 X X
Chrome -With "Chrome PDF Viewer" Plugin X X X X X
Chrome -No "Chrome PDF Viewer" Plugin X X X
Firefox X X X
Safari - With “WebKit built-in PDF” Plugin X X X X X (v.6+)
Safari - No “WebKit built-in PDF” Plugin X X X (v.6+)

TIPS AND LIMITATIONS

Problem: The HTML Viewer is not launching properly when using IE9.

6
 Brava HTML Viewer Administration Guide

Solution: To resolve this issue, set the internet security setting (IE only) "Access data sources across
domains" to either "Enable" or "Disable". Either setting will permit the HTML client to operate properly. If
set to "Prompt" the security warning will display every time the HTML client is used.
Ensure that "compatibility" mode is off when using IE9.

Problem: Markups cannot be saved.

Solution: Once installation is complete, it may be necessary to copy the ChangemarkConfig.xml file
from the HTML Viewer install directory to your webapp directory (C:\Program Files (x86)\Apache
Software Foundation\Tomcat 7.0\webapps\BravaSDK\HTML\config). Without ChangemarkConfig.xml on
the web server, any markup file, including a changemark entity, cannot be saved.

Problem: Some markup templates created in earlier versions of Brava ActiveX viewer do not work
properly in Brava HTML viewer.
Solution: This is a markup compatibility issue. Existing stamp templates which contain raster images
(created in previous Brava ActiveX versions using the insert image tool) will need to be re-saved in a 7.2
or higher ActiveX viewer before the HTML Viewer 3.15 or later will be able to use them.

Problem: The viewer is not functioning properly using HTTPS.

Limitation: When configuring your Brava server for SSL via HTTPS, you must manually update the URL
prefix in the GetSignedConfig file, located on <web server>\webapps\BravaServer\ to obtain the
required functionality. Perform a search and replace to change all instances of HTTP to HTTPS.

Problem: Underlining of text annotations does not work in Firefox.

Limitation: The Underline text annotation feature is not available in Firefox due to a browser limitation.

Problem: I can’t select text in SVG files in Firefox.

Solution: Upgrade to Firefox version 25. This version supports native text select of SVG files.

Problem: The HTML Demo page, or other pages, do not launch on a localized installation.
Solution: Filenames of pages cannot contain unicode characters unless your server can handle these
characters on requests. For example, Tomcat can not handle these requests by default and you will need
to add URIEncoding="UTF-8" to the Connector element in the server.xml to enable unicode
filenames.

Problem: Banners do not appear on the printed page when using Safari browser.
Limitation: The Brava HTML Print feature in Safari is PDF-based, and prints PDFs at a scale that masks
out the margins containing the banners. To resolve this known issue, set the scale to 90% in the native
Safari print dialog, and banners will show up.

7
BravaHTMLViewer_AdminGuide

Problem: The HTML viewer, when running in a Mozilla/Firefox browser, can’t view raster (bitmap)
images at all scale factors. The higher the image's resolution, the lower the scale factor ceiling is.
Limitation: Mozilla limits bitmap dimensions to (32767*96)/DPI. See Mozilla limitation at
https://bugzilla.mozilla.org/show_bug.cgi?id=591822.
Until this feature is improved, a suggested workaround includes making the viewer smaller by adjusting
the browser window size and zooming out the image until the viewer shows the image again.

Problem: Some fonts may not display correctly when using Internet Explorer.
Limitation: This is due to a known issue in IE.

Brava Enterprise Redaction License:

The Brava Enterprise Job Processor demo license has redactions enabled. After the demo license has
expired, customers will need to acquire a redaction license from IGC to continue using the HTML Viewer's
redaction features.
If a redaction license is not used, administrators should disable the HTML Viewer's redaction feature by
changing their signed config param Features.Redaction.Enabled property to false which will hide the
redaction UI controls from users.

COPYRIGHT NOTICES AND ACKNOWLEDGEMENTS

This software includes third party component software distributed by OpenText to you pursuant to
specific third party license agreements, whose terms and conditions are as set forth in your license
agreement with OpenText and/or the Terms and Conditions of Embedded Products. Copies of such
Embedded Software Licenses relating to the use and distribution of such Embedded Products can be
found in the \Licenses directory located in the product installation directory. You agree to comply with all
such Embedded Software Licenses which apply to the Software licensed to you by OpenText.
Please refer to the LegalNotices.pdf document included in your product installation to view all third
party software copyright notices and acknowledgements that are associated with this product and its
components.

Copyright Notice
©2015 OpenText, Inc. All rights reserved.