This Readme document contains information about the installation of this package and about restrictions in support of IBM Daeja ViewONE, Version 5.0.5 iFix 11
Readme for: IBM Daeja ViewONE
Product or component release: Version 5.0.5
Update name: iFix 11
You must have IBM Daeja ViewONE, Version 5.0.5 installed.
Before you install IBM Daeja ViewONE, Version 5.0.5 iFix 11:
IBM Daeja ViewONE, 5.0.5 iFix 11 is provided as a compressed file containing the files that are needed to update Version 5.0.5 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.5 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 11, please ensure that both the client and the server are updated.
If you want to remove the iFix 11 from your installation and revert back to the original 5.0.5 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.5 uninstallation program to remove IBM Daeja ViewONE 5.0.5 and the iFix 11 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.5 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:
The user interface is unresponsive when viewing very large documents
The viewer becomes unresponsive when displaying very large documents (over 500 pages). The viewer has been optimised to improve responsiveness, but documents larger than 2000 pages may still experience a slow down in performance.
Affected users: IBM Daeja ViewONE Virtual users
IO27005 AFTER A MERGE AND SPLIT OPERATION THE NEW VERSION OF THE DOCUMENT IS NOT SHOWN
In Merge and Split mode removing a page in an existing document does not show the latest version after checkin
- it displays the original version.
This issue occurs where the same URL is used for the new version of the document and document check method defined
by the parameter modifiedDocumentCheckMethod
has a value of lastModified
or etag
.
To function correctly the modifiedDocumentMinimumCheckTime
needs to be set to a low value
that is less than the time it takes to check-in the new document version.
Affected users: IBM Daeja ViewONE Virtual users
IO26880 EMAIL TEXT IS MISSING AND SOME EMAIL TEXT IN THE WRONG PLACE
Email text is missing and some email text is rendered in the wrong place.
Affected users: IBM Daeja ViewONE Virtual users
IO26957 CUSTOM ANNOTATION STAMPS IN ITS STAMPS DROP-DOWN LIST ARE MISSING OR PARTIALLY SHOWN
When a large number of annotation stamps are listed the alignment and sizing of the stamp list box can be can be incorrect and obscure or hide some items.
Affected users: IBM Daeja ViewONE Virtual users
IO26960 MULTI-FILE DOCUMENT LOAD FAILS IF THE FRAGMENT NUMBER IS HIGHER THAN THE TOTAL NUMBER OF PAGES
When loading a multi-file document using PAGE<N> HTML parameters or the pageArray JavaScript methods,
a particular page will fail to load if the URL fragment number for this page is higher than the total number of pages to load in the viewer.
For example when loading a five page multi file document, setting the URL of one the pages to 'http://my.repository/sample.pdf#10'
will cause that page to fail to load. This is because the fragment number '10' is larger than the number of pages being loaded, '5'.
Affected users: IBM Daeja ViewONE Virtual users
IO26967 WHEN USING PAGE<N> WITH ONE PAGE SPECIFIED IN THE ARRAY PRINT PRODUCES THE WHOLE DOCUMENT INSTEAD OF THE REFERRED PAGE
PAGE<N> prints the whole document instead of the referred page in a document. This happens only when there is one page in the Array. If there are two or more pages in the array it works fine.
Affected users: IBM Daeja ViewONE Virtual users
IO27015 WORD DOCUMENT WITH AN UNSUPPORTED PROPERTY IN DML SHAPE IS NOT RENDERED PROPERLY
Word document does not display correctly when it has a template containing a DML shape with an unsupported property.
Affected users: IBM Daeja ViewONE Virtual users
IO27016 HIGHLIGHTS ARE NOT RENDERED CORRECTLY WHEN VIEWING A MACRO ENABLED WORD DOCUMENT
When you view a macro enabled Word document, the highlights are not rendered correctly.
Affected users: IBM Daeja ViewONE Virtual users
WHOLE WORD TEXT SEARCH ON CJK STRING RETURNS NO RESULTS
Performing a text search on pdf documents containing CJK (Chinese, Japanese and Korean) characters with the 'whole word only' feature enabled, return no
results if not surrounded by white space.
Affected users: IBM Daeja ViewONE Virtual users
IO26983 CORRUPT GIF IMAGE CAUSES HUNG THREAD
A corrupt GIF image cannot be displayed and causes an infinite loop. This results in a hung thread. A side effect of this is the amount of memory being consumed continually increases.
Affected users: IBM Daeja ViewONE Virtual users
IO26985 EXCEL WITH MACRO WHEN THERE ARE NON-PRINTABLE OBJECTS MAY CAUSES HUNG THREADS
Loading Microsoft Excel documents with macro in the Viewer may cause hung threads when there are non-printable objects.
Affected users: IBM Daeja ViewONE Virtual users
IO26954 CANNOT PREVENT HEADERS AND PAGE LABELS BEING PRINTED ON PDF DOCUMENTS
When printing a PDF document with no annotations, the header
(Page <N> or <Y>) or the header defined by the HTML parameter
"printHeader" will always appear. Setting the HTML parameter
"allowPrintHeaders" to false has no effect and he header will
still be printed.
Also, when the PDF document with no annotations has page
labels on each page. These labels are defined by the HTML
parameter "pageLabels<N>", where N is the page number to
display the label on, the page labels will always appear on the
printed document. Setting the HTML parameter "printLabels"
to false has no effect and the labels will still be printed.
From this release, these two parameters now correctly disable the headers
and footer labels.
Also resolved the ability to display multi-line labels in the footers.
As a result of this change the font size used to display the headers and footers
has changed slightly.
Affected users: IBM Daeja ViewONE Virtual users
The browser can become unresponsive when thumbnails are displayed
When viewing thumbnails of documents with hundreds of pages the browser can become unresponsive. A performance improvement has been made to avoid processing image filters that are not available within the IE browser.
Affected users: IBM Daeja ViewONE Virtual users on Internet Explorer
IO26840 3200 PAGES PDF TAKES 15 MINUTES TO RENDER WITH IE11
Very large documents take a long time to be displayed in the viewer.
When opening a very long document in the viewer the time between fetching the
document information and displaying the first page is too long.
Page loading has been optimized to reduce display time.
Affected users: IBM Daeja ViewONE Virtual users
IO26850 DIGITAL SIGNATURES MAY NOT APPEAR IN PDF DOCUMENTS
Some PDF documents that contain digital signatures may display without
the digital signture being visible.
NOTE: This issue is resolved using the option to render PDF documents on the client
PC made available since the 5.0.5 release of IBM ViewONE Virtual.
To enable this rendering option use the following HTML parameter "clientPDFTileGeneration".
Affected users: IBM Daeja ViewONE Virtual users
IO26862 USE OF OPENFILE JAVASCRIPT METHOD OPENS DOCUMENT ON INCORRECT PAGE
When client rendering is enabled, using the openFile JS method intermittently opens the incorrect page.
Additional work done to handle openFile JS rendering incorrect page number even without client rending enabled.
Affected users: IBM Daeja ViewONE Virtual users
IO26876 WORD DOCUMENT SHOWING EXTRA HYPHENS AND MISSING LINE
Word document showing extra hyphens and missing line.
Affected users: IBM Daeja ViewONE Virtual users
IO26911 EMAIL MSG FILE FAILS TO RENDER
Opening msg file throws a generic error message on screen stating:
"Unable to display document: Failed to load document, status: An error occurred while retrieving the requested page "
In the server log files, there is not a clear error as such but this message is seen and is indicative of the failure:
"Trying to set page out of range 1/0"
The root cause of the issue is the presence of the ' (single quote character) in the alt attribute in some tags.
Affected users: IBM Daeja ViewONE Virtual users
EXTRA PROTECTION ADDED TO AVOID SERVER OUTAGES FOR MICROSOFT WORD TABLES THAT SPAN MULTIPLE PAGES
Added extra protections for Microsoft Word tables that span multiple pages.
Affected users: IBM Daeja ViewONE Virtual users
IO26959 RESOURCES LEFT OPEN PREVENT JVM SHUTDOWN
ViewOnePlatform shutdown has a ten minute wait for in-use documents to be released.
The more documents in this state the longer the server takes to shutdown.
Failed pool item return corrected and shutdown wait for in use documents has been removed.
Affected users: IBM Daeja ViewONE Virtual users
The Permanent Redaction Java API (also known as the jiBurner API) has been removed. This was deprecated at IBM Daeja ViewONE Virtual Version 5.0.4.
When all the JavaScript Libraries required for ViewONE are finished loading, VIEWONE_JSLIB_LOADCOMPLETE event is thrown.
Customers can listen to this event by adding a listener as below :
window.addEventListener("VIEWONE_JSLIB_LOADCOMPLETE", myViewoneLibraryListener);
where myViewoneLibraryListener would be the implementation of the listener.
Using the event listener will prevent errors caused by calling viewer functionality before the libraries have completed loading.
Page<N> with PDF client rendering has a limit on the number of unique PDF documents that can be referenced.
Each browser has a different limit on the number of unique PDF documents that could be included in Page<N>. Internet Explorer has a limit of 25 PDF documents, while Chrome and FireFox have a limit around 200 PDF documents. Pages that reference PDF documents before hitting the limit are rendered correctly. After the limit is reached, pages that reference PDF documents will not be rendered and will not be displayed in the viewer. The limitation on the number of unique PDF source documents referenced is now lifted.
Affected users: IBM Daeja ViewONE Virtual users
Invert and Visual effects take effect for all instances of the viewer in one window
If you have two (or more) viewers in a web page the Invert and Visual effects alter both instances of the viewer.
Affected users: IBM Daeja ViewONE Virtual users
IO26828 ANNOTATION DATE NOT USING SYSTEM LOCALE OR LANGUAGE AND ALWAYS SHOWS THE MONTH IN ENGLISH
The month for the annotation date does not honor the System locale and always displays in English.
This issue shows in both the Date stamp and the tooltip of newly created annotations.
Affected users: IBM Daeja ViewONE Virtual users
IO26922 WORD DOCUMENT CONTAINING TABLES CALCULATES EXCESSIVE PAGE COUNT AND CAN CAUSE WEB APPLICATION SERVER OUTAGE
A Word document is seen to have a page count of thousands of pages
(where original has less than 1000 pages) and the following message
is seen repeated through the server-side Virtual log file
viewone.tile> 1 ji.filter.office.jiOfficeDecoder$DocOpener
splitpool-5
viewone.tile> 1 ji.filter.office.jiOfficeDecoder$DocOpener
splitpool-5
.
Affected users: IBM Daeja ViewONE Virtual users
Users can now have more control over the north toolbar. The following new HTML parameters enables users to be able to individually disable specific Document Builder buttons:
The new HTML parameter docBuilderButtons can be used to determine whether the toolbar includes Document Builder buttons or not when the edit mode is set to 'docbuilder'. When set to false the viewer will hide the Document Builder buttons. By default it is set to true.
IO26641 ANNOTATION TEXT IS DUPLICATED ACROSS VIEWERS WHEN ANNOTATION IS BEING EDITED AND NOT SAVED
When there are multiple viewers open on a page and text annotations are active in more than one viewer, the text input into one annotation will appear in the active text annotations on the other viewers.
Affected users: IBM Daeja ViewONE Virtual users
Large EMF files, with a high color depth, that are embedded within Office documents may cause an OutOfMemoryException
Large EMF files, with a high color depth, that are embedded within Office documents may cause an OutOfMemoryException. To prevent this the amount of memory an image is permitted to use is restricted to 50Mb. Images that require a larger amount of memory to render will not be displayed.
Affected users: IBM Daeja ViewONE Virtual users
IO26825 JAVASCRIPT FUNCTIONS CHANGING BUTTON STATE ARE BEING THROWN AWAY WHEN OPEN FILE IS BEING USED
The state of the buttons changed using Javascript APIs are not retained when Javascript 'openFile()' API is used.
Affected users: IBM Daeja ViewONE Virtual users
IO26862 USE OF OPENFILE JAVASCRIPT METHOD OPENS DOCUMENT ON INCORRECT PAGE
When client rendering is enabled, using the openFile JS method intermittently opens the incorrect page.
Affected users: IBM Daeja ViewONE Virtual users
IO26887 PDF FAILS WITH A PRINT ABORTED
A PDF document that has edit security protection set, fails to print with Print Aborted.
Affected users: IBM Daeja ViewONE Virtual users
IMPROVE LOGGING WHEN LOADING INVALID FONTS
When an attempt is made to load an invalid font, a NullPointerException
can be output to the log file.
The reason why a font file cannot be loaded is also not obvious from the
logs.
Affected users: IBM Daeja ViewONE Virtual users
This javascript method will allow users to activate an annotation type to be used. The type of annotation is determined
by the 'type' parameter. The following values can be used for the 'type' parameter:
The text search functionality for PDF documents has been enabled for the Virtual viewer integrated within IBM Content Navigator
A javaScript API has been added to get annotations from the viewer based upon their status.
getAnnotations(String json) - gets the annotations based on the status specified in the 'json' string provided. If the json entry is empty or null, all annotations present in the document will be returned. Deleted annotations will not be included
The Json format is as follows:
{"status":"
'all' - gets all annotations currently present in the document. Deleted annotations will not be included
'new' - gets any annotations that have been newly added to the document since a save/load of annotations last occurred.
'modified' - gets any annotations that have been modified in the document since a save/load of annotations last occurred.
'deleted' - gets any annotations that have deleted in the document since a save/load of annotations last occurred.
'unchanged' - gets all annotations that are not new, modified, or deleted.
Should status be null or empty, this method will return all annotations currently present in the document. Deleted annotations will not be included.
Should status be an invalid entry, an exception will be logged (if the traceException parameter is set to true) and this method will return undefined.
Letter 'v' cannot be typed into an active text annotation
The letter 'v' cannot be typed directly into an active text annotation.
Affected users: IBM Daeja 5.0.5 iFix004 ViewONE Virtual users
Read-access password-proctected PDFs produce a corrupted output when redacting.
When a redaction is done on a password protected PDF document, a corrupted output is returned. This is because we do not support printing, redacting, and document building when the document is password protected. These operations now produce an error dialog informing that the action is unavailable for password-protected documents. When these operations are started via the ViewONE JavaScript API, and the integrator is handling event 80 (task status event), the event will return a status of 'error'. The viewer does not display the error dialog and it is up to the integrator to handle the error.
Affected users: IBM Daeja ViewONE Virtual users
DocBuilder process on the server continues after a cancel received from the client
When a DocBuilder process has been started the process would continue to run until completion, even after the user had cancelled the request. This has been modified so that the process will now terminate early when a cancel notification has been given.
Affected users: IBM Daeja ViewONE Virtual users
DocBuilder, Print and Redaction dialogs continue to make server requests after user cancel
When a DocBuilder, print or redaction dialog is cancelled on the client the background process would continue to poll the server for a status updates. The polling will now cease on the next scheduled server request.
Affected users: IBM Daeja ViewONE Virtual users
IO26874 PDF TO PDF REDACTION USING SPECIFIC PDF CAN CAUSE THE REDACTION TO MOVE AND CHANGE SHAPE
When performing PDF to PDF redaction on documents that contain page rotations of 360 degree and above, the redaction may change shape and move position in the document.
Affected users: IBM Daeja ViewONE Virtual users
IO26408 EMAILS WITH '&' CHARACTERS IN THE BODY TEXT FAIL TO DISPLAY WITH ERROR MESSAGE, INCORRECT PAGE COUNT
Email with '&' characters in the body text fail to display with error message, Incorrect page count. Additional secondary issue with the message in the server standard output 'The entity name must immediately follow the '&' in the entity reference'.
Affected users: IBM Daeja ViewONE Virtual users
IO26560 MSG FILE WITH TABLES IS NOT SHOWING FULL MESSAGE
Message file with tables is not displaying full message.
Affected users: IBM Daeja ViewONE Virtual users
IO26625 NUMBERING OF STICKY NOTE ARE NOT MATCHED ON PRINT OUT(SUMMARYPAGE)
When a document with one or more stickynotes is printed, the Summary page note numbers does not match with the numbers on printout and the client.
Affected users: IBM Daeja ViewONE Virtual users
IO26659 EMAIL MISSING BODY WHEN RENDERED
Email missing body when rendered.
Affected users: IBM Daeja ViewONE Virtual users
IO26744 CANNOT VIEW FIRST PAGE OF WORD DOCUMENT
A two page word document with embedded images fails to renderfirst page of document
Affected users: IBM Daeja ViewONE Virtual users
IO26818 IN INTERNET EXPLORER PDF-A PDF DOCUMENTS DON'T GET THE PRINTER PROMPT
When printing PDF-A Compliant PDF documents that contain no annotations and "Print Original Size" is selected in Internet Explorer. Once the file preparation step has complete the print process would stop. Normally the prinatble PDF would be downloaded and a print prompt would pop up. In this case nothing happens after file preparation.
Affected users: IBM Daeja ViewONE Virtual users
IO26838 VIEWING SOME RTF FILES FAIL WITH AN ERROR MENTIONING THE UNIVERSAL VIEWING MODULE
Complex RTF files that have been created by applications other than Wordpad cannot be displayed. The error message that is then displayed can be confusing as it states "Unrecognized file type Universal Viewing."
Affected users: IBM Daeja ViewONE Virtual users
IO26863 ACTIVE ANNOTATIONS APPEAR IN WRONG PLACE AFTER VIEWER RESIZE
Active annotations appear in the wrong place after
the height of the Viewer has been increased.
This can be seen when the annotation context toolbar
appears in a different place to the display of the active
annotation and when the annotation is de-activated it
appears to move.
Affected users: IBM Daeja ViewONE Virtual users
Magnifier button does not get undepressed correctly
Once the magnifier is selected, the magnifier button does not get un-depressed if you turn off magnifier.
Affected users: IBM Daeja ViewONE Virtual users
Performance regression when redacting to a TIFF document
Redacting documents with the output being TIFF were taking longer to complete.
Affected users: IBM Daeja ViewONE Virtual users
Print dialog selecting wrong option by default after printing
After printing a document, and choosing to print again the dialog would not select the correct print option and would retain your previous selection regardless of what print shortcut you entered.
Affected users: IBM Daeja ViewONE Virtual users
Print range incorrect when changing between options in the print dialog in a single page document
Upon opening a single page document and opening the print dialog, changing between options and then selecting 'All' the page range will display 1 - 1
Affected users: IBM Daeja ViewONE Virtual users
When the option to render PDF documents on the client is enabled, the ability to invert the colors of pages in the viewer is now supported. The state of the invert is retained when changing the edit modes. For more information on client rendering of PDF documents see : https://www-01.ibm.com/support/docview.wss?uid=ibm10741595.
Limitations: This feature is unavailable in browsers that do not support image filters.
Internet Explorer from version 9 through version 11 has no support for image filters.
This feature adds the ability to search PDF document text and display the search results visually. Search is only available when the PDF document is rendered on the client. The search feature is not available in PageN, Document Builder mode, or when viewed in Internet Explorer and Edge. Limitations: If a word is split across different span elements then it is not regarded as a single word, and will not be in the search result. Similarly, searching for a sentence that is split across multiple span elements will also return no results. For more information on client rendering of PDF documents see : https://www-01.ibm.com/support/docview.wss?uid=ibm10741595
When user double right click on text annotation the text edit dailog comes up allowing the user to copy the text. Pressing a CTRL+V on a active text annotation allows the text edit dialog to come up and also pastes the content that is copied.
When annotation sticky mode is enabled (via right-clicking an annotation in the annotation toolbar), this sticky mode is now persisted across pages in a document. The sticky mode is not persisted when a new document is opened.
When the option to render PDF documents on the client is enabled, electronic signatures included in PDFs are now displayed. For more information on client rendering of PDF documents see : https://www-01.ibm.com/support/docview.wss?uid=ibm10741595
IO26827 Save local file fails when URLRemapping is configured
When the internalHost/externalHost parameters are configured the save to local file does not retrieve the document.
Affected users: IBM Daeja ViewONE Virtual users
IO26745 VIEWING EML FILE CAUSES EXCEPTION STRING INDEX OUT OF RANGE: 0
Specific EML file does not render and throws following excpetion in logs
String index out of range: 0
java.lang.StringIndexOutOfBoundsException: String index out of range: 0
at java.lang.String.codePointAt(Unknown Source)
at com.ibm.dv.util.CharsetConverterStream.fillOutputBuffer(Unknown Source)
at com.ibm.dv.util.CharsetConverterStream.read(Unknown Source)
at java.io.InputStream.read(Unknown Source)
at java.io.InputStream.read(Unknown Source)
at ji.daeja.viewone.ui.scanner.SimpleStringLocationScanner.scan(Unknown Source)
at com.ibm.dv.email.EmailToHTML.scanHTML(Unknown Source)
at com.ibm.dv.email.EmailToHTML.getHTMLStream(UnknownSource)
Affected users: IBM Daeja ViewONE Virtual users
IO26806 PDF DIGITAL SIGNATURE DOES NOT DISPLAY IN PDF DOCUMENT
Some PDF documents that contain digital signatures, with an image of a written signature, may fail to display the signature image if their color index table has an incorrect length.
Affected users: IBM Daeja ViewONE Virtual users
IO26824 PowerPoint document renders with missing slide
When opening a PowerPoint document a slide is not rendered and a large amount of memory is consumed on the server.
Affected users: IBM Daeja ViewONE Virtual users
filenetZOrderEnabled
parameter in ViewONE Virtual
When saving and loading annotations with a P8 Content Engine back end via ViewONE Virtual
the layering of the annotations in the user interface is maintained.
Existing annotations are ordered in the interface from the item with the lowest F_ORDINAL
value to the highest, with the highest value overlaying the other annotations.
After changing document, the page selection will be set to 'All Pages'. The viewer no longer stores previous selections from prior documents.
When the users move from one page to another within the viewer, the magnifier preferences such as the magnification factor, magnification size, and the location of the magnifier will be retained across all the pages within a document.
Note:
Password-protected PDF documents can be opened and viewed when the viewer is configured to render PDF documents on the client: A dialog prompt will appear allowing for the password to be inputed. To enable client rendering of PDF documents, set the clientPDFTileGeneration HTML parameter to true. The viewing of password-protected PDF documents is not supported in PageN mode. A password dialog prompt is open for each page that uses a password protected PDF. If there is more than one page that uses a password-protected PDF document, there is no way to determine which document's password the viewer is asking for. The printing, redacting, and document-building of password-protected PDF documents are not supported.
PRINTING PDF DOCUMENTS WITH ROLE BASED REDACTION ENABLED MAY TAKE LONGER TO PRINT
Printing a PDF document with role base redaction enabled may take longer to print. This was due to burning PDF to PDF being set as default for all cases. This is now only set when printing a PDF document with role based redaction turned on with no other non RBR annotations present, and if the "Print Original Size" option is selected in the print dialog.
Affected users: IBM Daeja ViewONE Virtual users
A new attribute 'autoload' on ViewONE Virtual object definition
When the viewone.js script has loaded in the browser it automatically scans the page content
and initialises any viewer objects. This new attribute can be used to prevent this operation.
This attribute is only necessary when the viewer is being dynamically added via JavaScript and prevents
the viewone.js script from scanning the object definition. In some circumstances the object scanning can occur
before the object configuration is completed, resulting in an incorrectly configured or unusable viewer object.
To prevent automatic loading of the viewer set the viewer object attribute autoload="false"
.
Affected users: IBM Daeja ViewONE Virtual users
IO26616 SOME PDF DOCUMENTS WITH LARGE HIDDEN TEXTUAL CONTENT MAY BE SLOW TO DISPLAY.
Some PDF documents that have a large amount of textual data that
is hidden from view may take a long time to display.
NOTE: This issue is resolved using the option to render PDF documents
on the client PC made available since the 5.0.5 release of IBM ViewONE Virtual.
To enable this rendering option use the following HTML parameter "clientPDFTileGeneration".
Affected users: IBM Daeja ViewONE Virtual users
IO26627 STICKY NOTE NUMBERING INCREASING INCREMENTALLY WHEN USING JAVASCRIPT TO OPEN NEXT DOCUMENT
When adding new sticky note annotations, switching to next document using Javascript, the note number increases from the note number of the previous document.
Affected users: IBM Daeja ViewONE Virtual users
IO26650 ENCRYPTED PDF DOES NOT RENDER WHEN BOUNCYCASTLE JAR IN CLASSPATH
When there are conflicting versions of the Bouncy Castle Crypto API jar files
on the classpath, encrypted PDF files that do not contain
a password for reading fail to load.
The following exception will be seen in the standard error (stderr) log for the
Web Application Server:
java.lang.ClassCastException: org.bouncycastle.jcajce.provider.symmetric.IDEA$Mappings
incompatible with org.bouncycastle.jcajce.provider.util.AlgorithmProvider.
The IBM Daeja ViewONE log file will contain the following text:
This PDF file is encrypted and JPedal needs an additional library to
- decode on the classpath (we recommend bouncycastle library).
Affected users: IBM Daeja ViewONE Virtual users
IO26665 SOME PDF DOCUMENTS CONTAINING EMBEDDED IMAGES DISPLAY AS BLANK
Some PDF documents that contain embedded color images may display as
blank pages.
NOTE: This issue is resolved using the option to render PDF documents
on the client PC made available since the 5.0.5 release of IBM ViewONE Virtual.
To enable this rendering option use the following HTML parameter "clientPDFTileGeneration".
Affected users: IBM Daeja ViewONE Virtual users
IO26714 PDF DOCUMENTS CONTAINING HEBREW CHARACTERS DISPLAY WITH INVALID CHARACTERS
Some PDF documents are displayed in the viewer with no errors in logging however Hebrew characters are displayed as non-ANSII, non-Hebrew characters so the text is illegible.
Affected users: IBM Daeja ViewONE Virtual users
IO26739 EML DOCUMENTS WITH CUSTOM HEADERS CONTAINING MORE THAN 1048 BYTES DO NOT RENDER
An EML document does not display and the logging, with traceFilter=true
, shows
jiFilterEML: N/A: n/a: Filter not valid for this file type
and,
Exception: Format Exception: Unrecognized file type: N/A
When viewed in a text editor the affected document will have at least one header with over 128 characters on a single line.
Long headers will be now be truncated at 1000 characters and not fail to load.
Affected users: IBM Daeja ViewONE Virtual users viewing internet email (EML) documents
IO26764 The Best-Fit button is doing a Fit-To-Width function for landscape documents in Virtual viewer.
When viewing a landscape document, the best fit button can mis-calculate, and set to fit-to-width when fit-to-height would be the best fit. This can also apply to portrait documents where fit-to-height is used erroneously.
Affected users: IBM Daeja ViewONE Virtual users
THE PAGE INDICATOR SHOWS THE INCORRECT PAGE NUMBER AFTER SWITCHING TO THUMBS ONLY VIEW
The page indicator in the toolbar which shows the current page out of the total number of pages in the document, can show the wrong page number after switching to the thumbs only view.
Affected users: IBM Daeja ViewONE Virtual users
NEW ANNOTATIONS NOT VISIBLE ON THUMBNAILS
When viewing a PageN document, newly drawn annotations are not visible on the thumbnails.
Affected users: IBM Daeja ViewONE Virtual users
IO25864 INITIAL GRAY CIRCLE IN THE MAGNIFIER STAYS INSTEAD OF SHOWING THE DETAILS OF THE PAGE
When using Magnifier functionality, the gray circle which comes up as part of the initialization stays instead of showing the details of the page being magnified.
Affected users: IBM Daeja ViewONE Virtual users
IO26372 ON BUILDING A DOCUMENT THE WEIGHT OF THE ANNOTATIONS CHANGES
On building a document the weight of annotation changes and is presented as thicker annotation borders and larger arrow heads which may cover adjacent text that was not covered on the original source document
Affected users: IBM Daeja ViewONE Virtual users
IO26579 THE MAGNIFIER DOESN'T SCALE ACCORDING TO FIT-TO-WIDTH, FIT-TO-HEIGHT, OR BEST-FIT CHANGE
The Magnifier doesn't scale accordingly when switching between fit-to-height, fit-to-width or best-fit. The magnifier would retain its previous setting. As a result the magnifier would show what it seems a different part of the document which the magnifier is not directly over.
Affected users: IBM Daeja ViewONE Virtual users
IO26604 POWERPOINT DOCUMENT CONTAINING INVISIBLE TABLE RENDERS WITH BORDERS IN THE TABLE
No error is shown on screen or in log files but elements with invisible borders are shown with visible borders - not seen when viewed in native Powerpoint application.
Affected users: IBM Daeja ViewONE Virtual users
IO26628 STICKY NOTE COLOR CONTEXT BUTTON NOT REMOVED WHEN USING AN IMAGE SERVICES BACKEND
When selecting a sticky note annotation, a context toolbar is shown to allow alteration of fonts, borders and colors. Sticky note color modification is not supported with an Image Servies(IS) backend so the context button should be removed.
Affected users: IBM Daeja ViewONE Virtual users
IO26648 MOVE BEHIND ANNOTATION CONTEXT BUTTON DOES NOT WORK
When there are overlapping annotations in the document, clicking the move behind annotation context button, in the Annotation editor tool bar, has no effect.
Affected users: IBM Daeja ViewONE Virtual users
IO26707 SPECIFIC EMAIL DOCUMENT RENDERS AS GREY SCREEN AND CAN CAUSE A SERVER OUTAGE DUE TO AN INFINITE LOOP
No error is shown in the virtual log file as the process gets stuck in an infinite loop
A thread dump from the web application server at the point the server is not responding will
show the following:
java.lang.Thread.State: RUNNABLE
at com.sanatech.ooxml.layoutengine.ParagraphProcessor.getAllTabStops(Unknown Source)
at com.sanatech.ooxml.layoutengine.ParagraphProcessor.process(Unknown Source)
at com.sanatech.ooxml.layoutengine.StroyProcessor.doProcess(UnknownSource)
at com.sanatech.ooxml.layoutengine.StroyProcessor.process(UnknownSource)
at com.sanatech.ooxml.layoutengine.table.TableCellProcessor.process(Unknown Source)
at com.sanatech.ooxml.layoutengine.table.TableProcessor.process(Unknown Source).
Affected users: IBM Daeja ViewONE Virtual users
IO26713 CHROME BROWSER RELEASE 71 AND LATER CRASHES ON ANY VIEWER ACTION AFTER THE VIEWER HAS LOADED
After the viewer has loaded, any viewer actions that requires painting the page image will crash the Chrome browser. This occurs on Chrome browser release 71 and later.
Affected users: IBM Daeja ViewONE Virtual users using Chrome browser release 71 and later
PDF documents that contain very large image masks are slow to display
Some PDF documents that contain very large invalid stencil image masks are slow to display.
The delay in displaying is due to the mask (invalid) being applied to every pixel reulting in no
change to the original image, for large images the processing may be performed on tens of millions
of pixels when it is not needed.
NOTE - Change in behaviour. Careful consideration is required before enabling this parameter.
This fix is now only enabled when the following parameter is set:
ignoreClearPdfMasks = true
If this parameter is set, then some PDF documents with transparent masks may display with missing content.
Affected users: IBM Daeja ViewONE Virtual users
MERGE AND SPLIT DOCUMENT BUILDING FAILS FROM EMPTY VIEWER
With the parameter 'clientPDFTileGeneration' set to true, docbuilding fails when building a document from an empty viewer.
Affected users: IBM Daeja ViewONE Virtual users
IO26709 SOME PDF DOCUMENTS WITH FULLY TRANSPARENT IMAGE MASKS DISPLAYED AS SOLID IMAGES
Some PDF documents that contain fully transparent image masks on top of other content, may display as solid images resulting in missing document content.
Affected users: IBM Daeja ViewONE Virtual users
IO26660 WHEN OPENING A NEW DOCUMENT IN THE SAME INSTANCE OF THE VIEWER THE FIT TO MODE IS NOT MAINTAINED BETWEEN DOCUMENTS IF KEEP SCROLL IS ON
When KeepScroll is turned on, opening a new document of different page orientations causes the Scale (including FITTOWIDTH, FITTOHEIGHT, and BEST_FIT) to be miscalculated.
Affected users: IBM Daeja ViewONE Virtual users
IO26638 SOME SPECIAL CHARACTERS IN STICKY NOTE ANNOTATIONS PRINTS INCORRECTLY
Some special characters like '<', '>', '&', and ' ' (new line) in sticky note annotations are character encoded in the print summary page.
Affected users: IBM Daeja ViewONE Virtual users
IO26639 PAGES IN SOME PDF DOCUMENTS APPEAR BLACK WITH COLORS INVERTED
Pages in some PDF documents appear black with colours inverted.
Affected users: IBM Daeja ViewONE Virtual users
IO26670 SOME PDF DOCUMENTS ONLY DISPLAY THE FIRST PAGE
In some PDF documents only the first page is displayed, subsequent pages only display with random characters.
Affected users: IBM Daeja ViewONE Virtual users
This feature provides the ability to control the brightness, illumination and contrast of the selected page for better readability.
This feature can be invoked through a button from the toolbar. This button will be visible by default, and can be hidden by setting the parameter 'visualEffectButton' to 'false'.
These settings can also be controlled by the following Javascript API methods:
Methods to return the brightness, contrast or luminance value of the selected page.
getBrightness()
getContrast()
getLuminance()
Methods to set the brightness, contrast or luminance value of the selected page.
Valid values for setting brightness, contrast and luminance must be in the range '0' to '255'.
setBrightness(String value)
setContrast(String value)
setLuminance(String value)
Methods to reset the brightness, contrast or luminance of the selected page to the default value of '100'.
resetContrast()
resetBrightness()
resetLuminance()
Limitations: This feature is unavailable in browsers that do not support image filters.
Internet Explorer from version 9 through version 11 has no support for image filters.
The viewer honors the Orientation tag set in a TIFF document and applies the designated rotation when rendering the image on screen. When annotations are added and saved on such a document, they maintain their positions and rotations relative to the rotated document.
Added HTML parameter, prefetchSize. This parameter can be used to reduce the number of pages that will be retrieved in the background.
The actual number of pages retrieved is calculated based on the zoom level.
See https://www-01.ibm.com/support/docview.wss?uid=ibm10737269 for more details.
The valid values for this parameter are the numbers zero (0) to seven (7), where a value of 0 means no pages are retrieved in the background. The default is 7.
This parameter has no effect when the HTML parameter clientPDFTileGeneration is set to true and the document being displayed is a PDF.
The document tile size is now configurable via the parameters tileXSize
and tileYSize
.
The default main document display is composed of image tiles that are up to 256 by 256 pixels.
Using the tileXSize
and tileYSize
, this is now configurable from a minimum of 100 to an unlimited size.
Where no value is given the default value of 256 is used.
Where the maximum size is larger than the amount of pixels represented by the page, the page width at the current
zoom level in pixels is used.
For example, if tileXSize and tileYSize are both set to 9000, but the page is represented by 100x100 pixels,
the requested tile will only be 100x100 pixels.
NOTE This parameter has no effect when the HTML parameter clientPDFTileGeneration is set to true.
In IBM Daeja ViewONE Virtual, the default main document display is composed of image tiles. Documents are rendered on the server and image tiles are generated for each page. The Viewer fetches these images from the server across the network which could produce many network requests. The page displaying speed is bounded by the performance of the network between the client and server, and the available resources on the server. A new option is now available which enables rendering PDF documents and generating the image tiles directly on the client inside the browser. The PDF document is cached on the ViewONE server and then the entire document is delivered to the client where the individual pages are rendered on demand. Moving the rendering process to the client provides a number of advantages:
Differences with server side rendering:
Limitations:
Enabling client rendering of PDF documents: There is a new clientPDFTileGeneration HTML parameter to render PDF documents on the client. Setting this to 'true' will render the document on the client. The default is false. When the clientPDFTileGeneration parameter is enabled, the following APARs are resolved when viewing the documents:
Improved the rendering of some PDF documents that contain text that is drawn in a certain way that may result in failure to render with a NullPointerException output in the log.
Print performance has been greatly improved for PDF documents, when the following criteria are met;
* The document to be printed is a PDF document
* No annotations have been applied to the document OR
* The annotations are hidden using the annotation show/hide button
* "Print Original Size" is selected
When printing a PDF document with no or hidden annotations, "Print Original Size" is selected as default.
NOTE: Print output for the above criteria may have slight visual differences to the document displayed in the viewer.
The Annotation sticky mode allows the application of a selected annotation multiple times,
without the need to click on the annotation button again.
Sticky annotation mode is enabled either by the annotationsSticky
HTML parameter, or
when the user right-clicks on an annotation button. The sticky mode will remain active,
even after a page change, until the user deactivates it by clicking on the active annotation button.
A new option is now available to exit the sticky mode.
During the process of adding multiple annotations of the same kind a user can now end the sticky mode by
right-clicking on any existing annotation. This will end the sticky mode, select the clicked annotation, and
activate the edit tools for that annotation.
Documents that are opened at a specific page number are now scrolled in to the view at their correct scroll location. This means that when in fit to width/height view mode, the page will be scrolled to be at the top of the view.
The number of calculations taking place as we scroll a document has been decreased, allowing for a smoother scroll experience. This is most noticeable when scrolling the scroll bar via click-drag.
When using a large amount of documents for PageN, performance has been improved significantly on inital load and page to page navigation.
The number of requests being made as a document is scrolled has been reduced, resulting in an improvement in rendering time once scrolling is stopped.
Event 34, Page Rendered, fires each time a page is retrieved, this can be when a page is displayed
or when a page that has been pre-fetched. This prevents
a user from knowing whether a page they have just changed to, has been displayed or not.
EVENT 9 now contains a JSON payload that contains the page number of the page changed to as well as a flag,
that indicates whether the page has already been retrieved and is available in the DOM. If this flag is true
then the user knows this page has been retrieved and displayed, if the flag is false the user will have to
wait for event 34 to know when the page is displayed.
The JSON payload, contained within event 9, takes the form of the following example:
{"page":10, "isPageInDOM":true}
Parameter support has been added to pick and choose what keyboard shortcuts will be enabled in the viewer. These parameters also allow the disabling of keyboard shortcuts altogether. Setting the parameters allKeys, printKeys, fileKeys or viewKeys to false will disable those categories of shortcuts in the viewer.
When many trace parameters are enabled, the server slows down and may become unusable. A performance improvement has been made that reduces the time taken to log messages when the system is heavily loaded.
Performance decreases and the viewer potentially hangs when scrolling through pages of large documents in Document Builder mode.
When using keyboard shortcuts event 37 was not fired. With this fix users will be able to track shortcut keypresses via the javascript bridge output. This feature allows users to track and extract data from use of the system regarding keypresses. Users can track when keyboard shortcuts are activated and how frequently they are activated. An example of usage could be an office wanting to track usage of the print shortcut to be audited and reported on. This event output will allow users to dynamically configure the viewer to operate under a set of key presses.
There is missing functionality with shortcuts to navigate around on a zoomed page.
This functionality was missing because the viewer does not use scrollbars
for each part of the page unless you are zoomed in to an extent that the browser
generates them for the user. The missing shortcuts were
to navigate to the top, bottom, left, right and middle of a page either vertically or
horizontally. Below are the newly added keyboard shortcuts:
Go to top of current page: CTRL + HOME
Go to end of current page: CTRL + END
Go to far left of current page: SHIFT + HOME
Go to far right of current page: SHIFT + END
Go to vertical center of current page: CTRL + SHIFT + HOME
Go to horizontal center of current page: CTRL + SHIFT + END
It is now possible to print a range of pages using a keyboard shortcut. Press 'CTRL+P' to open the Print Dialog with the Print Range Option selected.
New API call, setPageSelection allows for the ability to select multiple pages via JavaScript Call.
setPageSelection(activePage, pageSelection)
will select the pages specified by pageSelection
and will set the active page to activePage
.
pageSelection
is a JSON input in the form;
{"selectedPages":[1,3,5,10]}
For example;
setPageSelection(3,{"selectedPages":[1,3,5,10]})
will result in pages 1,3,5 and 10 being selected with page 3 being the active page.
If setPageSelection(3,{"selectedPages":[1,3,"5-10"]})
is called then;
pages 1,3,5,6,7,8,9 and 10 would be selected with page 3 being the active page.
New API call that allows multipage deletions in one operation.
deleteDocumentPages(firstPageToBeDeleted, lastPageToBeDeleted)
will delete the pages between and including, those specified by firstPageToBeDeleted
lastPageToBeDeleted
.
The page selection updated event (87) fires when the selection stops being edited.
It contains a JSON payload listing the pages
currently selected and whether the pipe is selected. If the pipe is true then any
insertions will occur prior to the page number of the selection.
For example, if pages 1,3 and 10 are selected in the viewer, event 87 would contain the following JSON;
{"selectedPages":[{"page":{"pageNumber":1, "pipe":false}},{"page":{"pageNumber":3, "pipe":false}},{"page":{"pageNumber":10, "pipe":false}}]}
If the pipe before page 1 is selected in the viewer, the event payload would be:
{"selectedPages":[{"page":{"pageNumber":1, "pipe":true}}]}
If a page was added with this selection, the new page would be number 1, if the pipe was false, it would be page number 2.
Extra page selection updated events are fired when in Document Builder mode.
At high zoom levels, the performance when scrolling through a document is slow and memory usage increases noticeably.
Performance optimizations have been applied to resolve the above.
The size of the Linux specific resource jar, jiserver-resource-linux.jar, has reduced by approximately 50MB.
Published Technote: http://www.ibm.com/support/docview.wss?uid=ibm10733815
Resolved in release: IBM Daeja ViewONE Virtual 5.0.4 iFix 6, all future iFixes on 5.0.4 and IBM Daeja ViewONE Virtual 5.0.5
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.5 as a component inside IBM Content Navigator, the minimum supported version of ICN is 3.0.5, unless stated otherwise by the specific ICN release.
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: