Professional Documents
Culture Documents
Open Text Imaging Web Viewer CE 21.4 Release Notes 2
Open Text Imaging Web Viewer CE 21.4 Release Notes 2
Release Notes
OpenText recommends that you read these Release Notes in conjunction with the documentation
included with the software package. If any conflicts exist, the Release Notes supersede the other
documentation.
We also recommend that you check OpenText My Support (https://support.opentext.com) for any
patches or documentation updates that may have been posted after the initial release of this product.
OpenText Imaging WebViewer (WebViewer) is a web application for displaying and printing
documents in web-based scenarios and for appending comments to these documents. The
documents may be stored in OpenText Archive and Storage Services (formerly known as Livelink
ECM – Archive Server) or any other repository.
WebViewer is used with the following products, which provide the interface for the end-user:
• OpenText Archiving and Document Access for SAP Solutions
Note
• This option does not work with Microsoft Internet Explorer
browsers (including in place view) – users must use
Quick_Mode_PDF_Document_IE_browser and enable the
Adobe plugin in the browser to view PDF documents quickly in
Internet Explorer browsers.
• Administration configurations and the leading application
permissions are not honored when Quick Mode for PDF
document is enabled.
Note
Documentation that is installed with the product or packaged with the
product download is current at the time of release. Documentation
updates made after a release are available for download on OpenText
My Support (https://support.opentext.com).
Note:
• Ensure that 'fontconfig' is available in the Linux Server in the WebViewer installed
location. WebViewer cannot render the documents properly without this. If ‘fontconfig’
is not installed, please use: “yum install fontconfig” to install.
Find docviewer.properties.
Save it.
Now the webviewer.jar should contain new properties files, restart the Tomcat and open the
document with requested/required locale, find the UI string messages translation.
Note:
1) It is up to customer to translate the message and if any issue, revert the changes
2) Help localization cannot be achieved via these steps.
The Release Notes are updated continually. The latest version and further technical information are
available on OpenText My Support (https://support.opentext.com).
Note:
On Linux systems, if the setenv.sh file is unavailable, the WebViewer installer creates
a new setenv.sh file along with its entries. If the setenv.sh file exists, the WebViewer
installer appends the configuration entries to it. To enable Archive Center to work with
WebViewer, OpenText recommends that you review the setenv.sh file after the
installation and remove any duplicate or conflicting entries.
WebViewer is a zero-footprint solution and does not require a strong client computer. The client must
have one of the supported browsers installed.
Operating Systems
• Microsoft Windows Server 2012 R2 64-bit
• Microsoft Windows Server 2016 64-bit
• Windows Server 2019 64-bit
• RedHat Enterprise Server 8 64-bit
• SUSE Linux Enterprise Server 12
Application Servers
• Apache Tomcat 8.5.51 or higher
• Apache Tomcat 9.0.31 or higher
Caution: Versions lower than Tomcat 8.5.51 and Tomcat 9.0.31 may have
vulnerability issues.
JDK Version
• Adopt OpenJDK 11.0.8 (WebViewer certifies with OpenJDK11 as it is LTS)
• SAPJVM8_81-x
Client
The following browsers and operating systems are supported.
MAC OS 10.x C
Safari 12
C = Certified
This platform was used for full regression testing with this release of WebViewer by OpenText.
Customer use is fully supported by OpenText Customer Support.
S = Supported
This platform received limited testing for this release of WebViewer by OpenText. Customer use is fully
supported by OpenText Customer Support.
Note:
Edge (based on Chromium) is alternative browser control for use in the SAP GUI 7.7 HTML Control – for
becoming independent of the Internet Explorer Control. Imaging WebViewer 21.4 is compatible with SAP
GUI 7.7 Microsoft Edge chromium in place view, SAP Fiori UI5 1.7.1.4(20191118-1256)
To view Content Server documents using WebViewer, the Content Server administrator needs to
store the credentials of WebViewer using the WebViewer Administration Console. For more
information, see section “Configuring Secure Parameters” in the WebViewer Installation Guide. The
integration of WebViewer with Content Server shares the authenticated session created between
WebViewer and Content Server. To establish a session, you must store the Content Server
credentials (Host Name, Username, and Password) in the WebViewer Administration Console. The
credentials are used to open a session between WebViewer and Content Server, but the impersonate
call will follow to switch the context to the user that is viewing the document. In case the Content
Server administrator credentials are not stored in the WebViewer Administration Console, the cookies
mechanism can be used to share the session context.
Note:
WebViewer cannot correctly display documents that are based on PDF format with
interactive technologies, such as Online Forms. WebViewer parses static PDF content
only and discards the interactive part of information.
OTF
Free search, rotating pages, forms overlay, displaying annotations, editing annotations, editing notes,
changing character set in notes, checking authenticity, copying text, and copying image data.
ALF
Free search, attribute search, rotating pages, forms overlay, displaying annotations, editing
annotations, editing notes, changing character set in notes, checking authenticity, hyperlinks,
copying text, and copying image data.
Compound Documents
Free search, rotating pages, forms overlay, displaying annotations, editing annotations, editing notes,
changing character set in notes, checking authenticity, digital signature, hyperlinks, copying text, and
copying image data
Note:
• For single documents contained in compound documents, the same functions are
available
as for the same format outside of compound documents.
Exception: Attribute search is not available for ALF documents contained in a compound
document.
• Free search and copying text are available only for plain text (ASCII), PDF, OTF, and
ALF documents inside a compound document.
• Digital signature is available only for PDF documents inside a compound document.
• Hyperlinks are available only for PDF and ALF documents inside a compound document.
• The printing functionality of WebViewer is achieved by rendering the document or choosing the
pages as PDF. The file is then downloaded to the client location and passed on to the PDF
software program present in the client location. This document can then be printed using the
configured printer. This functionality behaves differently depending on the combination of browser
and PDF software program used. OpenText strongly recommends testing your scenario carefully.
The best user experience is achieved with Internet Explorer 11 and Adobe Reader 11 or higher.
When displaying existing PDF format files from the archive, there is an option 'print as original' in
WebViewer, which avoids the additional rendering step. This enables good quality considering that the
whole document must be printed without any additional form and annotation features.
. TIFF/FAX
Rotating pages, forms overlay, displaying annotations, editing annotations, editing notes, changing
character set in notes, checking authenticity, and copying image data.
PNG/JPEG
Note: For the latest compatibility information for OpenText products, refer to the Compatibility
Matrix (https://knowledge.opentext.com/go/matrix) on OpenText Knowledge Center.
EN DE JA FR ES IT ZH PT RU FI AR CA NL ZH_TW
Imaging B B B B B B B B B UI UI UI UI UI
WebViewer
Administrator must restart Tomcat for the environment path settings of PDF/IMSCore
libraries to take effect, in case the WebViewer installation is performed on extracted
Tomcat.
1. Install OpenJDK.
2. Configure JAVA_HOME to point to OpenJDK.
3. Install Tomcat.
4. During the Tomcat installation, ensure that the JDK version points to "folder/path/to/OpenJDK"
because OpenJDK installation does not create any registry key.
OpenJDK must be installed prior to starting the WebViewer installation. JDK installation is a
prerequisite.
Important
Installation fails when using JRE instead of JDK. The environment must contain JDK.
JRE is not sufficient.
If the document Title contains umlaut characters, such umlauts will not display properly. Setting
connector parameters in Apache Tomcat Server Configuration, for example, (URIEncoding="UTF-
8" and tomcatAuthentication="false”) will display the Title characters properly.
Memory settings
OpenText recommends the following memory setting for the Application Server 64-bit JVM
options: Set JAVA_OPTS=-Xms2g -Xmx2g -XX:GCTimeRatio=2 -XX:ParallelGCThreads=8 -
XX:MaxGCPauseMillis=2000 -XX:+DisableExplicitGC
OpenText recommends the following optimal settings for the garbage collector: Set JAVA_OPTS=-
XX:GCTimeRatio=2 -XX:ParallelGCThreads=8 -XX:MaxGCPauseMillis=2000 -
XX:+DisableExplicitGC
Linux LD_LIBRARY_PATH
The Imaging PDF resources directory is the folder where the binaries of the PDF Library and the
Resource files (CMap, Font, Unicode) are located, for example, /usr/local/lib/PDFL.
Setup for Imagenation libraries
OpenText Imaging WebViewer integrates internally another OpenText product called Imagenation
for rendering the Microsoft Office documents. Imagenation is active and licensed by default. The
16.2.12 version of Imagenation is integrated with WebViewer CE 21.4.
Note: To render office documents in the Linux environment. It is mandatory to install the
Virtual Frame Buffer (Xvfb) and on the Glib package. Ensure that you install these packages
before running the Office format conversion in WebViewer.
Information leakage is an application weakness where an application reveals sensitive data, such
as technical details of the web application, environment, or user-specific data. Sensitive data may
be used by an attacker to exploit the target web application, its hosting network, or its users.
Important
When you upgrade WebViewer from a lower version and want to keep the
configuration, you must back up the configuration files wevconfig, menu.xml
(UI/component/menubar/menu.xml), and toolbar.xml (UI/component/toolbar/toolbar.xml), in
case of changes to keyboard shortcut key mappings before installing the new version.
After the installation, set the configuration values according to the previous values of
the wevconfig file (steps described above) and replace menu.xml and toolbar.xml files
with the corresponding backup files.
In case of applying the patch, you need to back up only menu.xml and
toolbar.xml (in case of changes to keyboard shortcut key mappings) and
replace menu.xml and toolbar.xml files with the corresponding backup
files.
5. Applying hotfix
Extract the WebViewer.war from WebViewer.zip to <TOMCAT_HOME>/webapps folders
Start Tomcat
6.1 Hotfixes
Hotfix installation
Refer the ReadMe file shared along with each Hotfix for installation/deployment steps.
Available hotfixes
The following table lists and describes the hotfixes available for this release.
7 Fixed issues
This section provides information about past issues that have been fixed in this release.
DOCVW-8284 OTCS Ticket 4368704 SAP Ticket - OpenText WebViewer is not working
correctly for doc and zip mime types. Enabled WebViewer to download
application/doc and application/zip to the client system.
DOCVW-8150 OTCS Ticket 4465043 WebViewer 16.2.8 - Unable to add notes. Introduced
a new configuration parameter 'XHRFormSubmission' for XMLHttpRequest
for forms.
DOCVW-9723 OTCS Ticket 4893517 - Clear the print and email cache similar to lea and
PDF cache.
DOCVW-9691 OTCS Ticket 4869948 - Cannot download documents from Remote Cache
Server with Imaging Reviews and Notes installed.
DOCVW-9651 OTCS Ticket 4828807 - Resolved the issue of saving. alf format files as .pdf.
DOCVW-10438 Time shown in WebViewer UI is adjusted correctly for different time zones
3. set JAVA_OPTS=-
Djavax.net.ssl.trustStore=<path of the truststore file>
4. Alternatively, you can set JAVA_OPTS in the
environment appropriately.
Reference: DOCVW-814
History of For each document called from SAP R/3, WebViewer starts a
documents does not new browser session. Therefore, the history of documents
work for documents feature does not work for documents from SAP R/3.
from SAP R/3
Reference: DOCVW-922
Reference: DOCVW-452
Host names must Host names must not contain an underscore. For example,
not contain an “host_name” is not allowed. The Apache HTTP library does not
underscore allow underscores in host names because this violates some
RFC concerning URLs.
Reference: DOCVW-784
Incorrect total In OTF and ALF documents, the WebViewer search finds hits
number of search in control commands that are not displayed. Thus, the total
hits in OTF and ALF number of search hits might be higher than the actual
highlighted hits in the document.
documents
Reference: DOCVW-756
Text documents with Lines in text documents with the prescribed page size can be cut
prescribed page off at some scaling factors. Since fonts are usually not
size continuously scalable, the character width of a scaled font may
not match the overall scale factor. If a page size is prescribed
(FORM.INFO), the scaled page size may be too small for the
text at some scale factors, for example 150%.
Reference: DOCVW-683
Maximum lines per Using very long lines (number of characters greater than 1000)
page is not with line wrapping in ASCII documents might lead to an
respected when incomplete display of characters.
creating the ASCII
page list Reference: 43156
Annotations outside If annotations created with Windows Viewer stretch beyond the
of document's limit original document's limits, the part outside is not shown by
WebViewer.
Reference: DOCVW-109
Reference: DOCVW-2030
Screen flickers in When using Mozilla Firefox and compound documents, screen
Firefox when flickering can occur when the “Send by Email” dialog box is
working with open and the selection is changed in the documents pane.
compound Flickering also occurs when in the Edit Annotations mode and
selection is changed in the documents pane.
documents
Reference: DOCVW-2153
Text overlaid on an Text portions that are overlaid on an image in a PDF document
image in a PDF cannot be copied.
document cannot be
copied Reference: DOCVW-1977
Unlocking locked Documents that remain locked due to a session timeout or in the
event of an unresponsive server will be unlocked based on the
documents in case
duration set by the parameter DS_LOCK_MAX_TIME of Archive
of session timeouts Center configuration parameters. This entry states the number of
or unresponsive minutes after which a document lock becomes invalid. After this
server period has expired, it is assumed that the program that set the
lock has become unresponsive or terminated without releasing the
lock. The default value for this entry is 900 minutes. Alternatively,
you can use the following URL, which can be typed into any
browser to do a forced unlock:
http://<server>:<port>;/archive?unlock&pVersion=0046&contRe
p=<contRep>&docId=<docid>force=yes
PDF additional fonts If a document does not embed the required fonts or have it in
the PDF resource, the user can create a symbolic link for the
required fonts from where those are available.
Browser window Minimal width of the browser window that WebViewer supports
resize to show footer bar icons is 450px. Beyond the limit, pagination
icons may not show properly.
Apache Tomcat In the Apache Tomcat selection wizard, the Add button is
selection during enabled by default. Select the listed Apache Tomcat instance,
installation and then click Add.
Encrypted PDF The Adobe’s PDF library allows encrypting the content in the
documents recent versions. This version of WebViewer cannot display
encrypted documents.
PDF server process If the application server is not shut down or becomes
manual shutdown unresponsive, then sometimes, the Java process created for
required if the PDF rendering will not be shut down. This will cause PDF
cache issues. If any PDF cache issue occurs, ensure that the
Application Server
Java process is aborted (manually) and restart the
becomes application server.
unresponsive or
does not shut down
properly.
OLE annotations are OLE annotations can be created in Windows Viewer. However,
not supported in when viewed in WebViewer, these OLE annotations are not
WebViewer displayed because WebViewer does not support OLE
annotations.
Annotations may fail Adding or editing annotations may fail if the browser’s back or
due to back or forward button is clicked in annotation mode because these
forward browser actions leave the user interface in an inconsistent state.
actions in annotation
mode. Reference: DOCVW-6040
Problem with Adobe An error message appears when trying to print a document,
Reader when a stating that there is a problem with Adobe Acrobat Reader. This
issue occurs because of Adobe Acrobat Reader version
document is printed
#2018.011.20040. To resolve the issue, configure Adobe
Acrobat Reader as follows:
1. Navigate to Edit > Preferences > Security (Enhanced)
and clear the Enable Protected Mode at startup check
box.
2. Run a repair and check if the issue is resolved by
performing the following steps.
a. Go to Control Panel > Programs > Programs and
Features.
b. Select Adobe Acrobat Reader > Change > Repair.
3. Start the application.
Reference: DOCVW-7080
Favicon is not When menu items are selected in the Edge browser, the special
displayed when character '#' is attached to the end of the URL. Due to this
action, the favicon is replaced with the Tomcat favicon.
menu items are
selected in the Edge
Reference: DOCVW-6991
browser
Reference: DOCVW-6955
PDF fails to open When the rendering fails for a PDF document, it will be
exceptions downloaded to the client.
Japanese For certain Archive Link Format documents with East Asian
characters are not (Japanese) characters, the printed output is appearing as blank.
To view the output, the administrator needs to configure
displayed in printed
vu_MaxCharsPerLine to a smaller number, such as 200.
documents
Reference: DOCVW-7114
Archive Link Format Rendering of some specific documents that include East Asian
(ALF) performance characters will take more time when JDK 11 is used. For more
details, refer to https://bugs.openjdk.java.net/browse/JDK-
is slow
8179209.
Reference: DOCVW-7174
Wait until existing An interruption might occur if a new operation is started by a user
while an existing operation, such as printing, saving, or sending
operation is finished
email is in progress. Therefore, you must wait until the current
operation is finished before starting a new operation.
Reference: DOCVW-7087
Watermark not Watermark does not appear on the print output for a document
displayed when when the Black and White output option is selected in the Print
dialog box.
Black and White
print output is Reference: DOCVW-7106
selected
Stamps.xml Backslash ("\") is a forbidden character to configure for stamps.
Adding annotations When a user tries to add multiple annotations too briskly, some
of the annotations might not be saved. Users are advised to
take an interval of at least 1 (one) second between adding two
annotations.
Reference: DOCVW-6860
Reference: DOCVW-6977
Select Page Page selected using the “Select Page” option cannot be copied
Clipboard because Java Applet is deprecated in all the browsers.
Functionality Reference: DOCVW-7373
AutoSave Auto save refreshes any unsaved user behavior, such as the
selection of annotation using the annotation summary panel.
Reference: DOCVW-8086
Current user annotations are displayed even when the user is not
selected to display the annotation.
Reference: DOCVW-8221
Reference: DOCVW-8199
Hyperlinks WebViewer cannot detect Text type URL's if the PDF document
has the combination of text type and hyperlink type URLs.
Printing and Saving Using Print and Save functionality, the user should be advised to
Large Documents limit the maximum number of pages to print to 100 pages.
If the user wants to print and save the complete document, "Save
As Original Format" can be used.
Reference: DOCVW-7097
Reference: DOCVW-9261
Work around
Suggest opening one document at a time.
Localization There are few strings in WebViewer which are not localized in all
the languages either due to technical complexity or the strings are
used as images in the application. All non-localized strings will be
displayed in English to the user. Below mentioned epic includes all
such issues and also other localization issues which will be
catered in upcoming versions.
Reference: DOCVW-9174
Data loss happen WebViewer show till 5 pages even if there are more page in the
while large excel document.
documents are
rendered Workaround: set 'Excel View Mode=0'
Ref: DOCVW-10550
Image is not getting When a document is opened from SAP Fiori in the Embedded mode then
displayed with the document is not getting opened. This is because of the security
WebViewer with the update both Chrome and Chromium have received. Firefox is soon to get
integrated VIM Fiori these security updates.
Apps Due to security updates for Browsers like Chrome and Chromium Third-
Party cookies are blocked due to changes in SameSite settings in the
response header. Due to this change By default SameSite=LAX is being
set due to which third-party cookies are being blocked.
The same is in this case wherein WebViewer JSESSIONID is blocked as
SameSite is not set to NONE.
TO avoid this it is mandatory that:
1) SSL needs to be configured to the tomcat.
2) When SSL is enabled then the Secure attribute should also be
enabled. (Automatically enabled now for HTTPS).
3) If the above two steps are done then we need to set SameSite=NONE.
If all the above steps are met then SameSite is set to NONE. This will fix
the issues caused in iframes or in the Embedded view.
So, To configure these steps we need a Tomcat configured to SSL and
add these changes into the context.xml files inside WebViewer\META-
INF\context.xml.
Changes in the xml file: <CookieProcessor
className="org.apache.tomcat.util.http.LegacyCookieProcessor"
sameSiteCookies="None" />
Note: In Tomcat < 9.0.28 (or < 8.5.48 for the 8.5x branch), the same-site
attribute is not set if the value is NONE.
Reference: DOCVW-9867
35