This Readme document contains information about the installation of this package and about restrictions in support of IBM Daeja ViewONE, Version 5.0.3 iFix 4
Readme for: IBM Daeja ViewONE
Product or component release: Version 5.0.3
Update name: iFix 4
You must have IBM Daeja ViewONE, Version 5.0.3 installed.
Before you install IBM Daeja ViewONE, Version 5.0.3 iFix 4:
IBM Daeja ViewONE, 5.0.3 iFix 4 is provided as a compressed file containing the files that are needed to update Version 5.0.3 for all supported platforms.
To install this package:
As this package contains all the files required for all platforms, you can remove the files that are included for platforms that are not relevant to your environment. Change to the server/WEB-INF/lib directory under the Daeja ViewONE installation directory and delete the platform specific jars that are not relevant.
There are platform specific jar files:
Make a backup of the Daeja ViewONE 5.0.3 files in the relevant locations in your web application server. For the server files that will be the web application's WEB-INF/lib directory. For the client, it will be where the package client files were copied to. For example v1files directory in the web application.
Note: To upgrade to iFix 4, please ensure that both the client and the server are updated.
If you want to remove the iFix 4 from your installation and revert back to the original 5.0.3 version, you need to replace the files in you installation directories with the backed up files, then copy the files into the correct places in your web application server.
If you use the IBM Daeja ViewONE Version 5.0.3 uninstallation program to remove IBM Daeja ViewONE 5.0.3 and the iFix 4 from your system, then some of the files may be left on your file system and you will need to remove them manually.
IBM Daeja ViewONE comes with a Toolkit rich in capabilities that enables advanced integration and customization of the viewer by using HTML parameters and JavaScript API methods. For more information on the developer’s guide refer to:
IBM Daeja ViewONE 5.0.3 Virtual Developer's Guide
The following APARs are fixed in this product release for customers who have direct entitlement to IBM Daeja ViewONE. If you are using IBM Daeja ViewONE made available to you as part of another IBM product, these fixes might not be available immediately. Contact IBM Support for information about IBM products that integrate IBM Daeja ViewONE.
See release notes for more information:
IO26051 SOME PDF DOCUMENTS MAY DISPLAY WITH BLACK CHARACTERS
Some PDF documents may display with black characters that mean they are not readable.
Affected users: IBM Daeja ViewONE Virtual users.
IO25563 SOME PDFS WITH FILLED BACKGROUND TABLES DO NOT DISPLAY CORRECTLY
Some PDF documents that contain tables or forms with filled backgrounds may not display correctly.
Affected users: IBM Daeja ViewONE Virtual users.
IO26027 Some PDF documents with AES-256 encryption may fail to display.
Some PDF documents that are encrypted with AES-256 may fail to display
Affected users: IBM Daeja ViewONE Virtual users.
IO25985 Some PDF Documents render as a black page.
Some PDF documents that contain text on top of a stretched black pixel may result in a black page being displayed.
Affected users: IBM Daeja ViewONE Virtual users.
** HTML parameter
The
Affected users: IBM Daeja ViewONE Virtual users
** Unable to view client logging
When clicking the 'Log Console' button the user receives a browser alert stating that there is an 'XML request error: Not Found (404)', instead of displaying the client log output.
Affected users: IBM Daeja ViewONE Virtual 5.0.3 iFix003 users
** New move page JavaScript API
This feature allows integrators to move a page via a JavaScript API.
The move page API is structured as follows movePage(int pageFrom, int pageTo)
where pageFrom is the page we are going to move and pageTo is the destination point for this page.
For example, movePage(1, 5) will start with a page list of '1, 2, 3, 4, 5'; and end with a page list of '2, 3, 4, 5, 1'.
Once a move operation is complete, a single DOCUMENT_CHANGED event (84) will be fired.
Annotations are moved with the page.
This API is only available when the viewer is in Document Builder mode.
Affected users: IBM Daeja ViewONE Virtual users
IO25610 DAEJA VIRTUAL: CANNOT HIDE "SHOW ANNOTATIONS" BUTTON ON STATUS BAR.
Setting <param name="annotationHideButtons" value="show" /> does not hide 'Hide annotations' button.
Affected users: IBM Daeja ViewONE Virtual users
IO25606 ZOOM-IN/ZOOM-OUT BUTTONS CANNOT BE HIDDEN BY SETTING IMAGEBUTTONS=FALSE
Setting <param name="imageButtons" value="false"> does not hide zoom-in and zoom-out buttons.
Affected users: IBM Daeja ViewONE Virtual users
IO25436 LOW RESOLUTION DISPLAY AT BOTTOM OF THE PAGE WHEN SWITCHING FROM THUMBSONLY VIEW
The display of the document can be blurry when scrolling to the bottom of the page after switching viewmode from thumbsonly to any other viewmode.
Affected users: IBM Daeja ViewONE Virtual users
** HTML parameter annotateEdit blocks the JavaScript API method addAnnotation
The annotateEdit parameter should only prevent user interaction with
the annotations. A separate parameter, annotationJavascriptExtensions
is used to allow the use of the API method addAnnotation(String).
Affected users: IBM Daeja ViewONE Virtual users
** When the keepScroll parameter is set to true large documents may cause the viewer to become inoperable
The keepScroll parameter enables the scroll position to be maintained on page changes,
but when it used with large documents the viewer can become inoperable, and may cause
an Out of memory error rendering the browser window inoperable.
Affected users: IBM Daeja ViewONE Virtual users
Work around:
Remove the keepScroll parameter from the viewer configuration.
IO26024 SCRIPT SRC AND HOSTING PAGE LOCATION MISMATCH PREVENTS VIEWER STARTUP
If the <script> tag pointing to the viewer code location (viewone.js) references a host, port, or path
that differs from the location of the hosting HTML page (ie. the location in the browser URL) then the viewer
will fail to start. This is due to further viewer code being loaded via path calculated on the server rather
than a relative path calculated on the client.
Note: Loading viewer code, which is JavaScript based,
from a different location to the hosting page may be subject to Cross-Origin Resource Sharing (CORS)
restrictions.
Affected users: IBM Daeja ViewONE Virtual users
Navigation User Interface enhancement Toolbar page information label includes the total page count
The page information label in the top toolbar clearly shows at a glance the current page number and the total page count of the document that the user is currently viewing.
Affected users: IBM Daeja ViewONE Virtual users
** Changes to the color of arrow annotations are not reflected in the User Interface
Changing the color of an arrow annotation using the color dialog picker from the annotation context menu toolbar does not reflect the change in the rendering of the annotation in the User Interface. The color information is saved correctly.
Affected users: IBM Daeja ViewONE Virtual users
IO25796 PRINT DIALOG "ALL" OPTION IS GREYED OUT
The print dialog 'All' option under the 'Pages to print' section is greyed out and cannot be selected. If the user chooses the 'Current', or 'Pages' options before pressing 'Prepare File', they will be unable to select the 'All' option for the same or subsequent documents.
Affected users: IBM Daeja ViewONE Virtual users
Work around: Clearing local storage will clear the previously selected print option and allow the viewer to default back to the 'All' option
IO25973 ERROR LOGGING INTERRUPTS THE ABILITY TO START THE CLIENT
Exceptions occurring in the retrieval and caching of repository documents prevent new instances of the viewer being loaded.
Affected users: IBM Daeja ViewONE Virtual users
IO25420 PDF DOCUMENT CONTAINING JBIG2 IMAGE WITH PATTERN DICTIONARY NOT DISPLAYED
PDF documents containing embedded JBIG2 images that contain a pattern dictionary may not display correctly.
Affected users: IBM Daeja ViewONE Virtual users
IO25557 ANNOTATION AUTOSAVE FAILS FOR SECOND DOCUMENT ONWARDS IN SESSION
The annotation autosave process does not take place on close after a second document is loaded via the JavaScript function openFile.
Affected users: IBM Daeja ViewONE Virtual users
IO25870 RENDERING FAILED INTERMITTENTLY WHEN NAVIGATING TO ANOTHER PAGE OF AN IMAGE DISPLAYED
When performing rapid navigation of pages an error message is sometimes displayed indicating that a render failure occurred.
Affected users: IBM Daeja ViewONE Virtual users
Work around: The dialog can be dismissed and the page displayed by reusing the page-up and page-down
buttons
** Some PDF documents containing slideshows may render with missing content.
A PDF document containing a slideshow may render with missing content due to an out of bounds exception.
Affected users: IBM Daeja ViewONE Virtual users and Professional users
IO25674 HTML EMAIL WITH INVALID STYLE BLOCK DOES NOT DISPLAY CORRECTLY.
HTML Emails with invalid Style Blocks fails to display correctly.
Affected users: IBM Daeja ViewONE Virtual users and Professional users
IO25409 HTML EMAIL FAILS TO DISPLAY CORRECTLY WITH A COLSPAN AND WIDTH ATTRIBUTE IN A TABLE USING EMAILRENDERER=2.
HTML Emails containing tables with a colspan attribute and a width attribute fail to display correctly when setting the parameter EmailRenderer to the value 2.
Affected users: IBM Daeja ViewONE Virtual users and Professional users
IO25082 VIEWER MAY LEAVE ELEMENTS IN THE BROWSER DOM ON CLOSING
When the viewer is closed after printing an iFrame may be left in the browser document object model.
Affected users: IBM Daeja ViewONE Virtual users
IO24740 AT STARTUP THE VIEWER OVERRIDES THE BROWSER WINDOW NAME
The name of the browser window is replaced with "com.ibm.dv.client.Viewer" when the viewer loads. This may break existing application logic that seeks to access a window it has created.
Affected users: IBM Daeja ViewONE Virtual users
IO25823 REPOSITORY ACCESS ERROR CAN CAUSE CORRUPTION IN SERVER CACHE
When the document repository returns a non-successful response code, a corruption can occur in the server-side docstore cache. As a result of this corruption, the client will not being able to view a document. An example non-successful response code would be 403 Forbidden.
Affected users: IBM Daeja ViewONE Virtual users
IO25945 PRINTOUT OF NEWLY ADDED AND SAVED ANNOTATIONS HAS ANNOTATIONS RENDERED INCORRECTLY ON PRINTED PAGE
When a document is printed straight after a newly created annotation has been saved, the newly created annotation can appear in the wrong place.
Affected users: IBM Daeja ViewONE Virtual users embedded in an ICN or Filenet system
** Unexpected shift in pixels when paging between many pages with KeepScroll enabled.
When paging between many pages with KeepScroll enabled, the user may experience an unexpected shift in pixels.
Affected users: IBM Daeja ViewONE Virtual
** Unexpected zoom levels when paging between many rotated pages with KeepScroll enabled.
When paging between many rotated pages with KeepScroll enabled, the user may experience an unexpected zoom levels.
Affected users: IBM Daeja ViewONE Virtual
IO25492 PLAIN TEXT EML EMAIL FILE FAILS TO DISPLAY
Plain text email in EML format displays <code>Image format not recognised</code>
Affected users: IBM Daeja ViewONE Virtual and Professional users
IO25946 ANNOTATION TOOLBAR IS SPORADICALLY DISABLED
When page array is used, sometimes the annotations toolbar is not enabled when the viewer is loaded. This occurs if the HTML parameter quickNavigateView is set to false. The toolbar becomes enabled if an action is done in the viewer such as changing page, changing page zoom, changing browser size, etc. after it is loaded.
Affected users: IBM Daeja ViewONE Virtual users
IO25718 HIDDEN HEADERS ARE DISPLAYED IN WORD DOCUMENT
Hidden headers in MS Word documents are incorrectly displayed.
Affected users: IBM Daeja ViewONE Virtual and Professional users
IO25719 PPTX DOCUMENT FAILS WITH ERROR THIS DOCUMENT HAS BEEN TRUNCATED
Opening some MS Powerpoint documents with embedded text can fail showing the error, 'This document has been truncated because of an error that occurred while retrieving the requested page'.
Affected users: IBM Daeja ViewONE Virtual and Professional users
IO25741 PPTX DOCUMENT WITH RADAR CHARTS TRUNCATES NUMBER OF PAGES
Opening a MS Powerpoint document that contains a radar chart will fail showing the error, 'This document has been truncated because of an error that occurred while retrieving the requested page'.
Affected users: IBM Daeja ViewONE Virtual and Professional users
IO25832 PPTX DOCUMENT CONTAINS MISSING VALUES ON SOME CHART DATA .
Charts in MS Powerpoint documents do not show the values.
Affected users: IBM Daeja ViewONE Virtual and Professional users
** TIFF IMAGES WITH INVALID PAGENUMBER TAGS FAIL TO RENDER
TIFF files that contain multiple pages should define the TIFF PageNumber tag with the first page having a page number, 0. TIFF images where the page number does not start at 0 fail to display.
Affected users: IBM Daeja ViewONE Virtual users and IBM Daeja ViewONE Professsional users
** ANNOTATION INCREASE LINE WIDTH RESULTS IN INCORRECT TEXT ANNOTATION SIZE
Clicking the 'Increase Line Width' on a text annotation results in the annotation decreasing in size. Clicking the 'Increase Line Width' a second time results in the annotation correctly increasing in size. Saving the annotation and reloading the viewer results in the annotation being larger than when saved.
Affected users: IBM Daeja ViewONE Virtual users embedded in an ICN or Filenet system
** ANNOTATION DECREASE LINE WIDTH RESULTS IN INCORRECT TEXT ANNOTATION SIZE
Clicking the 'Decrease Line Width' on a text annotation results in the annotation disappearing.
Affected users: IBM Daeja ViewONE Virtual users embedded in an ICN or Filenet system
Circle, Oval, Rectangle, Square, Polygon, Freehand, Line and Arrow annotation types support default semi-transparent border.
Once this package has been installed, then APARs IO24433 and IO24174
are resolved by setting the following ViewONE parameter,
useJavaPdfTTFontHinting to false.
Published Technote :http://www.ibm.com/support/docview.wss?uid=swg22007466
Published Technote :http://www.ibm.com/support/docview.wss?uid=swg22008011
Published Technote :http://www.ibm.com/support/docview.wss?uid=swg22008010
Published Technote :http://www.ibm.com/support/docview.wss?uid=swg22008009
The Build Number associated with this package is contained in build.txt, which is located in the client/v1files directory. Historically this contained the full product version number but now it only contains the ViewONE internal build number.
The document will be built with the source document as it is saved in the repository. The document is also built by using the annotations that are saved in the repository, unless annotations have been edited. The following scenarios explain the effects of this behavior:
Result: The document currently displayed in the viewer differs from the newly built document in the system. To prevent this issue occurring, the master document should be locked or checked out when it is retrieved for document builder.
Note Versioned documents will not be affected by this issue. This will only affect situations where the document that a url refers to has changed.
Result: The document currently displayed in the viewer differs from the newly built document in the system. To prevent this issue occurring, the master document should be locked or checked out when it is retrieved for document builder.
When in document builder mode, the option to restore annotations is not supported. The following scenario explains the effects of this behavior:
Scenario 1:
Result: The user cannot reload the annotations from the server. Newly created annotations and edited annotation edits remain.
To restore any newly created annotations, the user must take the following steps:
When running Daeja ViewONE 5.0.3 as a component inside IBM Content Navigator, the minumum supported version of ICN is 3.0.3
As problems are discovered and resolved, the IBM Support team updates the Support site. By searching the Support site, you can quickly find workarounds or solutions to problems.
The following links open queries for IBM Daeja ViewONE documents on the IBM Support site:
Any restrictions and/or limitations of the base or fix pack release and any subsequent ifixes, still apply to this release unless stated otherwise.
IBM Daeja ViewONE Virtual is designed to support as many file types as possible. However, the product is not able to render every type of file with the same accuracy as native applications, such as Microsoft Word. The flexibility of the viewer can lead to differences in the way that the documents are displayed between the native application and the viewer. The severity of the differences varies depending on the complexity of the file type. In particular, PDF files and Microsoft Office files are difficult to render with complete accuracy in a universal viewer.
Excel spreadsheet load times are impacted based on the size and complexity of the Excel document. In order to improve load times, IBM Daeja ViewONE does support tuning capabilities, such as breaking up the Excel document presentation into multiple pages. Please be aware, as this behaviour may not be optimal for your end user viewing experience.
After a document is permenantly redacted and the user selects Download, they are
normally prompted to save the document with a file name based on the original
un-redacted document. For instance mypresentation.ppt will default to
mypresentation.tif. In this version the user might be prompted with a filename
such as 41f96b20b97f431ebd4efd85245f1f72.tif instead. The user can still
change the name to something more meaningful.
If a pageN document is open in the viewer, the user cannot switch to document builder mode. The user remains in the edit mode in which the document was opened. The following scenario explains the effects of this behavior:
Scenario 1:
Result: This switch is not permitted and the user will stay in their current mode.
To enter document builder mode, the user must close the pageN document and then switch to document builder mode.
DocN documents are not supported in conjunction with document builder mode. The combination of these features may result in unusual and/or unexpected behavior.
Document builder is able to support TIFF and PDF files with the exception of email attachments. TIFF and PDF files that are attached to emails cannot be used as source files for a new document.
PDF files with access control flags set by the owner of the document cannot be used as a source document for document building where they require a password to view the document or where the owner has indicated that the content may not be copied.
Annotations that have the semi-transparent property set to true, the transparent property set to true and a fill color set can appear to blend the line and fill colors near the edges.
Annotations that have the transparent property set to true and a fill color set to black are not printed transparent .
http://www.ibm.com/legal/copytrade.shtml
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Other company, product, or service names may be trademarks or service marks of others.
The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.
Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: